diff --git a/docs/1.0/404.html b/docs/1.0/404.html
index a8364fb..68dbbbb 100644
--- a/docs/1.0/404.html
+++ b/docs/1.0/404.html
@@ -18,16 +18,16 @@
   <title>404 Page not found</title>
   
    
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/horsey.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/horsey.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 <style type="text/css">
     :root #header + #content > #left > #rlblock_left {
diff --git a/docs/1.0/admin-guide/amqp-adapter-config/index.html b/docs/1.0/admin-guide/amqp-adapter-config/index.html
index 3cb2b67..2a46863 100644
--- a/docs/1.0/admin-guide/amqp-adapter-config/index.html
+++ b/docs/1.0/admin-guide/amqp-adapter-config/index.html
@@ -21,19 +21,19 @@
     <title>AMQP Adapter Configuration :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/amqp-adapter-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/amqp-adapter-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/amqp-adapter-config/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/amqp-adapter-config/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/amqp-adapter-config/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/amqp-adapter-config/">dev</option>
@@ -2611,20 +2637,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/admin-guide/amqp-network-config/index.html b/docs/1.0/admin-guide/amqp-network-config/index.html
index 864914d..4275c6d 100644
--- a/docs/1.0/admin-guide/amqp-network-config/index.html
+++ b/docs/1.0/admin-guide/amqp-network-config/index.html
@@ -21,19 +21,19 @@
     <title>AMQP 1.0 Messaging Network Configuration :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/amqp-network-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/amqp-network-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/amqp-network-config/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/amqp-network-config/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/amqp-network-config/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/amqp-network-config/">dev</option>
@@ -2286,20 +2312,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/admin-guide/auth-server-config/index.html b/docs/1.0/admin-guide/auth-server-config/index.html
index 5fb5e6a..f4b7446 100644
--- a/docs/1.0/admin-guide/auth-server-config/index.html
+++ b/docs/1.0/admin-guide/auth-server-config/index.html
@@ -21,19 +21,19 @@
     <title>Auth Server Configuration :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/auth-server-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/auth-server-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/auth-server-config/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/auth-server-config/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/auth-server-config/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/auth-server-config/">dev</option>
@@ -2492,20 +2518,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/admin-guide/common-config/index.html b/docs/1.0/admin-guide/common-config/index.html
index 09f6c7a..d0d1a6d 100644
--- a/docs/1.0/admin-guide/common-config/index.html
+++ b/docs/1.0/admin-guide/common-config/index.html
@@ -21,19 +21,19 @@
     <title>Common Configuration :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/common-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/common-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/common-config/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/common-config/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/common-config/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/common-config/">dev</option>
@@ -2357,20 +2383,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/admin-guide/device-connection-config/index.html b/docs/1.0/admin-guide/device-connection-config/index.html
index 3ea96f9..1683dd6 100644
--- a/docs/1.0/admin-guide/device-connection-config/index.html
+++ b/docs/1.0/admin-guide/device-connection-config/index.html
@@ -21,19 +21,19 @@
     <title>Configuring the Device Connection Service :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/device-connection-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/device-connection-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/device-connection-config/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/device-connection-config/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/device-connection-config/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/device-connection-config/">dev</option>
@@ -2544,20 +2570,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/admin-guide/device-registry-config/index.html b/docs/1.0/admin-guide/device-registry-config/index.html
index 7e1b38f..909a990 100644
--- a/docs/1.0/admin-guide/device-registry-config/index.html
+++ b/docs/1.0/admin-guide/device-registry-config/index.html
@@ -21,19 +21,19 @@
     <title>Device Registry Configuration :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1199,9 +1199,11 @@
               
               
                   
+              
+                  
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/device-registry-config/">stable (1.2)</option>
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/device-registry-config/">1.2</option>
                     
                   
               
@@ -1217,6 +1219,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/device-registry-config/">1.1</option>
@@ -1235,6 +1239,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/device-registry-config/" selected>1.0</option>
@@ -2727,20 +2733,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/admin-guide/hono-client-configuration/index.html b/docs/1.0/admin-guide/hono-client-configuration/index.html
index 2b2f8a7..c466052 100644
--- a/docs/1.0/admin-guide/hono-client-configuration/index.html
+++ b/docs/1.0/admin-guide/hono-client-configuration/index.html
@@ -21,19 +21,19 @@
     <title>Hono Client Configuration :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/hono-client-configuration/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/hono-client-configuration/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/hono-client-configuration/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/hono-client-configuration/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/hono-client-configuration/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/hono-client-configuration/">dev</option>
@@ -2547,20 +2573,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/admin-guide/http-adapter-config/index.html b/docs/1.0/admin-guide/http-adapter-config/index.html
index bdb48ed..8872640 100644
--- a/docs/1.0/admin-guide/http-adapter-config/index.html
+++ b/docs/1.0/admin-guide/http-adapter-config/index.html
@@ -21,19 +21,19 @@
     <title>HTTP Adapter Configuration :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/http-adapter-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/http-adapter-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/http-adapter-config/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/http-adapter-config/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/http-adapter-config/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/http-adapter-config/">dev</option>
@@ -2590,20 +2616,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/admin-guide/index.html b/docs/1.0/admin-guide/index.html
index 307e662..c5779e8 100644
--- a/docs/1.0/admin-guide/index.html
+++ b/docs/1.0/admin-guide/index.html
@@ -21,19 +21,19 @@
     <title>Admin Guide :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/">dev</option>
@@ -2251,20 +2277,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/admin-guide/kura-adapter-config/index.html b/docs/1.0/admin-guide/kura-adapter-config/index.html
index e314970..a82b034 100644
--- a/docs/1.0/admin-guide/kura-adapter-config/index.html
+++ b/docs/1.0/admin-guide/kura-adapter-config/index.html
@@ -21,19 +21,19 @@
     <title>Kura Adapter Configuration :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/kura-adapter-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/kura-adapter-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/kura-adapter-config/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/kura-adapter-config/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/kura-adapter-config/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/kura-adapter-config/">dev</option>
@@ -2604,20 +2630,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/admin-guide/monitoring-tracing-config/index.html b/docs/1.0/admin-guide/monitoring-tracing-config/index.html
index b26dbff..d8433ec 100644
--- a/docs/1.0/admin-guide/monitoring-tracing-config/index.html
+++ b/docs/1.0/admin-guide/monitoring-tracing-config/index.html
@@ -21,19 +21,19 @@
     <title>Monitoring & Tracing :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/monitoring-tracing-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/monitoring-tracing-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/monitoring-tracing-config/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/monitoring-tracing-config/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/monitoring-tracing-config/">dev</option>
@@ -2480,20 +2506,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/admin-guide/mqtt-adapter-config/index.html b/docs/1.0/admin-guide/mqtt-adapter-config/index.html
index 770a502..3844196 100644
--- a/docs/1.0/admin-guide/mqtt-adapter-config/index.html
+++ b/docs/1.0/admin-guide/mqtt-adapter-config/index.html
@@ -21,19 +21,19 @@
     <title>MQTT Adapter Configuration :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/mqtt-adapter-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/mqtt-adapter-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/mqtt-adapter-config/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/mqtt-adapter-config/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/mqtt-adapter-config/">dev</option>
@@ -2597,20 +2623,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/admin-guide/secure_communication/index.html b/docs/1.0/admin-guide/secure_communication/index.html
index c2fb125..34f3c9f 100644
--- a/docs/1.0/admin-guide/secure_communication/index.html
+++ b/docs/1.0/admin-guide/secure_communication/index.html
@@ -21,19 +21,19 @@
     <title>Secure Communication :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/secure_communication/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/secure_communication/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/secure_communication/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/secure_communication/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/secure_communication/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/secure_communication/">dev</option>
@@ -2559,20 +2585,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/api/authentication/index.html b/docs/1.0/api/authentication/index.html
index 4aa72fd..ccc263a 100644
--- a/docs/1.0/api/authentication/index.html
+++ b/docs/1.0/api/authentication/index.html
@@ -21,19 +21,19 @@
     <title>Authentication API Specification :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/authentication/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/authentication/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/authentication/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/authentication/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/authentication/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/authentication/">dev</option>
@@ -2434,20 +2460,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/api/command-and-control/index.html b/docs/1.0/api/command-and-control/index.html
index 050bb6b..a8ee5d6 100644
--- a/docs/1.0/api/command-and-control/index.html
+++ b/docs/1.0/api/command-and-control/index.html
@@ -21,19 +21,19 @@
     <title>Command & Control API Specification :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/command-and-control/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/command-and-control/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/command-and-control/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/command-and-control/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/command-and-control/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/command-and-control/">dev</option>
@@ -2686,20 +2712,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/api/credentials/index.html b/docs/1.0/api/credentials/index.html
index bbe39e3..8a5f4a7 100644
--- a/docs/1.0/api/credentials/index.html
+++ b/docs/1.0/api/credentials/index.html
@@ -21,19 +21,19 @@
     <title>Credentials API Specification :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/credentials/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/credentials/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/credentials/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/credentials/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/credentials/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/credentials/">dev</option>
@@ -2903,20 +2929,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/api/device-connection/index.html b/docs/1.0/api/device-connection/index.html
index 4a0f25e..c5b8e2c 100644
--- a/docs/1.0/api/device-connection/index.html
+++ b/docs/1.0/api/device-connection/index.html
@@ -21,19 +21,19 @@
     <title>Device Connection API Specification :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/device-connection/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/device-connection/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/device-connection/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/device-connection/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/device-connection/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/device-connection/">dev</option>
@@ -2642,20 +2668,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/api/device-registration/index.html b/docs/1.0/api/device-registration/index.html
index 7acbf38..7630cbf 100644
--- a/docs/1.0/api/device-registration/index.html
+++ b/docs/1.0/api/device-registration/index.html
@@ -21,19 +21,19 @@
     <title>Device Registration API Specification :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/device-registration/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/device-registration/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/device-registration/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/device-registration/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/device-registration/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/device-registration/">dev</option>
@@ -2534,20 +2560,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/api/event/index.html b/docs/1.0/api/event/index.html
index 60b39be..b3177df 100644
--- a/docs/1.0/api/event/index.html
+++ b/docs/1.0/api/event/index.html
@@ -21,19 +21,19 @@
     <title>Event API Specification :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/event/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/event/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/event/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/event/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/event/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/event/">dev</option>
@@ -2509,20 +2535,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/api/index.html b/docs/1.0/api/index.html
index a3deedd..71ad7de 100644
--- a/docs/1.0/api/index.html
+++ b/docs/1.0/api/index.html
@@ -21,19 +21,19 @@
     <title>API :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/">dev</option>
@@ -2253,20 +2279,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/api/management/index.html b/docs/1.0/api/management/index.html
index 241aa44..18fa05f 100644
--- a/docs/1.0/api/management/index.html
+++ b/docs/1.0/api/management/index.html
@@ -21,19 +21,19 @@
     <title>Device Registry Management API Specification :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -86,14 +86,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1204,7 +1204,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/management/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/management/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/management/">1.2</option>
                     
                   
               
@@ -1220,6 +1240,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/management/">1.1</option>
@@ -1238,6 +1260,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/management/" selected>1.0</option>
@@ -1256,6 +1280,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/management/">dev</option>
@@ -2295,20 +2321,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/api/metrics/index.html b/docs/1.0/api/metrics/index.html
index 74fc0c8..4f6237d 100644
--- a/docs/1.0/api/metrics/index.html
+++ b/docs/1.0/api/metrics/index.html
@@ -21,19 +21,19 @@
     <title>Metrics :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/metrics/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/metrics/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/metrics/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/metrics/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/metrics/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/metrics/">dev</option>
@@ -2508,20 +2534,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/api/telemetry/index.html b/docs/1.0/api/telemetry/index.html
index 1bb114c..9e32a7a 100644
--- a/docs/1.0/api/telemetry/index.html
+++ b/docs/1.0/api/telemetry/index.html
@@ -21,19 +21,19 @@
     <title>Telemetry API Specification :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/telemetry/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/telemetry/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/telemetry/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/telemetry/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/telemetry/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/telemetry/">dev</option>
@@ -2478,20 +2504,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/api/tenant/index.html b/docs/1.0/api/tenant/index.html
index 867d565..72fe1fb 100644
--- a/docs/1.0/api/tenant/index.html
+++ b/docs/1.0/api/tenant/index.html
@@ -21,19 +21,19 @@
     <title>Tenant API Specification :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/tenant/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/tenant/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/tenant/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/tenant/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/tenant/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/tenant/">dev</option>
@@ -2938,20 +2964,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/architecture/auth/index.html b/docs/1.0/architecture/auth/index.html
index 0e3f744..1d7fd06 100644
--- a/docs/1.0/architecture/auth/index.html
+++ b/docs/1.0/architecture/auth/index.html
@@ -21,19 +21,19 @@
     <title>Authentication/Authorization :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/architecture/auth/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/architecture/auth/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/architecture/auth/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/architecture/auth/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/architecture/auth/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/architecture/auth/">dev</option>
@@ -2329,20 +2355,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/architecture/component-view/index.html b/docs/1.0/architecture/component-view/index.html
index b1d9eee..d68de4d 100644
--- a/docs/1.0/architecture/component-view/index.html
+++ b/docs/1.0/architecture/component-view/index.html
@@ -21,19 +21,19 @@
     <title>Component View :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/architecture/component-view/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/architecture/component-view/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/architecture/component-view/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/architecture/component-view/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/architecture/component-view/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/architecture/component-view/">dev</option>
@@ -2328,20 +2354,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/architecture/index.html b/docs/1.0/architecture/index.html
index a43b38c..c0ffb39 100644
--- a/docs/1.0/architecture/index.html
+++ b/docs/1.0/architecture/index.html
@@ -21,19 +21,19 @@
     <title>Architecture :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/architecture/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/architecture/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/architecture/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/architecture/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/architecture/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/architecture/">dev</option>
@@ -2251,20 +2277,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/categories/index.html b/docs/1.0/categories/index.html
index 4f93a30..f198fda 100644
--- a/docs/1.0/categories/index.html
+++ b/docs/1.0/categories/index.html
@@ -21,19 +21,19 @@
     <title>Categories :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/categories/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/categories/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/categories/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/categories/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/categories/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/categories/">dev</option>
@@ -2232,20 +2258,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/concepts/command-and-control/index.html b/docs/1.0/concepts/command-and-control/index.html
index 19e132d..8ed2f2a 100644
--- a/docs/1.0/concepts/command-and-control/index.html
+++ b/docs/1.0/concepts/command-and-control/index.html
@@ -21,19 +21,19 @@
     <title>Command & Control :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1199,9 +1199,11 @@
               
               
                   
+              
+                  
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/command-and-control/">stable (1.2)</option>
+                      <option id="1.2" value="/hono/docs/1.2/concepts/command-and-control/">1.2</option>
                     
                   
               
@@ -1217,6 +1219,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/command-and-control/">1.1</option>
@@ -1235,6 +1239,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/command-and-control/" selected>1.0</option>
@@ -2414,20 +2420,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/concepts/connection-events/index.html b/docs/1.0/concepts/connection-events/index.html
index e6ee105..c64d631 100644
--- a/docs/1.0/concepts/connection-events/index.html
+++ b/docs/1.0/concepts/connection-events/index.html
@@ -21,19 +21,19 @@
     <title>Connection Events :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/connection-events/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/connection-events/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/connection-events/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/connection-events/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/connection-events/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/connection-events/">dev</option>
@@ -2288,20 +2314,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/concepts/device-identity/index.html b/docs/1.0/concepts/device-identity/index.html
index 602fdb2..64b6163 100644
--- a/docs/1.0/concepts/device-identity/index.html
+++ b/docs/1.0/concepts/device-identity/index.html
@@ -21,19 +21,19 @@
     <title>Device Identity :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/device-identity/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/device-identity/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/device-identity/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/device-identity/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/device-identity/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/device-identity/">dev</option>
@@ -2303,20 +2329,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/concepts/device-notifications/index.html b/docs/1.0/concepts/device-notifications/index.html
index afe505c..b5ad1e3 100644
--- a/docs/1.0/concepts/device-notifications/index.html
+++ b/docs/1.0/concepts/device-notifications/index.html
@@ -21,19 +21,19 @@
     <title>Device Notifications :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1199,9 +1199,11 @@
               
               
                   
+              
+                  
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/device-notifications/">stable (1.2)</option>
+                      <option id="1.2" value="/hono/docs/1.2/concepts/device-notifications/">1.2</option>
                     
                   
               
@@ -1217,6 +1219,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/device-notifications/">1.1</option>
@@ -1235,6 +1239,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/device-notifications/" selected>1.0</option>
@@ -2363,20 +2369,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/concepts/index.html b/docs/1.0/concepts/index.html
index 3f4ef8b..e436e90 100644
--- a/docs/1.0/concepts/index.html
+++ b/docs/1.0/concepts/index.html
@@ -21,19 +21,19 @@
     <title>Concepts :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/">dev</option>
@@ -2248,20 +2274,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/concepts/resource-limits/index.html b/docs/1.0/concepts/resource-limits/index.html
index b0416f4..fdd07fe 100644
--- a/docs/1.0/concepts/resource-limits/index.html
+++ b/docs/1.0/concepts/resource-limits/index.html
@@ -21,19 +21,19 @@
     <title>Resource limits :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/resource-limits/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/resource-limits/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/resource-limits/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/resource-limits/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/resource-limits/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/resource-limits/">dev</option>
@@ -2315,20 +2341,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/concepts/tenancy/index.html b/docs/1.0/concepts/tenancy/index.html
index 9c802c5..3a9be33 100644
--- a/docs/1.0/concepts/tenancy/index.html
+++ b/docs/1.0/concepts/tenancy/index.html
@@ -21,19 +21,19 @@
     <title>Multi-Tenancy :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1199,9 +1199,11 @@
               
               
                   
+              
+                  
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/tenancy/">stable (1.2)</option>
+                      <option id="1.2" value="/hono/docs/1.2/concepts/tenancy/">1.2</option>
                     
                   
               
@@ -1217,6 +1219,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/tenancy/">1.1</option>
@@ -1235,6 +1239,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/tenancy/" selected>1.0</option>
@@ -2401,20 +2407,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/deployment/create-kubernetes-cluster/index.html b/docs/1.0/deployment/create-kubernetes-cluster/index.html
index ac9512d..79ceade 100644
--- a/docs/1.0/deployment/create-kubernetes-cluster/index.html
+++ b/docs/1.0/deployment/create-kubernetes-cluster/index.html
@@ -21,19 +21,19 @@
     <title>Setting up a Kubernetes Cluster :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/create-kubernetes-cluster/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/create-kubernetes-cluster/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/create-kubernetes-cluster/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/create-kubernetes-cluster/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/create-kubernetes-cluster/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/create-kubernetes-cluster/">dev</option>
@@ -2412,20 +2438,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/deployment/helm-based-deployment/index.html b/docs/1.0/deployment/helm-based-deployment/index.html
index e052d74..10c69e3 100644
--- a/docs/1.0/deployment/helm-based-deployment/index.html
+++ b/docs/1.0/deployment/helm-based-deployment/index.html
@@ -21,19 +21,19 @@
     <title>Helm based Deployment :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/helm-based-deployment/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/helm-based-deployment/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/helm-based-deployment/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/helm-based-deployment/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/helm-based-deployment/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/helm-based-deployment/">dev</option>
@@ -2859,20 +2885,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/deployment/index.html b/docs/1.0/deployment/index.html
index 7dc01a0..09c163e 100644
--- a/docs/1.0/deployment/index.html
+++ b/docs/1.0/deployment/index.html
@@ -21,19 +21,19 @@
     <title>Deployment :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/">dev</option>
@@ -2251,20 +2277,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/deployment/openshift/index.html b/docs/1.0/deployment/openshift/index.html
index 9b919f0..69cf845 100644
--- a/docs/1.0/deployment/openshift/index.html
+++ b/docs/1.0/deployment/openshift/index.html
@@ -21,19 +21,19 @@
     <title>OpenShift / OKD :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/openshift/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/openshift/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/openshift/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/openshift/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/openshift/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/openshift/">dev</option>
@@ -2272,20 +2298,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/deployment/resource-limitation/index.html b/docs/1.0/deployment/resource-limitation/index.html
index e1f542b..f4bbfcc 100644
--- a/docs/1.0/deployment/resource-limitation/index.html
+++ b/docs/1.0/deployment/resource-limitation/index.html
@@ -21,19 +21,19 @@
     <title>Limiting Resource Usage :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/resource-limitation/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/resource-limitation/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/resource-limitation/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/resource-limitation/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/resource-limitation/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/resource-limitation/">dev</option>
@@ -2351,20 +2377,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/dev-guide/building_hono/index.html b/docs/1.0/dev-guide/building_hono/index.html
index 4ef4404..bf5a332 100644
--- a/docs/1.0/dev-guide/building_hono/index.html
+++ b/docs/1.0/dev-guide/building_hono/index.html
@@ -21,19 +21,19 @@
     <title>Building from Source :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/dev-guide/building_hono/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/dev-guide/building_hono/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/building_hono/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/dev-guide/building_hono/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/dev-guide/building_hono/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/dev-guide/building_hono/">dev</option>
@@ -2335,20 +2361,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/dev-guide/custom_http_adapter/index.html b/docs/1.0/dev-guide/custom_http_adapter/index.html
index b88e057..1557592 100644
--- a/docs/1.0/dev-guide/custom_http_adapter/index.html
+++ b/docs/1.0/dev-guide/custom_http_adapter/index.html
@@ -21,19 +21,19 @@
     <title>Implement a Custom Hono HTTP Protocol Adapter :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/dev-guide/custom_http_adapter/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/dev-guide/custom_http_adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/custom_http_adapter/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/dev-guide/custom_http_adapter/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/dev-guide/custom_http_adapter/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/dev-guide/custom_http_adapter/">dev</option>
@@ -2383,20 +2409,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/dev-guide/index.html b/docs/1.0/dev-guide/index.html
index ea67cfc..52c2f67 100644
--- a/docs/1.0/dev-guide/index.html
+++ b/docs/1.0/dev-guide/index.html
@@ -21,19 +21,19 @@
     <title>Developer Guide :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/dev-guide/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/dev-guide/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/dev-guide/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/dev-guide/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/dev-guide/">dev</option>
@@ -2251,20 +2277,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/dev-guide/java_client_consumer/index.html b/docs/1.0/dev-guide/java_client_consumer/index.html
index d15775b..d6f14a5 100644
--- a/docs/1.0/dev-guide/java_client_consumer/index.html
+++ b/docs/1.0/dev-guide/java_client_consumer/index.html
@@ -21,19 +21,19 @@
     <title>Consuming Messages from Java :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/dev-guide/java_client_consumer/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/dev-guide/java_client_consumer/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/java_client_consumer/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/dev-guide/java_client_consumer/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/dev-guide/java_client_consumer/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/dev-guide/java_client_consumer/">dev</option>
@@ -2353,20 +2379,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/index.html b/docs/1.0/index.html
index 2c588a0..69150a0 100644
--- a/docs/1.0/index.html
+++ b/docs/1.0/index.html
@@ -21,19 +21,19 @@
     <title>Documentation :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/">dev</option>
@@ -2203,20 +2229,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/sitemap.xml b/docs/1.0/sitemap.xml
index 740cc07..4bce86f 100644
--- a/docs/1.0/sitemap.xml
+++ b/docs/1.0/sitemap.xml
@@ -11,6 +11,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/"
                 />
@@ -35,6 +40,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/concepts/"
                 />
@@ -59,6 +69,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/device-identity/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/concepts/device-identity/"
                 />
@@ -78,8 +93,8 @@
     <loc>https://www.eclipse.org/hono/docs/1.0/concepts/tenancy/</loc>
     <xhtml:link
                 rel="alternate"
-                hreflang="stable"
-                href="https://www.eclipse.org/hono/docs/concepts/tenancy/"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/tenancy/"
                 />
     <xhtml:link
                 rel="alternate"
@@ -97,8 +112,8 @@
     <loc>https://www.eclipse.org/hono/docs/1.0/concepts/device-notifications/</loc>
     <xhtml:link
                 rel="alternate"
-                hreflang="stable"
-                href="https://www.eclipse.org/hono/docs/concepts/device-notifications/"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/device-notifications/"
                 />
     <xhtml:link
                 rel="alternate"
@@ -116,8 +131,8 @@
     <loc>https://www.eclipse.org/hono/docs/1.0/concepts/command-and-control/</loc>
     <xhtml:link
                 rel="alternate"
-                hreflang="stable"
-                href="https://www.eclipse.org/hono/docs/concepts/command-and-control/"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/command-and-control/"
                 />
     <xhtml:link
                 rel="alternate"
@@ -140,6 +155,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/resource-limits/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/concepts/resource-limits/"
                 />
@@ -164,6 +184,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/connection-events/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/concepts/connection-events/"
                 />
@@ -188,6 +213,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/"
                 />
@@ -207,8 +237,8 @@
     <loc>https://www.eclipse.org/hono/docs/1.0/user-guide/device-registry/</loc>
     <xhtml:link
                 rel="alternate"
-                hreflang="stable"
-                href="https://www.eclipse.org/hono/docs/user-guide/device-registry/"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/device-registry/"
                 />
     <xhtml:link
                 rel="alternate"
@@ -231,6 +261,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/http-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/http-adapter/"
                 />
@@ -255,6 +290,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/mqtt-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/mqtt-adapter/"
                 />
@@ -279,6 +319,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/amqp-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/amqp-adapter/"
                 />
@@ -303,6 +348,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/kura-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/kura-adapter/"
                 />
@@ -327,6 +377,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/sigfox-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/sigfox-adapter/"
                 />
@@ -351,6 +406,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/jmeter_load_tests/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/jmeter_load_tests/"
                 />
@@ -375,6 +435,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/"
                 />
@@ -399,6 +464,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/common-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/common-config/"
                 />
@@ -423,6 +493,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/auth-server-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/auth-server-config/"
                 />
@@ -442,8 +517,8 @@
     <loc>https://www.eclipse.org/hono/docs/1.0/admin-guide/device-registry-config/</loc>
     <xhtml:link
                 rel="alternate"
-                hreflang="stable"
-                href="https://www.eclipse.org/hono/docs/admin-guide/device-registry-config/"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/device-registry-config/"
                 />
     <xhtml:link
                 rel="alternate"
@@ -466,6 +541,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/device-connection-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/device-connection-config/"
                 />
@@ -490,6 +570,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/http-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/http-adapter-config/"
                 />
@@ -514,6 +599,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/amqp-adapter-config/"
                 />
@@ -538,6 +628,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/mqtt-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/mqtt-adapter-config/"
                 />
@@ -562,6 +657,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/kura-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/kura-adapter-config/"
                 />
@@ -586,6 +686,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/hono-client-configuration/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/hono-client-configuration/"
                 />
@@ -610,6 +715,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-network-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/amqp-network-config/"
                 />
@@ -634,6 +744,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/secure_communication/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/secure_communication/"
                 />
@@ -658,6 +773,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/monitoring-tracing-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/monitoring-tracing-config/"
                 />
@@ -682,6 +802,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/dev-guide/"
                 />
@@ -706,6 +831,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/building_hono/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/dev-guide/building_hono/"
                 />
@@ -730,6 +860,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/java_client_consumer/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/dev-guide/java_client_consumer/"
                 />
@@ -754,6 +889,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/custom_http_adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/dev-guide/custom_http_adapter/"
                 />
@@ -778,6 +918,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/"
                 />
@@ -802,6 +947,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/telemetry/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/telemetry/"
                 />
@@ -826,6 +976,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/event/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/event/"
                 />
@@ -850,6 +1005,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/command-and-control/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/command-and-control/"
                 />
@@ -874,6 +1034,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/tenant/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/tenant/"
                 />
@@ -898,6 +1063,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/device-connection/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/device-connection/"
                 />
@@ -922,6 +1092,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/device-registration/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/device-registration/"
                 />
@@ -946,6 +1121,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/credentials/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/credentials/"
                 />
@@ -970,6 +1150,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/authentication/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/authentication/"
                 />
@@ -994,6 +1179,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/management/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/management/"
                 />
@@ -1018,6 +1208,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/metrics/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/metrics/"
                 />
@@ -1042,6 +1237,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/deployment/"
                 />
@@ -1066,6 +1266,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/helm-based-deployment/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/deployment/helm-based-deployment/"
                 />
@@ -1090,6 +1295,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/openshift/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/deployment/openshift/"
                 />
@@ -1114,6 +1324,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/create-kubernetes-cluster/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/deployment/create-kubernetes-cluster/"
                 />
@@ -1138,6 +1353,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/resource-limitation/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/deployment/resource-limitation/"
                 />
@@ -1162,6 +1382,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/architecture/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/architecture/"
                 />
@@ -1186,6 +1411,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/architecture/component-view/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/architecture/component-view/"
                 />
@@ -1210,6 +1440,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/architecture/auth/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/architecture/auth/"
                 />
@@ -1235,6 +1470,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/categories/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/categories/"
                 />
@@ -1260,6 +1500,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/tags/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/tags/"
                 />
diff --git a/docs/1.0/tags/index.html b/docs/1.0/tags/index.html
index 65a7a2a..2c924cb 100644
--- a/docs/1.0/tags/index.html
+++ b/docs/1.0/tags/index.html
@@ -21,19 +21,19 @@
     <title>Tags :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/tags/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/tags/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/tags/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/tags/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/tags/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/tags/">dev</option>
@@ -2232,20 +2258,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/user-guide/amqp-adapter/index.html b/docs/1.0/user-guide/amqp-adapter/index.html
index b6329f0..02d03d7 100644
--- a/docs/1.0/user-guide/amqp-adapter/index.html
+++ b/docs/1.0/user-guide/amqp-adapter/index.html
@@ -21,19 +21,19 @@
     <title>AMQP Adapter :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/amqp-adapter/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/amqp-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/amqp-adapter/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/amqp-adapter/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/amqp-adapter/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/amqp-adapter/">dev</option>
@@ -2887,20 +2913,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/user-guide/device-registry/index.html b/docs/1.0/user-guide/device-registry/index.html
index afb7dcd..8e784dd 100644
--- a/docs/1.0/user-guide/device-registry/index.html
+++ b/docs/1.0/user-guide/device-registry/index.html
@@ -21,19 +21,19 @@
     <title>Device Registry :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1199,9 +1199,11 @@
               
               
                   
+              
+                  
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/device-registry/">stable (1.2)</option>
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/device-registry/">1.2</option>
                     
                   
               
@@ -1217,6 +1219,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/device-registry/">1.1</option>
@@ -1235,6 +1239,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/device-registry/" selected>1.0</option>
@@ -2772,20 +2778,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/user-guide/http-adapter/index.html b/docs/1.0/user-guide/http-adapter/index.html
index 2790177..8b3c993 100644
--- a/docs/1.0/user-guide/http-adapter/index.html
+++ b/docs/1.0/user-guide/http-adapter/index.html
@@ -21,19 +21,19 @@
     <title>HTTP Adapter :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/http-adapter/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/http-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/http-adapter/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/http-adapter/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/http-adapter/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/http-adapter/">dev</option>
@@ -3139,20 +3165,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/user-guide/index.html b/docs/1.0/user-guide/index.html
index 99d386d..d0e8983 100644
--- a/docs/1.0/user-guide/index.html
+++ b/docs/1.0/user-guide/index.html
@@ -21,19 +21,19 @@
     <title>User Guide :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/">dev</option>
@@ -2251,20 +2277,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/user-guide/jmeter_load_tests/index.html b/docs/1.0/user-guide/jmeter_load_tests/index.html
index 32d79a4..61b371b 100644
--- a/docs/1.0/user-guide/jmeter_load_tests/index.html
+++ b/docs/1.0/user-guide/jmeter_load_tests/index.html
@@ -21,19 +21,19 @@
     <title>Load Tests with JMeter :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/jmeter_load_tests/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/jmeter_load_tests/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/jmeter_load_tests/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/jmeter_load_tests/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/jmeter_load_tests/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/jmeter_load_tests/">dev</option>
@@ -2302,20 +2328,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/user-guide/kura-adapter/index.html b/docs/1.0/user-guide/kura-adapter/index.html
index a75faa6..278897d 100644
--- a/docs/1.0/user-guide/kura-adapter/index.html
+++ b/docs/1.0/user-guide/kura-adapter/index.html
@@ -21,19 +21,19 @@
     <title>Kura Adapter :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/kura-adapter/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/kura-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/kura-adapter/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/kura-adapter/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/kura-adapter/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/kura-adapter/">dev</option>
@@ -2375,20 +2401,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/user-guide/mqtt-adapter/index.html b/docs/1.0/user-guide/mqtt-adapter/index.html
index ad6c82f..f075b8f 100644
--- a/docs/1.0/user-guide/mqtt-adapter/index.html
+++ b/docs/1.0/user-guide/mqtt-adapter/index.html
@@ -21,19 +21,19 @@
     <title>MQTT Adapter :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/mqtt-adapter/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/mqtt-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/mqtt-adapter/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/mqtt-adapter/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/mqtt-adapter/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/mqtt-adapter/">dev</option>
@@ -2808,20 +2834,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.0/user-guide/sigfox-adapter/index.html b/docs/1.0/user-guide/sigfox-adapter/index.html
index bce1df7..9ad27f8 100644
--- a/docs/1.0/user-guide/sigfox-adapter/index.html
+++ b/docs/1.0/user-guide/sigfox-adapter/index.html
@@ -21,19 +21,19 @@
     <title>Sigfox Adapter :: Eclipse Hono&trade; Vers.: 1.0</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.0";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1201,7 +1201,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/sigfox-adapter/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/sigfox-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/sigfox-adapter/">1.2</option>
                     
                   
               
@@ -1217,6 +1237,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/sigfox-adapter/">1.1</option>
@@ -1235,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/sigfox-adapter/" selected>1.0</option>
@@ -1253,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/sigfox-adapter/">dev</option>
@@ -2420,20 +2446,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/404.html b/docs/1.1/404.html
index 6cc08c5..1310a1f 100644
--- a/docs/1.1/404.html
+++ b/docs/1.1/404.html
@@ -18,16 +18,16 @@
   <title>404 Page not found</title>
   
    
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/horsey.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/horsey.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 <style type="text/css">
     :root #header + #content > #left > #rlblock_left {
diff --git a/docs/1.1/admin-guide/amqp-adapter-config/index.html b/docs/1.1/admin-guide/amqp-adapter-config/index.html
index 2ef9ccd..9677617 100644
--- a/docs/1.1/admin-guide/amqp-adapter-config/index.html
+++ b/docs/1.1/admin-guide/amqp-adapter-config/index.html
@@ -21,19 +21,19 @@
     <title>AMQP Adapter Configuration :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/amqp-adapter-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/amqp-adapter-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/amqp-adapter-config/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/amqp-adapter-config/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/amqp-adapter-config/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/amqp-adapter-config/">dev</option>
@@ -2575,20 +2601,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/admin-guide/amqp-network-config/index.html b/docs/1.1/admin-guide/amqp-network-config/index.html
index 6a86f46..7b021df 100644
--- a/docs/1.1/admin-guide/amqp-network-config/index.html
+++ b/docs/1.1/admin-guide/amqp-network-config/index.html
@@ -21,19 +21,19 @@
     <title>AMQP 1.0 Messaging Network Configuration :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/amqp-network-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/amqp-network-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/amqp-network-config/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/amqp-network-config/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/amqp-network-config/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/amqp-network-config/">dev</option>
@@ -2356,20 +2382,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/admin-guide/auth-server-config/index.html b/docs/1.1/admin-guide/auth-server-config/index.html
index be45ce5..f1919d3 100644
--- a/docs/1.1/admin-guide/auth-server-config/index.html
+++ b/docs/1.1/admin-guide/auth-server-config/index.html
@@ -21,19 +21,19 @@
     <title>Auth Server Configuration :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/auth-server-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/auth-server-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/auth-server-config/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/auth-server-config/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/auth-server-config/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/auth-server-config/">dev</option>
@@ -2569,20 +2595,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/admin-guide/common-config/index.html b/docs/1.1/admin-guide/common-config/index.html
index 4c79b6a..f247cf4 100644
--- a/docs/1.1/admin-guide/common-config/index.html
+++ b/docs/1.1/admin-guide/common-config/index.html
@@ -21,19 +21,19 @@
     <title>Common Configuration :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/common-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/common-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/common-config/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/common-config/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/common-config/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/common-config/">dev</option>
@@ -2549,20 +2575,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/admin-guide/device-connection-config/index.html b/docs/1.1/admin-guide/device-connection-config/index.html
index c6f0d75..8c54e11 100644
--- a/docs/1.1/admin-guide/device-connection-config/index.html
+++ b/docs/1.1/admin-guide/device-connection-config/index.html
@@ -21,19 +21,19 @@
     <title>Configuring the Device Connection Service :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/device-connection-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/device-connection-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/device-connection-config/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/device-connection-config/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/device-connection-config/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/device-connection-config/">dev</option>
@@ -2614,20 +2640,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/admin-guide/device-registry-config/index.html b/docs/1.1/admin-guide/device-registry-config/index.html
index ea711ab..6519149 100644
--- a/docs/1.1/admin-guide/device-registry-config/index.html
+++ b/docs/1.1/admin-guide/device-registry-config/index.html
@@ -21,19 +21,19 @@
     <title>Device Registry Configuration :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1237,9 +1237,11 @@
               
               
                   
+              
+                  
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/device-registry-config/">stable (1.2)</option>
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/device-registry-config/">1.2</option>
                     
                   
               
@@ -1255,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/device-registry-config/" selected>1.1</option>
@@ -1273,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/device-registry-config/">1.0</option>
@@ -2804,20 +2810,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/admin-guide/hono-client-configuration/index.html b/docs/1.1/admin-guide/hono-client-configuration/index.html
index 227ea1b..3b00755 100644
--- a/docs/1.1/admin-guide/hono-client-configuration/index.html
+++ b/docs/1.1/admin-guide/hono-client-configuration/index.html
@@ -21,19 +21,19 @@
     <title>Hono Client Configuration :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/hono-client-configuration/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/hono-client-configuration/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/hono-client-configuration/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/hono-client-configuration/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/hono-client-configuration/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/hono-client-configuration/">dev</option>
@@ -2624,20 +2650,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/admin-guide/http-adapter-config/index.html b/docs/1.1/admin-guide/http-adapter-config/index.html
index aa4bc24..6d47366 100644
--- a/docs/1.1/admin-guide/http-adapter-config/index.html
+++ b/docs/1.1/admin-guide/http-adapter-config/index.html
@@ -21,19 +21,19 @@
     <title>HTTP Adapter Configuration :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/http-adapter-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/http-adapter-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/http-adapter-config/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/http-adapter-config/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/http-adapter-config/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/http-adapter-config/">dev</option>
@@ -2554,20 +2580,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/admin-guide/index.html b/docs/1.1/admin-guide/index.html
index 2f138c1..2fc8370 100644
--- a/docs/1.1/admin-guide/index.html
+++ b/docs/1.1/admin-guide/index.html
@@ -21,19 +21,19 @@
     <title>Admin Guide :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/">dev</option>
@@ -2321,20 +2347,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/admin-guide/kura-adapter-config/index.html b/docs/1.1/admin-guide/kura-adapter-config/index.html
index b41cb95..31194f3 100644
--- a/docs/1.1/admin-guide/kura-adapter-config/index.html
+++ b/docs/1.1/admin-guide/kura-adapter-config/index.html
@@ -21,19 +21,19 @@
     <title>Kura Adapter Configuration :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/kura-adapter-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/kura-adapter-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/kura-adapter-config/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/kura-adapter-config/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/kura-adapter-config/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/kura-adapter-config/">dev</option>
@@ -2568,20 +2594,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/admin-guide/monitoring-tracing-config/index.html b/docs/1.1/admin-guide/monitoring-tracing-config/index.html
index 3988b8c..88354be 100644
--- a/docs/1.1/admin-guide/monitoring-tracing-config/index.html
+++ b/docs/1.1/admin-guide/monitoring-tracing-config/index.html
@@ -21,19 +21,19 @@
     <title>Monitoring & Tracing :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/monitoring-tracing-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/monitoring-tracing-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/monitoring-tracing-config/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/monitoring-tracing-config/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/monitoring-tracing-config/">dev</option>
@@ -2550,20 +2576,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/admin-guide/mqtt-adapter-config/index.html b/docs/1.1/admin-guide/mqtt-adapter-config/index.html
index 1a5d9f8..a8998ab 100644
--- a/docs/1.1/admin-guide/mqtt-adapter-config/index.html
+++ b/docs/1.1/admin-guide/mqtt-adapter-config/index.html
@@ -21,19 +21,19 @@
     <title>MQTT Adapter Configuration :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/mqtt-adapter-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/mqtt-adapter-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/mqtt-adapter-config/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/mqtt-adapter-config/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/mqtt-adapter-config/">dev</option>
@@ -2561,20 +2587,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/admin-guide/secure_communication/index.html b/docs/1.1/admin-guide/secure_communication/index.html
index a408fad..7ee69d9 100644
--- a/docs/1.1/admin-guide/secure_communication/index.html
+++ b/docs/1.1/admin-guide/secure_communication/index.html
@@ -21,19 +21,19 @@
     <title>Secure Communication :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/secure_communication/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/secure_communication/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/secure_communication/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/secure_communication/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/secure_communication/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/secure_communication/">dev</option>
@@ -2678,20 +2704,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/api/authentication/index.html b/docs/1.1/api/authentication/index.html
index 5a16751..6a620f5 100644
--- a/docs/1.1/api/authentication/index.html
+++ b/docs/1.1/api/authentication/index.html
@@ -21,19 +21,19 @@
     <title>Authentication API Specification :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/authentication/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/authentication/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/authentication/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/authentication/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/authentication/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/authentication/">dev</option>
@@ -2504,20 +2530,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/api/command-and-control/index.html b/docs/1.1/api/command-and-control/index.html
index f3e175d..5384457 100644
--- a/docs/1.1/api/command-and-control/index.html
+++ b/docs/1.1/api/command-and-control/index.html
@@ -21,19 +21,19 @@
     <title>Command & Control API Specification :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/command-and-control/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/command-and-control/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/command-and-control/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/command-and-control/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/command-and-control/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/command-and-control/">dev</option>
@@ -2756,20 +2782,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/api/credentials/index.html b/docs/1.1/api/credentials/index.html
index d84e901..71d8055 100644
--- a/docs/1.1/api/credentials/index.html
+++ b/docs/1.1/api/credentials/index.html
@@ -21,19 +21,19 @@
     <title>Credentials API Specification :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/credentials/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/credentials/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/credentials/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/credentials/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/credentials/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/credentials/">dev</option>
@@ -2997,20 +3023,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/api/device-connection/index.html b/docs/1.1/api/device-connection/index.html
index 763f5790..77e8167 100644
--- a/docs/1.1/api/device-connection/index.html
+++ b/docs/1.1/api/device-connection/index.html
@@ -21,19 +21,19 @@
     <title>Device Connection API Specification :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/device-connection/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/device-connection/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/device-connection/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/device-connection/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/device-connection/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/device-connection/">dev</option>
@@ -2712,20 +2738,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/api/device-registration/index.html b/docs/1.1/api/device-registration/index.html
index 78bdefb..64a926f 100644
--- a/docs/1.1/api/device-registration/index.html
+++ b/docs/1.1/api/device-registration/index.html
@@ -21,19 +21,19 @@
     <title>Device Registration API Specification :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/device-registration/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/device-registration/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/device-registration/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/device-registration/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/device-registration/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/device-registration/">dev</option>
@@ -2604,20 +2630,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/api/event/index.html b/docs/1.1/api/event/index.html
index eddc21e..4c4868b 100644
--- a/docs/1.1/api/event/index.html
+++ b/docs/1.1/api/event/index.html
@@ -21,19 +21,19 @@
     <title>Event API Specification :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/event/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/event/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/event/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/event/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/event/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/event/">dev</option>
@@ -2579,20 +2605,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/api/index.html b/docs/1.1/api/index.html
index 0631f2ec..19d77f9 100644
--- a/docs/1.1/api/index.html
+++ b/docs/1.1/api/index.html
@@ -21,19 +21,19 @@
     <title>API :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/">dev</option>
@@ -2323,20 +2349,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/api/management/index.html b/docs/1.1/api/management/index.html
index ced52d8..1a50b01 100644
--- a/docs/1.1/api/management/index.html
+++ b/docs/1.1/api/management/index.html
@@ -21,19 +21,19 @@
     <title>Device Registry Management API Specification :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -86,14 +86,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1242,7 +1242,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/management/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/management/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/management/">1.2</option>
                     
                   
               
@@ -1258,6 +1278,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/management/" selected>1.1</option>
@@ -1276,6 +1298,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/management/">1.0</option>
@@ -1294,6 +1318,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/management/">dev</option>
@@ -2365,20 +2391,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/api/metrics/index.html b/docs/1.1/api/metrics/index.html
index 735564a..9e22a4c 100644
--- a/docs/1.1/api/metrics/index.html
+++ b/docs/1.1/api/metrics/index.html
@@ -21,19 +21,19 @@
     <title>Metrics :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/metrics/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/metrics/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/metrics/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/metrics/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/metrics/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/metrics/">dev</option>
@@ -2595,20 +2621,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/api/telemetry/index.html b/docs/1.1/api/telemetry/index.html
index df386fb..70f1d7b 100644
--- a/docs/1.1/api/telemetry/index.html
+++ b/docs/1.1/api/telemetry/index.html
@@ -21,19 +21,19 @@
     <title>Telemetry API Specification :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/telemetry/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/telemetry/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/telemetry/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/telemetry/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/telemetry/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/telemetry/">dev</option>
@@ -2548,20 +2574,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/api/tenant/index.html b/docs/1.1/api/tenant/index.html
index 9b27276..24ad1ba 100644
--- a/docs/1.1/api/tenant/index.html
+++ b/docs/1.1/api/tenant/index.html
@@ -21,19 +21,19 @@
     <title>Tenant API Specification :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/tenant/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/tenant/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/tenant/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/tenant/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/tenant/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/tenant/">dev</option>
@@ -3072,20 +3098,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/architecture/auth/index.html b/docs/1.1/architecture/auth/index.html
index 1c439fa..85e4ed1 100644
--- a/docs/1.1/architecture/auth/index.html
+++ b/docs/1.1/architecture/auth/index.html
@@ -21,19 +21,19 @@
     <title>Authentication/Authorization :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/architecture/auth/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/architecture/auth/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/architecture/auth/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/architecture/auth/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/architecture/auth/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/architecture/auth/">dev</option>
@@ -2399,20 +2425,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/architecture/component-view/index.html b/docs/1.1/architecture/component-view/index.html
index ca53bb9..2134340 100644
--- a/docs/1.1/architecture/component-view/index.html
+++ b/docs/1.1/architecture/component-view/index.html
@@ -21,19 +21,19 @@
     <title>Component View :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/architecture/component-view/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/architecture/component-view/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/architecture/component-view/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/architecture/component-view/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/architecture/component-view/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/architecture/component-view/">dev</option>
@@ -2398,20 +2424,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/architecture/index.html b/docs/1.1/architecture/index.html
index e9d4f30..a6309b5 100644
--- a/docs/1.1/architecture/index.html
+++ b/docs/1.1/architecture/index.html
@@ -21,19 +21,19 @@
     <title>Architecture :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/architecture/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/architecture/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/architecture/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/architecture/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/architecture/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/architecture/">dev</option>
@@ -2321,20 +2347,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/categories/index.html b/docs/1.1/categories/index.html
index 8800cc4..f2b8008 100644
--- a/docs/1.1/categories/index.html
+++ b/docs/1.1/categories/index.html
@@ -21,19 +21,19 @@
     <title>Categories :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/categories/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/categories/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/categories/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/categories/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/categories/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/categories/">dev</option>
@@ -2302,20 +2328,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/concepts/command-and-control/index.html b/docs/1.1/concepts/command-and-control/index.html
index 7c21925..d264bcd 100644
--- a/docs/1.1/concepts/command-and-control/index.html
+++ b/docs/1.1/concepts/command-and-control/index.html
@@ -21,19 +21,19 @@
     <title>Command & Control :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1237,9 +1237,11 @@
               
               
                   
+              
+                  
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/command-and-control/">stable (1.2)</option>
+                      <option id="1.2" value="/hono/docs/1.2/concepts/command-and-control/">1.2</option>
                     
                   
               
@@ -1255,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/command-and-control/" selected>1.1</option>
@@ -1273,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/command-and-control/">1.0</option>
@@ -2484,20 +2490,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/concepts/connecting-devices/index.html b/docs/1.1/concepts/connecting-devices/index.html
index 2eec9c3..da7e891 100644
--- a/docs/1.1/concepts/connecting-devices/index.html
+++ b/docs/1.1/concepts/connecting-devices/index.html
@@ -21,19 +21,19 @@
     <title>Connecting Devices :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/connecting-devices/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/connecting-devices/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/connecting-devices/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/connecting-devices/" selected>1.1</option>
@@ -1275,6 +1297,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/connecting-devices/">dev</option>
@@ -2409,20 +2433,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/concepts/connection-events/index.html b/docs/1.1/concepts/connection-events/index.html
index 050781e..5b73bae 100644
--- a/docs/1.1/concepts/connection-events/index.html
+++ b/docs/1.1/concepts/connection-events/index.html
@@ -21,19 +21,19 @@
     <title>Connection Events :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/connection-events/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/connection-events/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/connection-events/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/connection-events/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/connection-events/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/connection-events/">dev</option>
@@ -2358,20 +2384,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/concepts/device-identity/index.html b/docs/1.1/concepts/device-identity/index.html
index 61e4b40..7279ba8 100644
--- a/docs/1.1/concepts/device-identity/index.html
+++ b/docs/1.1/concepts/device-identity/index.html
@@ -21,19 +21,19 @@
     <title>Device Identity :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/device-identity/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/device-identity/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/device-identity/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/device-identity/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/device-identity/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/device-identity/">dev</option>
@@ -2378,20 +2404,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/concepts/device-notifications/index.html b/docs/1.1/concepts/device-notifications/index.html
index ae35fafd..9b42941 100644
--- a/docs/1.1/concepts/device-notifications/index.html
+++ b/docs/1.1/concepts/device-notifications/index.html
@@ -21,19 +21,19 @@
     <title>Device Notifications :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1237,9 +1237,11 @@
               
               
                   
+              
+                  
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/device-notifications/">stable (1.2)</option>
+                      <option id="1.2" value="/hono/docs/1.2/concepts/device-notifications/">1.2</option>
                     
                   
               
@@ -1255,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/device-notifications/" selected>1.1</option>
@@ -1273,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/device-notifications/">1.0</option>
@@ -2433,20 +2439,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/concepts/device-provisioning/index.html b/docs/1.1/concepts/device-provisioning/index.html
index 0ade2cc..1b3a953 100644
--- a/docs/1.1/concepts/device-provisioning/index.html
+++ b/docs/1.1/concepts/device-provisioning/index.html
@@ -21,19 +21,19 @@
     <title>Device Provisioning :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/device-provisioning/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/device-provisioning/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/device-provisioning/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/device-provisioning/" selected>1.1</option>
@@ -1275,6 +1297,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/device-provisioning/">dev</option>
@@ -2419,20 +2443,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/concepts/index.html b/docs/1.1/concepts/index.html
index a35fd6c..605227d 100644
--- a/docs/1.1/concepts/index.html
+++ b/docs/1.1/concepts/index.html
@@ -21,19 +21,19 @@
     <title>Concepts :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/">dev</option>
@@ -2318,20 +2344,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/concepts/resource-limits/index.html b/docs/1.1/concepts/resource-limits/index.html
index 0e56a53..9c997fe 100644
--- a/docs/1.1/concepts/resource-limits/index.html
+++ b/docs/1.1/concepts/resource-limits/index.html
@@ -21,19 +21,19 @@
     <title>Resource limits :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/resource-limits/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/resource-limits/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/resource-limits/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/resource-limits/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/resource-limits/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/resource-limits/">dev</option>
@@ -2422,20 +2448,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/concepts/tenancy/index.html b/docs/1.1/concepts/tenancy/index.html
index 72c123c..723ba51 100644
--- a/docs/1.1/concepts/tenancy/index.html
+++ b/docs/1.1/concepts/tenancy/index.html
@@ -21,19 +21,19 @@
     <title>Multi-Tenancy :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1237,9 +1237,11 @@
               
               
                   
+              
+                  
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/tenancy/">stable (1.2)</option>
+                      <option id="1.2" value="/hono/docs/1.2/concepts/tenancy/">1.2</option>
                     
                   
               
@@ -1255,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/tenancy/" selected>1.1</option>
@@ -1273,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/tenancy/">1.0</option>
@@ -2471,20 +2477,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/deployment/create-kubernetes-cluster/index.html b/docs/1.1/deployment/create-kubernetes-cluster/index.html
index 5c79f31..d9dabc9 100644
--- a/docs/1.1/deployment/create-kubernetes-cluster/index.html
+++ b/docs/1.1/deployment/create-kubernetes-cluster/index.html
@@ -21,19 +21,19 @@
     <title>Setting up a Kubernetes Cluster :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/create-kubernetes-cluster/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/create-kubernetes-cluster/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/create-kubernetes-cluster/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/create-kubernetes-cluster/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/create-kubernetes-cluster/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/create-kubernetes-cluster/">dev</option>
@@ -2498,20 +2524,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/deployment/helm-based-deployment/index.html b/docs/1.1/deployment/helm-based-deployment/index.html
index 90d7bba..bd9c62a 100644
--- a/docs/1.1/deployment/helm-based-deployment/index.html
+++ b/docs/1.1/deployment/helm-based-deployment/index.html
@@ -21,19 +21,19 @@
     <title>Helm based Deployment :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/helm-based-deployment/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/helm-based-deployment/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/helm-based-deployment/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/helm-based-deployment/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/helm-based-deployment/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/helm-based-deployment/">dev</option>
@@ -2568,20 +2594,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/deployment/index.html b/docs/1.1/deployment/index.html
index b104ea5..b50c904 100644
--- a/docs/1.1/deployment/index.html
+++ b/docs/1.1/deployment/index.html
@@ -21,19 +21,19 @@
     <title>Deployment :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/">dev</option>
@@ -2321,20 +2347,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/deployment/openshift/index.html b/docs/1.1/deployment/openshift/index.html
index f4109f1..26920f0 100644
--- a/docs/1.1/deployment/openshift/index.html
+++ b/docs/1.1/deployment/openshift/index.html
@@ -21,19 +21,19 @@
     <title>OpenShift / OKD :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/openshift/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/openshift/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/openshift/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/openshift/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/openshift/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/openshift/">dev</option>
@@ -2342,20 +2368,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/deployment/resource-limitation/index.html b/docs/1.1/deployment/resource-limitation/index.html
index 6395302..a76992d 100644
--- a/docs/1.1/deployment/resource-limitation/index.html
+++ b/docs/1.1/deployment/resource-limitation/index.html
@@ -21,19 +21,19 @@
     <title>Limiting Resource Usage :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/resource-limitation/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/resource-limitation/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/resource-limitation/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/resource-limitation/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/resource-limitation/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/resource-limitation/">dev</option>
@@ -2426,20 +2452,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/dev-guide/building_hono/index.html b/docs/1.1/dev-guide/building_hono/index.html
index e1289b0..ef51692 100644
--- a/docs/1.1/dev-guide/building_hono/index.html
+++ b/docs/1.1/dev-guide/building_hono/index.html
@@ -21,19 +21,19 @@
     <title>Building from Source :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/dev-guide/building_hono/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/dev-guide/building_hono/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/building_hono/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/dev-guide/building_hono/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/dev-guide/building_hono/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/dev-guide/building_hono/">dev</option>
@@ -2405,20 +2431,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/dev-guide/custom_http_adapter/index.html b/docs/1.1/dev-guide/custom_http_adapter/index.html
index 6b16ca0..504b0ff 100644
--- a/docs/1.1/dev-guide/custom_http_adapter/index.html
+++ b/docs/1.1/dev-guide/custom_http_adapter/index.html
@@ -21,19 +21,19 @@
     <title>Implement a Custom Hono HTTP Protocol Adapter :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/dev-guide/custom_http_adapter/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/dev-guide/custom_http_adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/custom_http_adapter/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/dev-guide/custom_http_adapter/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/dev-guide/custom_http_adapter/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/dev-guide/custom_http_adapter/">dev</option>
@@ -2453,20 +2479,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/dev-guide/index.html b/docs/1.1/dev-guide/index.html
index 537ca2d..50fac07 100644
--- a/docs/1.1/dev-guide/index.html
+++ b/docs/1.1/dev-guide/index.html
@@ -21,19 +21,19 @@
     <title>Developer Guide :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/dev-guide/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/dev-guide/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/dev-guide/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/dev-guide/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/dev-guide/">dev</option>
@@ -2321,20 +2347,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/dev-guide/java_client_consumer/index.html b/docs/1.1/dev-guide/java_client_consumer/index.html
index e4af7ae..6fe7289 100644
--- a/docs/1.1/dev-guide/java_client_consumer/index.html
+++ b/docs/1.1/dev-guide/java_client_consumer/index.html
@@ -21,19 +21,19 @@
     <title>Consuming Messages from Java :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/dev-guide/java_client_consumer/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/dev-guide/java_client_consumer/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/java_client_consumer/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/dev-guide/java_client_consumer/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/dev-guide/java_client_consumer/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/dev-guide/java_client_consumer/">dev</option>
@@ -2423,20 +2449,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/index.html b/docs/1.1/index.html
index d23b12a..2177240 100644
--- a/docs/1.1/index.html
+++ b/docs/1.1/index.html
@@ -21,19 +21,19 @@
     <title>Documentation :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/">dev</option>
@@ -2273,20 +2299,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/sitemap.xml b/docs/1.1/sitemap.xml
index ce9c427..14e3ab2 100644
--- a/docs/1.1/sitemap.xml
+++ b/docs/1.1/sitemap.xml
@@ -11,6 +11,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/"
                 />
@@ -35,6 +40,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/concepts/"
                 />
@@ -59,6 +69,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/device-identity/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/concepts/device-identity/"
                 />
@@ -78,8 +93,8 @@
     <loc>https://www.eclipse.org/hono/docs/1.1/concepts/tenancy/</loc>
     <xhtml:link
                 rel="alternate"
-                hreflang="stable"
-                href="https://www.eclipse.org/hono/docs/concepts/tenancy/"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/tenancy/"
                 />
     <xhtml:link
                 rel="alternate"
@@ -102,6 +117,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/device-provisioning/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="dev"
                 href="https://www.eclipse.org/hono/docs/dev/concepts/device-provisioning/"
                 />
@@ -121,6 +141,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/connecting-devices/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="dev"
                 href="https://www.eclipse.org/hono/docs/dev/concepts/connecting-devices/"
                 />
@@ -135,8 +160,8 @@
     <loc>https://www.eclipse.org/hono/docs/1.1/concepts/device-notifications/</loc>
     <xhtml:link
                 rel="alternate"
-                hreflang="stable"
-                href="https://www.eclipse.org/hono/docs/concepts/device-notifications/"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/device-notifications/"
                 />
     <xhtml:link
                 rel="alternate"
@@ -154,8 +179,8 @@
     <loc>https://www.eclipse.org/hono/docs/1.1/concepts/command-and-control/</loc>
     <xhtml:link
                 rel="alternate"
-                hreflang="stable"
-                href="https://www.eclipse.org/hono/docs/concepts/command-and-control/"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/command-and-control/"
                 />
     <xhtml:link
                 rel="alternate"
@@ -178,6 +203,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/resource-limits/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/concepts/resource-limits/"
                 />
@@ -202,6 +232,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/connection-events/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/concepts/connection-events/"
                 />
@@ -226,6 +261,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/user-guide/"
                 />
@@ -245,8 +285,8 @@
     <loc>https://www.eclipse.org/hono/docs/1.1/user-guide/device-registry/</loc>
     <xhtml:link
                 rel="alternate"
-                hreflang="stable"
-                href="https://www.eclipse.org/hono/docs/user-guide/device-registry/"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/device-registry/"
                 />
     <xhtml:link
                 rel="alternate"
@@ -269,6 +309,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/http-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/user-guide/http-adapter/"
                 />
@@ -293,6 +338,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/mqtt-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/user-guide/mqtt-adapter/"
                 />
@@ -317,6 +367,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/amqp-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/user-guide/amqp-adapter/"
                 />
@@ -341,6 +396,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/kura-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/user-guide/kura-adapter/"
                 />
@@ -365,6 +425,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/sigfox-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/user-guide/sigfox-adapter/"
                 />
@@ -389,6 +454,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/jmeter_load_tests/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/user-guide/jmeter_load_tests/"
                 />
@@ -413,6 +483,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/admin-guide/"
                 />
@@ -437,6 +512,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/common-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/admin-guide/common-config/"
                 />
@@ -461,6 +541,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/auth-server-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/admin-guide/auth-server-config/"
                 />
@@ -480,8 +565,8 @@
     <loc>https://www.eclipse.org/hono/docs/1.1/admin-guide/device-registry-config/</loc>
     <xhtml:link
                 rel="alternate"
-                hreflang="stable"
-                href="https://www.eclipse.org/hono/docs/admin-guide/device-registry-config/"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/device-registry-config/"
                 />
     <xhtml:link
                 rel="alternate"
@@ -504,6 +589,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/device-connection-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/admin-guide/device-connection-config/"
                 />
@@ -528,6 +618,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/http-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/admin-guide/http-adapter-config/"
                 />
@@ -552,6 +647,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/admin-guide/amqp-adapter-config/"
                 />
@@ -576,6 +676,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/mqtt-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/admin-guide/mqtt-adapter-config/"
                 />
@@ -600,6 +705,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/kura-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/admin-guide/kura-adapter-config/"
                 />
@@ -624,6 +734,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/hono-client-configuration/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/admin-guide/hono-client-configuration/"
                 />
@@ -648,6 +763,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-network-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/admin-guide/amqp-network-config/"
                 />
@@ -672,6 +792,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/secure_communication/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/admin-guide/secure_communication/"
                 />
@@ -696,6 +821,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/monitoring-tracing-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/admin-guide/monitoring-tracing-config/"
                 />
@@ -720,6 +850,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/dev-guide/"
                 />
@@ -744,6 +879,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/building_hono/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/dev-guide/building_hono/"
                 />
@@ -768,6 +908,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/java_client_consumer/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/dev-guide/java_client_consumer/"
                 />
@@ -792,6 +937,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/custom_http_adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/dev-guide/custom_http_adapter/"
                 />
@@ -816,6 +966,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/api/"
                 />
@@ -840,6 +995,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/telemetry/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/api/telemetry/"
                 />
@@ -864,6 +1024,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/event/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/api/event/"
                 />
@@ -888,6 +1053,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/command-and-control/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/api/command-and-control/"
                 />
@@ -912,6 +1082,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/tenant/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/api/tenant/"
                 />
@@ -936,6 +1111,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/device-connection/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/api/device-connection/"
                 />
@@ -960,6 +1140,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/device-registration/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/api/device-registration/"
                 />
@@ -984,6 +1169,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/credentials/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/api/credentials/"
                 />
@@ -1008,6 +1198,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/authentication/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/api/authentication/"
                 />
@@ -1032,6 +1227,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/management/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/api/management/"
                 />
@@ -1056,6 +1256,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/metrics/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/api/metrics/"
                 />
@@ -1080,6 +1285,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/deployment/"
                 />
@@ -1104,6 +1314,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/helm-based-deployment/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/deployment/helm-based-deployment/"
                 />
@@ -1128,6 +1343,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/openshift/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/deployment/openshift/"
                 />
@@ -1152,6 +1372,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/create-kubernetes-cluster/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/deployment/create-kubernetes-cluster/"
                 />
@@ -1176,6 +1401,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/resource-limitation/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/deployment/resource-limitation/"
                 />
@@ -1200,6 +1430,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/architecture/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/architecture/"
                 />
@@ -1224,6 +1459,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/architecture/component-view/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/architecture/component-view/"
                 />
@@ -1248,6 +1488,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/architecture/auth/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/architecture/auth/"
                 />
@@ -1273,6 +1518,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/categories/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/categories/"
                 />
@@ -1298,6 +1548,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/tags/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.0"
                 href="https://www.eclipse.org/hono/docs/1.0/tags/"
                 />
diff --git a/docs/1.1/tags/index.html b/docs/1.1/tags/index.html
index 65bb436..8bb8079 100644
--- a/docs/1.1/tags/index.html
+++ b/docs/1.1/tags/index.html
@@ -21,19 +21,19 @@
     <title>Tags :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/tags/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/tags/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/tags/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/tags/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/tags/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/tags/">dev</option>
@@ -2302,20 +2328,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/user-guide/amqp-adapter/index.html b/docs/1.1/user-guide/amqp-adapter/index.html
index 5bdb265..bd4e3af 100644
--- a/docs/1.1/user-guide/amqp-adapter/index.html
+++ b/docs/1.1/user-guide/amqp-adapter/index.html
@@ -21,19 +21,19 @@
     <title>AMQP Adapter :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/amqp-adapter/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/amqp-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/amqp-adapter/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/amqp-adapter/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/amqp-adapter/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/amqp-adapter/">dev</option>
@@ -2956,20 +2982,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/user-guide/device-registry/index.html b/docs/1.1/user-guide/device-registry/index.html
index ff4656d..565b8d0 100644
--- a/docs/1.1/user-guide/device-registry/index.html
+++ b/docs/1.1/user-guide/device-registry/index.html
@@ -21,19 +21,19 @@
     <title>Device Registry :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1237,9 +1237,11 @@
               
               
                   
+              
+                  
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/device-registry/">stable (1.2)</option>
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/device-registry/">1.2</option>
                     
                   
               
@@ -1255,6 +1257,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/device-registry/" selected>1.1</option>
@@ -1273,6 +1277,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/device-registry/">1.0</option>
@@ -2842,20 +2848,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/user-guide/http-adapter/index.html b/docs/1.1/user-guide/http-adapter/index.html
index b7b2bf2..0d3f9b4 100644
--- a/docs/1.1/user-guide/http-adapter/index.html
+++ b/docs/1.1/user-guide/http-adapter/index.html
@@ -21,19 +21,19 @@
     <title>HTTP Adapter :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/http-adapter/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/http-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/http-adapter/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/http-adapter/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/http-adapter/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/http-adapter/">dev</option>
@@ -3191,20 +3217,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/user-guide/index.html b/docs/1.1/user-guide/index.html
index d5fb527..5fb0e86 100644
--- a/docs/1.1/user-guide/index.html
+++ b/docs/1.1/user-guide/index.html
@@ -21,19 +21,19 @@
     <title>User Guide :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/">dev</option>
@@ -2321,20 +2347,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/user-guide/jmeter_load_tests/index.html b/docs/1.1/user-guide/jmeter_load_tests/index.html
index a0a0c01..6c3a72f 100644
--- a/docs/1.1/user-guide/jmeter_load_tests/index.html
+++ b/docs/1.1/user-guide/jmeter_load_tests/index.html
@@ -21,19 +21,19 @@
     <title>Load Tests with JMeter :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/jmeter_load_tests/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/jmeter_load_tests/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/jmeter_load_tests/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/jmeter_load_tests/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/jmeter_load_tests/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/jmeter_load_tests/">dev</option>
@@ -2372,20 +2398,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/user-guide/kura-adapter/index.html b/docs/1.1/user-guide/kura-adapter/index.html
index 16fd3df..3ce1e04 100644
--- a/docs/1.1/user-guide/kura-adapter/index.html
+++ b/docs/1.1/user-guide/kura-adapter/index.html
@@ -21,19 +21,19 @@
     <title>Kura Adapter :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/kura-adapter/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/kura-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/kura-adapter/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/kura-adapter/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/kura-adapter/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/kura-adapter/">dev</option>
@@ -2447,20 +2473,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/user-guide/mqtt-adapter/index.html b/docs/1.1/user-guide/mqtt-adapter/index.html
index b3ff453..3072bf7 100644
--- a/docs/1.1/user-guide/mqtt-adapter/index.html
+++ b/docs/1.1/user-guide/mqtt-adapter/index.html
@@ -21,19 +21,19 @@
     <title>MQTT Adapter :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/mqtt-adapter/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/mqtt-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/mqtt-adapter/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/mqtt-adapter/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/mqtt-adapter/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/mqtt-adapter/">dev</option>
@@ -2881,20 +2907,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.1/user-guide/sigfox-adapter/index.html b/docs/1.1/user-guide/sigfox-adapter/index.html
index b6737dc..c8cc517 100644
--- a/docs/1.1/user-guide/sigfox-adapter/index.html
+++ b/docs/1.1/user-guide/sigfox-adapter/index.html
@@ -21,19 +21,19 @@
     <title>Sigfox Adapter :: Eclipse Hono&trade; Vers.: 1.1</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.1";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -1239,7 +1239,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/sigfox-adapter/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/sigfox-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/sigfox-adapter/">1.2</option>
                     
                   
               
@@ -1255,6 +1275,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/sigfox-adapter/" selected>1.1</option>
@@ -1273,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/sigfox-adapter/">1.0</option>
@@ -1291,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/sigfox-adapter/">dev</option>
@@ -2490,20 +2516,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.2/404.html b/docs/1.2/404.html
new file mode 100644
index 0000000..a63072b
--- /dev/null
+++ b/docs/1.2/404.html
@@ -0,0 +1,88 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+
+<head>
+  <meta charset="utf-8"> <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+ <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+ 
+  <title>404 Page not found</title>
+  
+   
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/horsey.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+<style type="text/css">
+    :root #header + #content > #left > #rlblock_left {
+      display: none !important;
+    }
+
+    p,
+    li,
+    ul {
+      text-align: center
+    }
+
+    ul {
+      list-style-type: none;
+    }
+</style>
+
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="404 Page not found :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="404 Page not found :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="/" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+</head>
+
+<body>
+
+  <body class="" data-url="/">
+
+    <section id="body" style="margin-left:0px;">
+      <div id="overlay"></div>
+      <div id="chapter">
+        <div id="body-inner">
+          <h1>Error</h1>
+          <p>
+          </p>
+          <p>Woops. Looks like this page doesn&#39;t exist ¯\_(ツ)_/¯.</p>
+          <p></p>
+          <p><a href='/hono/docs/1.2/'>Go to homepage</a></p>
+          <p><img src='/hono/docs/images/gopher-404.jpg' style="width:50%" alt="Page not found!"></img></p>
+        </div>
+      </div>
+
+    </section>
+  </body>
+
+</html>
diff --git a/docs/1.2/admin-guide/amqp-adapter-config/index.html b/docs/1.2/admin-guide/amqp-adapter-config/index.html
new file mode 100644
index 0000000..85e359a
--- /dev/null
+++ b/docs/1.2/admin-guide/amqp-adapter-config/index.html
@@ -0,0 +1,2709 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>AMQP Adapter Configuration :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="AMQP Adapter Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="AMQP Adapter Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-adapter-config//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item active">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/admin-guide/amqp-adapter-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/amqp-adapter-config/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/admin-guide/amqp-adapter-config/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/admin-guide/amqp-adapter-config/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/admin-guide/amqp-adapter-config/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/admin-guide/amqp-adapter-config.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/admin-guide/'>Admin Guide</a> > AMQP Adapter Configuration
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#service-configuration">Service Configuration</a></li>
+<li><a href="#port-configuration">Port Configuration</a>
+<ul>
+<li><a href="#secure-port-only">Secure Port Only</a></li>
+<li><a href="#insecure-port-only">Insecure Port Only</a></li>
+<li><a href="#dual-port">Dual Port</a></li>
+<li><a href="#ephemeral-ports">Ephemeral Ports</a></li>
+</ul></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>AMQP Adapter Configuration</h1>
+          
+
+        
+
+
+<p>The AMQP protocol adapter allows clients (devices and gateway components) that speaks AMQP 1.0 to publish telemetry messages and events to Eclipse Hono&trade;&rsquo;s Telemetry and Event endpoints.</p>
+
+<p>The adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding <a href="https://hub.docker.com/r/eclipse/hono-adapter-amqp-vertx/">Docker image</a> created from it.</p>
+
+<p>The adapter supports the following standard configuration options:</p>
+
+<ul>
+<li><a href="/hono/docs/1.2/admin-guide/common-config/#java-vm-options">Common Java VM Options</a></li>
+<li><a href="/hono/docs/1.2/admin-guide/common-config/#vert-x-options">Common vert.x Options</a></li>
+<li><a href="/hono/docs/1.2/admin-guide/common-config/#protocol-adapter-options">Common Protocol Adapter Options</a></li>
+<li><a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">Monitoring Options</a></li>
+</ul>
+
+<h2 id="service-configuration">Service Configuration</h2>
+
+<p>The following table provides an overview of the configuration variables and corresponding command line options for configuring the AMQP adapter.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="center">Mandatory</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>HONO_AMQP_AUTHENTICATION_REQUIRED</code><br><code>--hono.amqp.authenticationRequired</code></td>
+<td align="center">no</td>
+<td align="left"><code>true</code></td>
+<td align="left">If set to <code>true</code> the protocol adapter requires devices to authenticate when connecting to the adapter. The credentials provided by the device are verified using the configured <a href="#credentials-service-connection-configuration">Credentials Service</a>. Devices that have failed to authenticate are not allowed to publish any data.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AMQP_BIND_ADDRESS</code><br><code>--hono.amqp.bindAddress</code></td>
+<td align="center">no</td>
+<td align="left"><code>127.0.0.1</code></td>
+<td align="left">The IP address of the network interface that the secure port should be bound to.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AMQP_CERT_PATH</code><br><code>--hono.amqp.certPath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the PEM file containing the certificate that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with <code>HONO_AMQP_KEY_PATH</code>.<br>Alternatively, the <code>HONO_AMQP_KEY_STORE_PATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AMQP_DEFAULTS_ENABLED</code><br><code>--hono.amqp.defaultsEnabled</code></td>
+<td align="center">no</td>
+<td align="left"><code>true</code></td>
+<td align="left">If set to <code>true</code> the protocol adapter uses <em>default values</em> registered for a device to augment messages published by the device with missing information like a content type. In particular, the protocol adapter adds default values registered for the device as (application) properties with the same name to the AMQP 1.0 messages it sends downstream to the AMQP Messaging Network.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AMQP_IDLE_TIMEOUT</code><br><code>--hono.amqp.idleTimeout</code></td>
+<td align="center">no</td>
+<td align="left"><code>60000</code></td>
+<td align="left">The time interval (milliseconds) to wait for incoming traffic from a device before the connection should be considered stale and thus be closed. Setting this property to <code>0</code> prevents the adapter from detecting and closing stale connections.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AMQP_INSECURE_PORT_BIND_ADDRESS</code><br><code>--hono.amqp.insecurePortBindAddress</code></td>
+<td align="center">no</td>
+<td align="left"><code>127.0.0.1</code></td>
+<td align="left">The IP address of the network interface that the insecure port should be bound to.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AMQP_INSECURE_PORT</code><br><code>--hono.amqp.insecurePort</code></td>
+<td align="center">no</td>
+<td align="left"><code>5672</code></td>
+<td align="left">The port number that the protocol adapter should listen on for insecure connections.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AMQP_INSECURE_PORT_ENABLED</code><br><code>--hono.amqp.insecurePortEnabled</code></td>
+<td align="center">no</td>
+<td align="left"><code>false</code></td>
+<td align="left">If set to <code>true</code> the protocol adapter will open an insecure port (not secured by TLS) using either the port number set via <code>HONO_AMQP_INSECURE_PORT</code> or the default AMQP port number (<code>1883</code>) if not set explicitly.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AMQP_KEY_PATH</code><br><code>--hono.amqp.keyPath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the (PKCS8) PEM file containing the private key that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with <code>HONO_AMQP_CERT_PATH</code>. Alternatively, the <code>HONO_AMQP_KEY_STORE_PATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AMQP_KEY_STORE_PASSWORD</code><br><code>--hono.amqp.keyStorePassword</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The password required to read the contents of the key store.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AMQP_KEY_STORE_PATH</code><br><code>--hono.amqp.keyStorePath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the Java key store containing the private key and certificate that the protocol adapter should use for authenticating to clients. Either this option or the <code>HONO_AMQP_KEY_PATH</code> and <code>HONO_AMQP_CERT_PATH</code> options need to be set in order to enable TLS secured connections with clients. The key store format can be either <code>JKS</code> or <code>PKCS12</code> indicated by a <code>.jks</code> or <code>.p12</code> file suffix respectively.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AMQP_SNI</code><br><code>--hono.amqp.sni</code></td>
+<td align="center">no</td>
+<td align="left"><code>false</code></td>
+<td align="left">Set whether the server supports Server Name Indication. By default, the server will not support SNI and the option is <code>false</code>. However, if set to <code>true</code> then the key store format, <code>HONO_AMQP_KEY_STORE_PATH</code>,  should be either <code>JKS</code> or <code>PKCS12</code> indicated by a <code>.jks</code> or <code>.p12</code> file suffix respectively.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AMQP_MAX_CONNECTIONS</code><br><code>--hono.amqp.maxConnections</code></td>
+<td align="center">no</td>
+<td align="left"><code>0</code></td>
+<td align="left">The maximum number of concurrent connections that the protocol adapter should accept. If not set (or set to <code>0</code>), the protocol adapter determines a reasonable value based on the available resources like memory and CPU.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AMQP_MAX_FRAME_SIZE</code><br><code>--hono.amqp.maxFrameSize</code></td>
+<td align="center">no</td>
+<td align="left"><code>16384</code></td>
+<td align="left">The maximum number of bytes that can be sent in an AMQP message delivery over the connection with a device. When a client sends an AMQP frame of larger size, the connection is closed.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AMQP_MAX_PAYLOAD_SIZE</code><br><code>--hono.amqp.maxPayloadSize</code></td>
+<td align="center">no</td>
+<td align="left"><code>2048</code></td>
+<td align="left">The maximum allowed size of an incoming AMQP message in bytes. When a client sends a message with a larger payload, the message is discarded and the link to the client is closed.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AMQP_MAX_SESSION_FRAMES</code><br><code>--hono.amqp.maxSessionFrames</code></td>
+<td align="center">no</td>
+<td align="left"><code>30</code></td>
+<td align="left">The maximum number of AMQP transfer frames for sessions created on this connection. This is the number of transfer frames that may simultaneously be in flight for all links in the session.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AMQP_NATIVE_TLS_REQUIRED</code><br><code>--hono.amqp.nativeTlsRequired</code></td>
+<td align="center">no</td>
+<td align="left"><code>false</code></td>
+<td align="left">The server will probe for OpenSSL on startup if a secure port is configured. By default, the server will fall back to the JVM&rsquo;s default SSL engine if not available. However, if set to <code>true</code>, the server will fail to start at all in this case.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AMQP_PORT</code><br><code>--hono.amqp.port</code></td>
+<td align="center">no</td>
+<td align="left"><code>5671</code></td>
+<td align="left">The secure port that the protocol adapter should listen on.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AMQP_SECURE_PROTOCOLS</code><br><code>--hono.amqp.secureProtocols</code></td>
+<td align="center">no</td>
+<td align="left"><code>TLSv1.2</code></td>
+<td align="left">A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the <a href="https://vertx.io/docs/vertx-core/java/#ssl">vert.x documentation</a> for a list of supported protocol names.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AMQP_TENANT_IDLE_TIMEOUT</code><br><code>--hono.amqp.tenantIdleTimeout</code></td>
+<td align="center">no</td>
+<td align="left"><code>0ms</code></td>
+<td align="left">The duration after which the protocol adapter removes local state of the tenant (e.g. open AMQP links) with an amount and a unit, e.g. <code>2h</code> for 2 hours. See the <a href="https://docs.spring.io/spring-boot/docs/current/reference/html/spring-boot-features.html#boot-features-external-config-conversion-duration">Spring Boot documentation</a> for an explanation of the format. The value <code>0ms</code> disables the timeout.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_APP_MAX_INSTANCES</code><br><code>--hono.app.maxInstances</code></td>
+<td align="center">no</td>
+<td align="left"><em>#CPU cores</em></td>
+<td align="left">The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The variables only need to be set if the default values do not match your environment.</p>
+
+<h2 id="port-configuration">Port Configuration</h2>
+
+<p>The AMQP protocol adapter can be configured to listen for connections on</p>
+
+<ul>
+<li>a secure port only (default) or</li>
+<li>an insecure port only or</li>
+<li>both a secure and an insecure port (dual port configuration)</li>
+</ul>
+
+<p>The AMQP protocol adapter will fail to start if none of the ports is configured properly.</p>
+
+<h3 id="secure-port-only">Secure Port Only</h3>
+
+<p>The protocol adapter needs to be configured with a private key and certificate in order to open a TLS secured port.</p>
+
+<p>There are two alternative ways for doing so:</p>
+
+<ol>
+<li>either setting the <code>HONO_AMQP_KEY_STORE_PATH</code> and the <code>HONO_AMQP_KEY_STORE_PASSWORD</code> variables in order to load the key &amp; certificate from a password protected key store, or</li>
+<li>setting the <code>HONO_AMQP_KEY_PATH</code> and <code>HONO_AMQP_CERT_PATH</code> variables in order to load the key and certificate from two separate PEM files in PKCS8 format.</li>
+</ol>
+
+<p>When starting up, the protocol adapter will bind a TLS secured socket to the default secure port 5671. The port number can also be set explicitly using the <code>HONO_AMQP_PORT</code> variable.</p>
+
+<p>The <code>HONO_AMQP_BIND_ADDRESS</code> variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the <em>loopback device</em> only, i.e. the port will only be accessible from the local host. Setting this variable to <code>0.0.0.0</code> will let the port being bound to <strong>all</strong> network interfaces (be careful not to expose the port unintentionally to the outside world).</p>
+
+<h3 id="insecure-port-only">Insecure Port Only</h3>
+
+<p>The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by</p>
+
+<ul>
+<li>explicitly setting <code>HONO_AMQP_INSECURE_PORT</code> to a valid port number, or by</li>
+<li>implicitly configuring the default adapter port (5672) by simply setting <code>HONO_AMQP_INSECURE_PORT_ENABLED</code> to <code>true</code>.</li>
+</ul>
+
+<p>The protocol adapter issues a warning on the console if <code>HONO_AMQP_INSECURE_PORT</code> is set to the default secure port (5671) used by the adapter for secure connections.</p>
+
+<p>The <code>HONO_AMQP_INSECURE_PORT_BIND_ADDRESS</code> variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the <em>loopback device</em> only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.</p>
+
+<p>Setting this variable to <code>0.0.0.0</code> will let the port being bound to <strong>all</strong> network interfaces (be careful not to expose the port unintentionally to the outside world).</p>
+
+<h3 id="dual-port">Dual Port</h3>
+
+<p>The protocol adapter may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.</p>
+
+<h3 id="ephemeral-ports">Ephemeral Ports</h3>
+
+<p>Both the secure as well as the insecure port numbers may be explicitly set to <code>0</code>. The protocol adapter will then use arbitrary (unused) port numbers determined by the operating system during startup.</p>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/admin-guide/amqp-network-config/index.html b/docs/1.2/admin-guide/amqp-network-config/index.html
new file mode 100644
index 0000000..26905cc
--- /dev/null
+++ b/docs/1.2/admin-guide/amqp-network-config/index.html
@@ -0,0 +1,2490 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>AMQP 1.0 Messaging Network Configuration :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="AMQP 1.0 Messaging Network Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="AMQP 1.0 Messaging Network Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-network-config//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/admin-guide/amqp-network-config/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item active">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/admin-guide/amqp-network-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/amqp-network-config/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/admin-guide/amqp-network-config/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/admin-guide/amqp-network-config/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/admin-guide/amqp-network-config/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/admin-guide/amqp-network-config.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/admin-guide/'>Admin Guide</a> > AMQP 1.0 Messaging Network Configuration
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#dispatch-router-configuration">Dispatch Router Configuration</a></li>
+<li><a href="#artemis-broker-configuration">Artemis Broker Configuration</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>AMQP 1.0 Messaging Network Configuration</h1>
+          
+
+        
+
+
+<p>The <em>Qpid Dispatch Router</em>, together with the <em>Apache Artemis</em> message broker, serves as the default <em>AMQP 1.0 Messaging Network</em> that is used in Hono&rsquo;s example deployment as described in the <a href="/hono/docs/1.2/deployment/">Deployment Guides</a>.</p>
+
+<p>The Dispatch Router component exposes service endpoints implementing the <em>north bound</em> part of Hono&rsquo;s <a href="/hono/docs/1.2/api/telemetry/">Telemetry</a>, <a href="/hono/docs/1.2/api/event/">Event</a> and <a href="/hono/docs/1.2/api/command-and-control/">Command &amp; Control</a> APIs which are used by applications to interact with devices.</p>
+
+<h2 id="dispatch-router-configuration">Dispatch Router Configuration</h2>
+
+<p>The Dispatch Router is part of the <a href="https://qpid.apache.org">Apache Qpid project</a>. Hono uses Dispatch Router by means of the <a href="https://enmasse.io">EnMasse</a> project&rsquo;s <a href="https://quay.io/repository/enmasse/qdrouterd-base">Dispatch Router Docker image</a> created from the Qpid project source code.</p>
+
+<p>The Dispatch Router can be configured by means of configuration files. Hono includes an example configuration in the <code>deploy/src/main/config/qpid</code> folder which is used by the example deployment scripts. Please refer to the <a href="https://qpid.apache.org/components/dispatch-router/index.html">Dispatch Router documentation</a> for details regarding the configuration file format and options.</p>
+
+<h2 id="artemis-broker-configuration">Artemis Broker Configuration</h2>
+
+<p>The Artemis Broker is part of the <a href="https://activemq.apache.org">Apache ActiveMQ project</a>. Hono uses Artemis by means of the <a href="https://enmasse.io">EnMasse</a> project&rsquo;s <a href="https://hub.docker.com/r/enmasseproject/activemq-artemis">Artemis Docker image</a> created from the Artemis project source code.</p>
+
+<p>The Artemis Broker can be configured by means of configuration files. Hono includes an example configuration in the <code>deploy/src/main/config/artemis</code> folder which is used by the example deployment scripts. Please refer to the <a href="https://activemq.apache.org/components/artemis/documentation/">Artemis documentation</a> for details regarding the configuration file format and options.</p>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/admin-guide/auth-server-config/index.html b/docs/1.2/admin-guide/auth-server-config/index.html
new file mode 100644
index 0000000..98efc24
--- /dev/null
+++ b/docs/1.2/admin-guide/auth-server-config/index.html
@@ -0,0 +1,2703 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Auth Server Configuration :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Auth Server Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Auth Server Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/admin-guide/auth-server-config//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/admin-guide/auth-server-config/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item active">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/admin-guide/auth-server-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/auth-server-config/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/admin-guide/auth-server-config/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/admin-guide/auth-server-config/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/admin-guide/auth-server-config/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/admin-guide/auth-server-config.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/admin-guide/'>Admin Guide</a> > Auth Server Configuration
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#service-configuration">Service Configuration</a></li>
+<li><a href="#port-configuration">Port Configuration</a>
+<ul>
+<li><a href="#secure-port-only">Secure Port Only</a></li>
+<li><a href="#insecure-port-only">Insecure Port Only</a></li>
+<li><a href="#dual-port">Dual Port</a></li>
+<li><a href="#ephemeral-ports">Ephemeral Ports</a></li>
+</ul></li>
+<li><a href="#metrics-configuration">Metrics Configuration</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Auth Server Configuration</h1>
+          
+
+        
+
+
+<p>The Auth Server component exposes a service endpoint implementing Eclipse Hono&trade;&rsquo;s <a href="/hono/docs/1.2/api/authentication/">Authentication</a> API. Other services use this component for authenticating clients and retrieving a token asserting the client&rsquo;s identity and corresponding authorities.</p>
+
+<p>This component serves as a default implementation of the <em>Authentication</em> API only. On startup, it reads in all identities and their authorities from a JSON file from the file system. All data is then kept in memory and there are no remote service APIs for managing the identities and their authorities.</p>
+
+<p>The Auth Server is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding <a href="https://hub.docker.com/r/eclipse/hono-service-auth/">Docker image</a> created from it.</p>
+
+<h2 id="service-configuration">Service Configuration</h2>
+
+<p>In addition to the following options, this component supports the options described in <a href="/hono/docs/1.2/admin-guide/common-config/">Common Configuration</a>.</p>
+
+<p>The server can be configured by means of environment variables or corresponding command line options.
+The following table provides an overview of the configuration variables and corresponding command line options that the server supports:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="center">Mandatory</th>
+<th align="left">Default</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>HONO_APP_MAX_INSTANCES</code><br><code>--hono.app.maxInstances</code></td>
+<td align="center">no</td>
+<td align="left"><em>#CPU cores</em></td>
+<td align="left">The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AUTH_AMQP_BIND_ADDRESS</code><br><code>--hono.auth.amqp.bindAddress</code></td>
+<td align="center">no</td>
+<td align="left"><code>127.0.0.1</code></td>
+<td align="left">The IP address of the network interface that the secure port should be bound to.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AUTH_AMQP_CERT_PATH</code><br><code>--hono.auth.amqp.certPath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the PEM file containing the certificate that the server should use for authenticating to clients. This option must be used in conjunction with <code>HONO_AUTH_AMQP_KEY_PATH</code>.<br>Alternatively, the <code>HONO_AUTH_AMQP_KEY_STORE_PATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AUTH_AMQP_INSECURE_PORT</code><br><code>--hono.auth.amqp.insecurePort</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The insecure port the server should listen on.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AUTH_AMQP_INSECURE_PORT_BIND_ADDRESS</code><br><code>--hono.auth.amqp.insecurePortBindAddress</code></td>
+<td align="center">no</td>
+<td align="left"><code>127.0.0.1</code></td>
+<td align="left">The IP address of the network interface that the insecure port should be bound to.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AUTH_AMQP_INSECURE_PORT_ENABLED</code><br><code>--hono.auth.amqp.insecurePortEnabled</code></td>
+<td align="center">no</td>
+<td align="left"><code>false</code></td>
+<td align="left">If set to <code>true</code> the server will open an insecure port (not secured by TLS) using either the port number set via <code>HONO_AUTH_AMQP_INSECURE_PORT</code> or the default AMQP port number (<code>5672</code>) if not set explicitly.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AUTH_AMQP_KEY_PATH</code><br><code>--hono.auth.amqp.keyPath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the (PKCS8) PEM file containing the private key that the server should use for authenticating to clients. Note that the private key is not protected by a password. You should therefore make sure that the key file can only be read by the user that the server process is running under. This option must be used in conjunction with <code>HONO_AUTH_CERT_PATH</code>.<br>Alternatively, the <code>HONO_AUTH_KEY_STORE_PATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AUTH_AMQP_KEY_STORE_PASSWORD</code><br><code>--hono.auth.amqp.keyStorePassword</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The password required to read the contents of the key store.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AUTH_AMQP_KEY_STORE_PATH</code><br><code>--hono.auth.amqp.keyStorePath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the Java key store containing the private key and certificate that the server should use for authenticating to clients. Either this option or the <code>HONO_AUTH_AMQP_KEY_PATH</code> and <code>HONO_AUTH_AMQP_CERT_PATH</code> options need to be set in order to enable TLS secured connections with clients. The key store format can be either <code>JKS</code> or <code>PKCS12</code> indicated by a <code>.jks</code> or <code>.p12</code> file suffix respectively.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AUTH_AMQP_NATIVE_TLS_REQUIRED</code><br><code>--hono.auth.amqp.nativeTlsRequired</code></td>
+<td align="center">no</td>
+<td align="left"><code>false</code></td>
+<td align="left">The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM&rsquo;s default SSL engine if not available. However, if set to <code>true</code>, the server will fail to start at all in this case.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AUTH_AMQP_PORT</code><br><code>--hono.auth.amqp.port</code></td>
+<td align="center">no</td>
+<td align="left"><code>5671</code></td>
+<td align="left">The secure port that the server should listen on.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AUTH_AMQP_SECURE_PROTOCOLS</code><br><code>--hono.auth.amqp.secureProtocols</code></td>
+<td align="center">no</td>
+<td align="left"><code>TLSv1.2</code></td>
+<td align="left">A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the <a href="https://vertx.io/docs/vertx-core/java/#ssl">vert.x documentation</a> for a list of supported protocol names.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AUTH_AMQP_TRUST_STORE_PASSWORD</code><br><code>--hono.auth.amqp.trustStorePassword</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The password required to read the contents of the trust store.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AUTH_AMQP_TRUST_STORE_PATH</code><br><code>--hono.auth.amqp.trustStorePath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the Java key store containing the CA certificates the service uses for authenticating clients. The key store format can be either <code>JKS</code>, <code>PKCS12</code> or <code>PEM</code> indicated by a <code>.jks</code>, <code>.p12</code> or <code>.pem</code> file suffix respectively.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AUTH_SVC_PERMISSIONS_PATH</code><br><code>--hono.auth.svc.permissionsPath</code></td>
+<td align="center">no</td>
+<td align="left"><code>classpath:/</code><br><code>permissions.json</code></td>
+<td align="left">The Spring resource URI of the JSON file defining the identities and corresponding authorities on Hono&rsquo;s endpoint resources. The default file bundled with the Auth Server defines authorities required by protocol adapters and downstream consumer. The default permissions file should <strong>only be used for evaluation purposes</strong>.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AUTH_SVC_SIGNING_KEY_PATH</code><br><code>--hono.auth.svc.signing.keyPath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the (PKCS8) PEM file containing the private key that the server should use for signing tokens asserting an authenticated client&rsquo;s identity and authorities. When using this variable, other services that need to validate the tokens issued by this service need to be configured with the corresponding certificate/public key. Alternatively, a symmetric key can be used for signing (and validating) by setting the <code>HONO_AUTH_SVC_SIGNING_SHARED_SECRET</code> variable. If none of these variables is set, the server falls back to the key indicated by the <code>HONO_AUTH_AMQP_KEY_PATH</code> variable. If that variable is also not set, startup of the server fails.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AUTH_SVC_SIGNING_SHARED_SECRET</code><br><code>--hono.auth.svc.signing.sharedSecret</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">A string to derive a symmetric key from that is used for signing tokens asserting an authenticated client&rsquo;s identity and authorities. The key is derived from the string by using the bytes of the String&rsquo;s UTF8 encoding. When setting the signing key using this variable, other services that need to validate the tokens issued by this service need to be configured with the same key. Alternatively, an asymmetric key pair can be used for signing (and validating) by setting the <code>HONO_AUTH_SVC_SIGNING_KEY_PATH</code> variable. If none of these variables is set, startup of the server fails.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AUTH_SVC_SIGNING_TOKEN_EXPIRATION</code><br><code>--hono.auth.svc.signing.tokenExpiration</code></td>
+<td align="center">no</td>
+<td align="left">600</td>
+<td align="left">The number of seconds after which the tokens created by this service for asserting an authenticated client&rsquo;s identity should be considered invalid. Other Hono components will close AMQP connections with clients after this period in order to force the client to authenticate again and create a new token. In closed environments it should be save to set this value to a much higher value, e.g. several hours.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AUTH_SVC_SUPPORTED_SASL_MECHANISMS</code><br><code>--hono.auth.svc.supportedSaslMechanisms</code></td>
+<td align="center">no</td>
+<td align="left"><code>EXTERNAL, PLAIN</code></td>
+<td align="left">A (comma separated) list of the supported SASL mechanisms to be advertised to clients. This option may be set to specify only one of <code>EXTERNAL</code> or <code>PLAIN</code>, or to use a different order.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The variables only need to be set if the default value does not match your environment.</p>
+
+<h2 id="port-configuration">Port Configuration</h2>
+
+<p>The Auth Server can be configured to listen for connections on</p>
+
+<ul>
+<li>a secure port only (default) or</li>
+<li>an insecure port only or</li>
+<li>both a secure and an insecure port (dual port configuration)</li>
+</ul>
+
+<p>The server will fail to start if none of the ports is configured properly.</p>
+
+<h3 id="secure-port-only">Secure Port Only</h3>
+
+<p>The server needs to be configured with a private key, a certificate holding the public key and a trust store in order to open a TLS secured port.</p>
+
+<p>There are two alternative ways for setting the private key and certificate:</p>
+
+<ol>
+<li>Setting the <code>HONO_AUTH_AMQP_KEY_STORE_PATH</code> and the <code>HONO_AUTH_AMQP_KEY_STORE_PASSWORD</code> variables in order to load the key &amp; certificate from a password protected key store, or</li>
+<li>setting the <code>HONO_AUTH_AMQP_KEY_PATH</code> and <code>HONO_AUTH_AMQP_CERT_PATH</code> variables in order to load the key and certificate from two separate PEM files in PKCS8 format.</li>
+</ol>
+
+<p>In order to set the trust store, the <code>HONO_AUTH_AMQP_TRUST_STORE_PATH</code> variable needs to be set to a key store containing the trusted root CA certificates. The <code>HONO_AUTH_AMQP_TRUST_STORE_PASSWORD</code> variable needs to be set if the key store requires a pass phrase for reading its contents.</p>
+
+<p>When starting up, the server will bind a TLS secured socket to the default secure AMQP port 5671. The port number can also be set explicitly using the <code>HONO_AUTH_AMQP_PORT</code> variable.</p>
+
+<p>The <code>HONO_AUTH_AMQP_BIND_ADDRESS</code> variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the <em>loopback device</em> only, i.e. the port will only be accessible from the local host. Setting this variable to <code>0.0.0.0</code> will let the port being bound to <strong>all</strong> network interfaces (be careful not to expose the port unintentionally to the outside world).</p>
+
+<h3 id="insecure-port-only">Insecure Port Only</h3>
+
+<p>The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by</p>
+
+<ul>
+<li>explicitly setting <code>HONO_AUTH_AMQP_INSECURE_PORT</code> to a valid port number, or by</li>
+<li>implicitly configuring the default AMQP port (5672) by simply setting <code>HONO_AUTH_AMQP_INSECURE_PORT_ENABLED</code> to <code>true</code>.</li>
+</ul>
+
+<p>The server issues a warning on the console if <code>HONO_AUTH_AMQP_INSECURE_PORT</code> is set to the default secure AMQP port (5671).</p>
+
+<p>The <code>HONO_AUTH_AMQP_INSECURE_PORT_BIND_ADDRESS</code> variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the <em>loopback device</em> only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.</p>
+
+<p>Setting this variable to <code>0.0.0.0</code> will let the port being bound to <strong>all</strong> network interfaces (be careful not to expose the port unintentionally to the outside world).</p>
+
+<h3 id="dual-port">Dual Port</h3>
+
+<p>In test setups and some production scenarios Hono server may be configured to open one secure <strong>and</strong> one insecure port at the same time.</p>
+
+<p>This is achieved by configuring both ports correctly (see above). The server will fail to start if both ports are configured to use the same port number.</p>
+
+<p>Since the secure port may need different visibility in the network setup compared to the secure port, it has it&rsquo;s own binding address <code>HONO_AUTH_AMQP_INSECURE_PORT_BIND_ADDRESS</code>.
+This can be used to narrow the visibility of the insecure port to a local network e.g., while the secure port may be visible worldwide.</p>
+
+<h3 id="ephemeral-ports">Ephemeral Ports</h3>
+
+<p>The server may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.</p>
+
+<h2 id="metrics-configuration">Metrics Configuration</h2>
+
+<p>See <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">Monitoring &amp; Tracing Admin Guide</a> for details on how to configure the reporting of metrics.</p>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/admin-guide/common-config/index.html b/docs/1.2/admin-guide/common-config/index.html
new file mode 100644
index 0000000..38df328
--- /dev/null
+++ b/docs/1.2/admin-guide/common-config/index.html
@@ -0,0 +1,2758 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Common Configuration :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Common Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Common Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/admin-guide/common-config//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/admin-guide/common-config/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item active">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/admin-guide/common-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/common-config/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/admin-guide/common-config/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/admin-guide/common-config/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/admin-guide/common-config/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/admin-guide/common-config.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/admin-guide/'>Admin Guide</a> > Common Configuration
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#java-vm-options">Java VM Options</a></li>
+<li><a href="#vert-x-options">Vert.x Options</a>
+<ul>
+<li><a href="#using-epoll-on-linux">Using epoll() on Linux</a></li>
+</ul></li>
+<li><a href="#protocol-adapter-options">Protocol Adapter Options</a>
+<ul>
+<li><a href="#amqp-1-0-messaging-network-connection-configuration">AMQP 1.0 Messaging Network Connection Configuration</a></li>
+<li><a href="#command-control-connection-configuration">Command &amp; Control Connection Configuration</a></li>
+<li><a href="#tenant-service-connection-configuration">Tenant Service Connection Configuration</a></li>
+<li><a href="#device-registration-service-connection-configuration">Device Registration Service Connection Configuration</a></li>
+<li><a href="#credentials-service-connection-configuration">Credentials Service Connection Configuration</a></li>
+<li><a href="#device-connection-service-connection-configuration">Device Connection Service Connection Configuration</a>
+<ul>
+<li><a href="#direct-connection-to-data-grid">Direct Connection to Data Grid</a></li>
+</ul></li>
+<li><a href="#resource-limits-checker-configuration">Resource Limits Checker Configuration</a></li>
+</ul></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Common Configuration</h1>
+          
+
+        
+
+
+<p>Many Hono components support a common set of configuration options. This section
+describes those options.</p>
+
+<p>Each component which supports the following options explicitly states so. If
+it doesn&rsquo;t, then these options are not supported by this component.</p>
+
+<h2 id="java-vm-options">Java VM Options</h2>
+
+<p>The Java VM started in Hono&rsquo;s components can be configured with arbitrary command line options by means of setting the <code>JDK_JAVA_OPTIONS</code> environment variable.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable</th>
+<th align="center">Mandatory</th>
+<th align="left">Default</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>JDK_JAVA_OPTIONS</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">Any options that should be passed to the Java VM on the command line, e.g. <code>-Xmx128m</code></td>
+</tr>
+</tbody>
+</table>
+
+<h2 id="vert-x-options">Vert.x Options</h2>
+
+<p>The vert.x framework instance used to run Hono&rsquo;s components on can be configured using the following environment variables or corresponding command line options:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="center">Mandatory</th>
+<th align="left">Default</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>HONO_VERTX_DNS_QUERY_TIMEOUT</code><br><code>--hono.vertx.dnsQueryTimeout</code></td>
+<td align="center">no</td>
+<td align="left"><code>5000</code></td>
+<td align="left">The amount of time (in milliseconds) after which a DNS query is considered to be failed. Setting this variable to a smaller value may help to reduce the time required to establish connections to the services this adapter depends on. However, setting it to a value that is too small for any DNS query to succeed will effectively prevent any connections to be established at all.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_VERTX_MAX_EVENT_LOOP_EXECUTE_TIME_MILLIS</code><br><code>--hono.vertx.maxEventLoopExecuteTimeMillis</code></td>
+<td align="center">no</td>
+<td align="left"><code>2000</code></td>
+<td align="left">The maximum number of milliseconds that a task on the event loop may run without being considered to block the event loop.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_VERTX_PREFER_NATIVE</code><br><code>--hono.vertx.preferNative</code></td>
+<td align="center">no</td>
+<td align="left"><code>false</code></td>
+<td align="left">Tries to enable <em>epoll()</em> support on Linux (if available). See the <a href="./#epoll">notes below</a> for an explanation of the benefits of enabling <em>epoll</em>.</td>
+</tr>
+</tbody>
+</table>
+
+<p><a name="epoll"></a></p>
+
+<h3 id="using-epoll-on-linux">Using epoll() on Linux</h3>
+
+<p>Using <code>epoll()</code> on Linux may provide better performance for applications which
+have a high I/O throughput. Especially when the application supports an
+asynchronous I/O model. This is true for most Hono components and applications using Hono.</p>
+
+<p>The <em>Netty</em> framework supports using <code>epoll()</code> on Linux x86_64 based systems.
+Hono provides the a Maven build profile for enabling
+support for <em>epoll</em> during the build process.</p>
+
+<p>In order to use <em>epoll</em></p>
+
+<ul>
+<li>Hono needs to be built with the <code>netty-native-linux-x86_64</code> Maven profile enabled and</li>
+<li>the <code>HONO_VERTX_PREFER_NATIVE</code> environment variable needs to be set to <code>true</code> on startup.</li>
+</ul>
+
+<h2 id="protocol-adapter-options">Protocol Adapter Options</h2>
+
+<h3 id="amqp-1-0-messaging-network-connection-configuration">AMQP 1.0 Messaging Network Connection Configuration</h3>
+
+<p>Protocol adapters require a connection to the <em>AMQP 1.0 Messaging Network</em> in order to forward telemetry data and events received from devices to downstream consumers.</p>
+
+<p>The connection to the messaging network is configured according to <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">Hono Client Configuration</a>
+with <code>HONO_MESSAGING</code> being used as <code>${PREFIX}</code>. Since there are no responses being received, the properties for configuring response caching can be ignored.</p>
+
+<h3 id="command-control-connection-configuration">Command &amp; Control Connection Configuration</h3>
+
+<p>Protocol adapters require an additional connection to the <em>AMQP 1.0 Messaging Network</em> in order to receive
+commands from downstream applications and send responses to commands back to applications.</p>
+
+<p>The connection is configured according to <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">Hono Client Configuration</a>
+with <code>HONO_COMMAND</code> being used as <code>${PREFIX}</code>. The properties for configuring response caching can be ignored.</p>
+
+<h3 id="tenant-service-connection-configuration">Tenant Service Connection Configuration</h3>
+
+<p>Protocol adapters require a connection to an implementation of Hono&rsquo;s <a href="/hono/docs/1.2/api/tenant/">Tenant API</a> in order to retrieve information for a tenant.</p>
+
+<p>The connection to the Tenant Service is configured according to <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">Hono Client Configuration</a>
+where the <code>${PREFIX}</code> is set to <code>HONO_TENANT</code> and the additional values for response caching apply.</p>
+
+<p>The adapter caches the responses from the service according to the <em>cache directive</em> included in the response.
+If the response doesn&rsquo;t contain a <em>cache directive</em> no data will be cached.</p>
+
+<h3 id="device-registration-service-connection-configuration">Device Registration Service Connection Configuration</h3>
+
+<p>Protocol adapters require a connection to an implementation of Hono&rsquo;s <a href="/hono/docs/1.2/api/device-registration/">Device Registration API</a> in order to retrieve registration status assertions for connected devices.</p>
+
+<p>The connection to the Device Registration Service is configured according to <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">Hono Client Configuration</a>
+where the <code>${PREFIX}</code> is set to <code>HONO_REGISTRATION</code>.</p>
+
+<p>The adapter caches the responses from the service according to the <em>cache directive</em> included in the response.
+If the response doesn&rsquo;t contain a <em>cache directive</em> no data will be cached.</p>
+
+<h3 id="credentials-service-connection-configuration">Credentials Service Connection Configuration</h3>
+
+<p>Protocol adapters require a connection to an implementation of Hono&rsquo;s <a href="/hono/docs/1.2/api/credentials/">Credentials API</a> in order to retrieve credentials stored for devices that needs to be authenticated. During connection establishment, the adapter uses the Credentials API to retrieve the credentials on record for the device and matches that with the credentials provided by a device.</p>
+
+<p>The connection to the Credentials Service is configured according to <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">Hono Client Configuration</a>
+where the <code>${PREFIX}</code> is set to <code>HONO_CREDENTIALS</code>.</p>
+
+<p>The adapter caches the responses from the service according to the <em>cache directive</em> included in the response.
+If the response doesn&rsquo;t contain a <em>cache directive</em> no data will be cached.</p>
+
+<h3 id="device-connection-service-connection-configuration">Device Connection Service Connection Configuration</h3>
+
+<p>Protocol adapters require a connection to an implementation of Hono&rsquo;s <a href="/hono/docs/1.2/api/device-connection/">Device Connection API</a>
+in order to determine the gateway that a device is connected via to a protocol adapter. This information is required in order to
+forward commands issued by applications to the protocol adapter instance that the gateway is connected to.</p>
+
+<p>The connection to the Device Connection service is configured according to <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">Hono Client Configuration</a>
+where the <code>${PREFIX}</code> is set to <code>HONO_DEVICECONNECTION</code>.</p>
+
+<p>Responses from the Device Connection service are never cached, so the properties for configuring the cache are ignored.</p>
+
+<h4 id="direct-connection-to-data-grid">Direct Connection to Data Grid</h4>
+
+<p>Protocol adapters can alternatively be configured to directly access an data grid for storing and retrieving
+device connection information using <a href="https://infinispan.org">Infinispan</a>&rsquo;s Hotrod protocol.
+This has the advantage of saving the network hop to the Device Connection service. However,
+this is only beneficial if the Device Connection service implementation itself uses a remote service (like a data grid) for
+storing the data.</p>
+
+<p>The following table provides an overview of the configuration variables and corresponding command line options for configuring
+the connection to the data grid:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="center">Mandatory</th>
+<th align="left">Default</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_SERVER_LIST</code><br><code>--hono.deviceConnection.serverList</code></td>
+<td align="center">yes</td>
+<td align="left">-</td>
+<td align="left">A list of remote servers in the form: <code>host1[:port][;host2[:port]]....</code>.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_AUTH_SERVER_NAME</code><br><code>--hono.deviceConnection.authServerName</code></td>
+<td align="center">yes</td>
+<td align="left">-</td>
+<td align="left">The server name to indicate in the SASL handshake when authenticating to the server.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_AUTH_USERNAME</code><br><code>--hono.deviceConnection.authUsername</code></td>
+<td align="center">yes</td>
+<td align="left">-</td>
+<td align="left">The username to use for authenticating to the server.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_AUTH_PASSWORD</code><br><code>--hono.deviceConnection.authPassword</code></td>
+<td align="center">yes</td>
+<td align="left">-</td>
+<td align="left">The password to use for authenticating to the server.</td>
+</tr>
+</tbody>
+</table>
+
+<p>In general, the service supports all configuration properties of the <a href="https://docs.jboss.org/infinispan/9.4/apidocs/org/infinispan/client/hotrod/configuration/package-summary.html#package.description">Infinispan Hotrod client</a> using <code>hono.deviceConnection</code> instead of the <code>infinispan.client.hotrod</code> prefix.</p>
+
+<h3 id="resource-limits-checker-configuration">Resource Limits Checker Configuration</h3>
+
+<p>The adapter can use metrics collected by a Prometheus server to enforce certain limits set at the tenant level like the overall number of connected devices allowed per tenant.</p>
+
+<p>The following table provides an overview of the configuration variables and corresponding command line options for configuring the checker.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="center">Mandatory</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_HOST</code><br><code>--hono.resourceLimits.prometheusBased.host</code></td>
+<td align="center">no</td>
+<td align="left"><code>localhost</code></td>
+<td align="left">The host name or IP address of the Prometheus server to retrieve the metrics data from. This property needs to be set in order to enable the Prometheus based checks.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_PORT</code><br><code>--hono.resourceLimits.prometheusBased.port</code></td>
+<td align="center">no</td>
+<td align="left"><code>9090</code></td>
+<td align="left">The port of the Prometheus server to retrieve metrics data from.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_CACHE_MIN_SIZE</code><br><code>--hono.resourceLimits.prometheusBased.cacheMinSize</code></td>
+<td align="center">no</td>
+<td align="left"><code>20</code></td>
+<td align="left">The minimum size of the cache to store the metrics data retrieved from the Prometheus server. The cache is used for storing the current amount of data exchanged with devices of tenants.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_CACHE_MAX_SIZE</code><br><code>--hono.resourceLimits.prometheusBased.cacheMaxSize</code></td>
+<td align="center">no</td>
+<td align="left"><code>1000</code></td>
+<td align="left">The maximum size of the cache to store the metrics data retrieved from the Prometheus server.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_CACHE_TIMEOUT</code><br><code>--hono.resourceLimits.prometheusBased.cacheTimeout</code></td>
+<td align="center">no</td>
+<td align="left"><code>600</code></td>
+<td align="left">The number of seconds after which the cached metrics data should be considered invalid.</td>
+</tr>
+</tbody>
+</table>
+
+<p>In addition to the properties listed above, the resource limit checker also supports the properties listed below as documented in the
+<a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">Hono Client Configuration</a>. These properties might be useful if a reverse proxy in front of
+the Prometheus server requires the client to use TLS and/or provide credentials for authentication.</p>
+
+<ul>
+<li><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_CREDENTIALSPATH</code></li>
+<li><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_HOSTNAMEVERIFICATIONREQUIRED</code></li>
+<li><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_KEYPATH</code></li>
+<li><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_KEYSTOREPASSWORD</code></li>
+<li><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_KEYSTOREPATH</code></li>
+<li><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_PASSWORD</code></li>
+<li><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_SECUREPROTOCOLS</code></li>
+<li><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_TLSENABLED</code></li>
+<li><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_TRUSTSTOREPATH</code></li>
+<li><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_TRUSTSTOREPASSWORD</code></li>
+<li><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_USERNAME</code></li>
+</ul>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/admin-guide/device-connection-config/index.html b/docs/1.2/admin-guide/device-connection-config/index.html
new file mode 100644
index 0000000..5360dd6
--- /dev/null
+++ b/docs/1.2/admin-guide/device-connection-config/index.html
@@ -0,0 +1,2748 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Configuring the Device Connection Service :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Configuring the Device Connection Service :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Configuring the Device Connection Service :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/admin-guide/device-connection-config//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/admin-guide/device-connection-config/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item active">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/admin-guide/device-connection-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/device-connection-config/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/admin-guide/device-connection-config/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/admin-guide/device-connection-config/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/admin-guide/device-connection-config/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/admin-guide/device-connection-config.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/admin-guide/'>Admin Guide</a> > Configuring the Device Connection Service
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#service-configuration">Service Configuration</a></li>
+<li><a href="#port-configuration">Port Configuration</a>
+<ul>
+<li><a href="#secure-port-only">Secure Port Only</a></li>
+<li><a href="#insecure-port-only">Insecure Port Only</a></li>
+<li><a href="#dual-port">Dual Port</a></li>
+<li><a href="#ephemeral-ports">Ephemeral Ports</a></li>
+</ul></li>
+<li><a href="#data-grid-connection-configuration">Data Grid Connection Configuration</a></li>
+<li><a href="#authentication-service-connection-configuration">Authentication Service Connection Configuration</a></li>
+<li><a href="#metrics-configuration">Metrics Configuration</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Configuring the Device Connection Service</h1>
+          
+
+        
+
+
+<p>The Device Connection service provides an implementation of Eclipse Hono&trade;&rsquo;s <a href="/hono/docs/1.2/api/device-connection/">Device Connection API</a>.</p>
+
+<p>Protocol adapters use this API to store and retrieve information about the gateway that a device is using to connect to Hono&rsquo;s protocol adapters. This information is necessary for routing commands to the particular protocol adapter instance that the gateway used by the device is connected to.</p>
+
+<p>The Device Connection component provides a production grade implementation of the Device Connection API which uses a remote <em>data grid</em> for storing information about device connections. The data grid can be scaled out independently from the Device Connection service components to meet the storage demands at hand.</p>
+
+<p>The Device Connection component is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding <a href="https://hub.docker.com/r/eclipse/hono-service-device-connection/">Docker image</a> created from it.</p>
+
+<h2 id="service-configuration">Service Configuration</h2>
+
+<p>In addition to the following options, this component supports the options described in <a href="/hono/docs/1.2/admin-guide/common-config/">Common Configuration</a>.</p>
+
+<p>The following table provides an overview of the configuration variables and corresponding command line options for configuring the Device Connection component.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="center">Mandatory</th>
+<th align="left">Default</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>HONO_APP_MAX_INSTANCES</code><br><code>--hono.app.maxInstances</code></td>
+<td align="center">no</td>
+<td align="left"><em>#CPU cores</em></td>
+<td align="left">The number of Verticle instances to deploy. If not set, one Verticle per processor core is deployed.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_AMQP_BIND_ADDRESS</code><br><code>--hono.registry.amqp.bindAddress</code></td>
+<td align="center">no</td>
+<td align="left"><code>127.0.0.1</code></td>
+<td align="left">The IP address of the network interface that the secure AMQP port should be bound to.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_AMQP_CERT_PATH</code><br><code>--hono.deviceConnection.amqp.certPath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the PEM file containing the certificate that the server should use for authenticating to clients. This option must be used in conjunction with <code>HONO_DEVICECONNECTION_AMQP_KEY_PATH</code>.<br>Alternatively, the <code>HONO_DEVICECONNECTION_AMQP_KEY_STORE_PATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_AMQP_INSECURE_PORT</code><br><code>--hono.deviceConnection.amqp.insecurePort</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The insecure port the server should listen on for AMQP 1.0 connections.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_BIND_ADDRESS</code><br><code>--hono.deviceConnection.amqp.insecurePortBindAddress</code></td>
+<td align="center">no</td>
+<td align="left"><code>127.0.0.1</code></td>
+<td align="left">The IP address of the network interface that the insecure AMQP port should be bound to.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_ENABLED</code><br><code>--hono.deviceConnection.amqp.insecurePortEnabled</code></td>
+<td align="center">no</td>
+<td align="left"><code>false</code></td>
+<td align="left">If set to <code>true</code> the server will open an insecure port (not secured by TLS) using either the port number set via <code>HONO_REGISTRY_AMQP_INSECURE_PORT</code> or the default AMQP port number (<code>5672</code>) if not set explicitly.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_AMQP_KEY_PATH</code><br><code>--hono.deviceConnection.amqp.keyPath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the (PKCS8) PEM file containing the private key that the server should use for authenticating to clients. This option must be used in conjunction with <code>HONO_DEVICECONNECTION_AMQP_CERT_PATH</code>. Alternatively, the <code>HONO_DEVICECONNECTION_AMQP_KEY_STORE_PATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_AMQP_KEY_STORE_PASSWORD</code><br><code>--hono.deviceConnection.amqp.keyStorePassword</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The password required to read the contents of the key store.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_AMQP_KEY_STORE_PATH</code><br><code>--hono.deviceConnection.amqp.keyStorePath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the Java key store containing the private key and certificate that the server should use for authenticating to clients. Either this option or the <code>HONO_DEVICECONNECTION_AMQP_KEY_PATH</code> and <code>HONO_DEVICECONNECTION_AMQP_CERT_PATH</code> options need to be set in order to enable TLS secured connections with clients. The key store format can be either <code>JKS</code> or <code>PKCS12</code> indicated by a <code>.jks</code> or <code>.p12</code> file suffix respectively.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_AMQP_NATIVE_TLS_REQUIRED</code><br><code>--hono.deviceConnection.amqp.nativeTlsRequired</code></td>
+<td align="center">no</td>
+<td align="left"><code>false</code></td>
+<td align="left">The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM&rsquo;s default SSL engine if not available. However, if set to <code>true</code>, the server will fail to start at all in this case.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_AMQP_PORT</code><br><code>--hono.deviceConnection.amqp.port</code></td>
+<td align="center">no</td>
+<td align="left"><code>5671</code></td>
+<td align="left">The secure port that the server should listen on for AMQP 1.0 connections.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_AMQP_RECEIVER_LINK_CREDIT</code><br><code>--hono.deviceConnection.amqp.receiverLinkCredit</code></td>
+<td align="center">no</td>
+<td align="left"><code>100</code></td>
+<td align="left">The number of credits to flow to a client connecting to the service&rsquo;s AMQP endpoint.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_AMQP_SECURE_PROTOCOLS</code><br><code>--hono.deviceConnection.amqp.secureProtocols</code></td>
+<td align="center">no</td>
+<td align="left"><code>TLSv1.2</code></td>
+<td align="left">A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the <a href="https://vertx.io/docs/vertx-core/java/#ssl">vert.x documentation</a> for a list of supported protocol names.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The variables only need to be set if the default value does not match your environment.</p>
+
+<h2 id="port-configuration">Port Configuration</h2>
+
+<p>The Device Connection component supports configuration of both, an AMQP based endpoint as well as an HTTP based endpoint proving RESTful resources for managing registration information and credentials. Both endpoints can be configured to listen for connections on</p>
+
+<ul>
+<li>a secure port only (default) or</li>
+<li>an insecure port only or</li>
+<li>both a secure and an insecure port (dual port configuration)</li>
+</ul>
+
+<p>The server will fail to start if none of the ports is configured properly.</p>
+
+<h3 id="secure-port-only">Secure Port Only</h3>
+
+<p>The server needs to be configured with a private key and certificate in order to open a TLS secured port.</p>
+
+<p>There are two alternative ways for doing so:</p>
+
+<ol>
+<li>Setting the <code>HONO_DEVICECONNECTION_AMQP_KEY_STORE_PATH</code> and the <code>HONO_DEVICECONNECTION_AMQP_KEY_STORE_PASSWORD</code> variables in order to load the key &amp; certificate from a password protected key store, or</li>
+<li>setting the <code>HONO_DEVICECONNECTION_AMQP_KEY_PATH</code> and <code>HONO_DEVICECONNECTION_AMQP_CERT_PATH</code> variables in order to load the key and certificate from two separate PEM files in PKCS8 format.</li>
+</ol>
+
+<p>When starting up, the server will bind a TLS secured socket to the default secure AMQP port 5671. The port number can also be set explicitly using the <code>HONO_DEVICECONNECTION_AMQP_PORT</code> variable.</p>
+
+<p>The <code>HONO_DEVICECONNECTION_AMQP_BIND_ADDRESS</code> variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the <em>loopback device</em> only, i.e. the port will only be accessible from the local host. Setting this variable to <code>0.0.0.0</code> will let the port being bound to <strong>all</strong> network interfaces (be careful not to expose the port unintentionally to the outside world).</p>
+
+<h3 id="insecure-port-only">Insecure Port Only</h3>
+
+<p>The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by</p>
+
+<ul>
+<li>explicitly setting <code>HONO_DEVICECONNECTION_AMQP_INSECURE_PORT</code> to a valid port number, or by</li>
+<li>implicitly configuring the default AMQP port (5672) by simply setting <code>HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_ENABLED</code> to <code>true</code>.</li>
+</ul>
+
+<p>The server issues a warning on the console if <code>HONO_DEVICECONNECTION_AMQP_INSECURE_PORT</code> is set to the default secure AMQP port (5671).</p>
+
+<p>The <code>HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_BIND_ADDRESS</code> variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the <em>loopback device</em> only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.</p>
+
+<p>Setting this variable to <code>0.0.0.0</code> will let the port being bound to <strong>all</strong> network interfaces (be careful not to expose the port unintentionally to the outside world).</p>
+
+<h3 id="dual-port">Dual Port</h3>
+
+<p>In test setups and some production scenarios Hono server may be configured to open one secure <strong>and</strong> one insecure port at the same time.</p>
+
+<p>This is achieved by configuring both ports correctly (see above). The server will fail to start if both ports are configured to use the same port number.</p>
+
+<p>Since the secure port may need different visibility in the network setup compared to the secure port, it has it&rsquo;s own binding address <code>HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_BIND_ADDRESS</code>.
+This can be used to narrow the visibility of the insecure port to a local network e.g., while the secure port may be visible worldwide.</p>
+
+<h3 id="ephemeral-ports">Ephemeral Ports</h3>
+
+<p>The server may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.</p>
+
+<h2 id="data-grid-connection-configuration">Data Grid Connection Configuration</h2>
+
+<p>The Device Connection component requires a connection to a remote data grid using the Infinispan Hotrod protocol to store device connection information in.</p>
+
+<p>The following table provides an overview of the configuration variables and corresponding command line options for configuring the connection to the data grid:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="center">Mandatory</th>
+<th align="left">Default</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_REMOTE_SERVER_LIST</code><br><code>--hono.deviceConnection.remote.serverList</code></td>
+<td align="center">yes</td>
+<td align="left">-</td>
+<td align="left">A list of remote servers in the form: <code>host1[:port][;host2[:port]]....</code>.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_REMOTE_AUTH_SERVER_NAME</code><br><code>--hono.deviceConnection.remote.authServerName</code></td>
+<td align="center">yes</td>
+<td align="left">-</td>
+<td align="left">The server name to indicate in the SASL handshake when authenticating to the server.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_REMOTE_AUTH_USERNAME</code><br><code>--hono.deviceConnection.remote.authUsername</code></td>
+<td align="center">yes</td>
+<td align="left">-</td>
+<td align="left">The username to use for authenticating to the server.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_REMOTE_AUTH_PASSWORD</code><br><code>--hono.deviceConnection.remote.authPassword</code></td>
+<td align="center">yes</td>
+<td align="left">-</td>
+<td align="left">The password to use for authenticating to the server.</td>
+</tr>
+</tbody>
+</table>
+
+<p>In general, the service supports all configuration properties of the <a href="https://docs.jboss.org/infinispan/9.4/apidocs/org/infinispan/client/hotrod/configuration/package-summary.html#package.description">Infinispan Hotrod client</a> using <code>hono.deviceConnection.remote</code> instead of the <code>infinispan.client.hotrod</code> prefix.</p>
+
+<h2 id="authentication-service-connection-configuration">Authentication Service Connection Configuration</h2>
+
+<p>The Device Connection component requires a connection to an implementation of Hono&rsquo;s Authentication API in order to authenticate and authorize client requests.</p>
+
+<p>The connection is configured according to <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">Hono Client Configuration</a>
+where the <code>${PREFIX}</code> is set to <code>HONO_AUTH</code>. Since Hono&rsquo;s Authentication Service does not allow caching of the responses, the cache properties
+can be ignored.</p>
+
+<p>In addition to the standard client configuration properties, following properties need to be set for the connection:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="center">Mandatory</th>
+<th align="left">Default</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>HONO_AUTH_VALIDATION_CERT_PATH</code><br><code>--hono.auth.validation.certPath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the PEM file containing the public key that the service should use for validating tokens issued by the Authentication service. Alternatively, a symmetric key can be used for validating tokens by setting the <code>HONO_AUTH_VALIDATION_SHARED_SECRET</code> variable. If none of these variables is set, the service falls back to the key indicated by the <code>HONO_AUTH_CERT_PATH</code> variable. If that variable is also not set, startup of the service fails.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_AUTH_VALIDATION_SHARED_SECRET</code><br><code>--hono.auth.validation.sharedSecret</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">A string to derive a symmetric key from which is used for validating tokens issued by the Authentication service. The key is derived from the string by using the bytes of the String&rsquo;s UTF8 encoding. When setting the validation key using this variable, the Authentication service <strong>must</strong> be configured with the same key. Alternatively, an asymmetric key pair can be used for validating (and signing) by setting the <code>HONO_AUTH_SIGNING_CERT_PATH</code> variable. If none of these variables is set, startup of the service fails.</td>
+</tr>
+</tbody>
+</table>
+
+<h2 id="metrics-configuration">Metrics Configuration</h2>
+
+<p>See <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">Monitoring &amp; Tracing Admin Guide</a> for details on how to configure the reporting of metrics.</p>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/admin-guide/device-registry-config/index.html b/docs/1.2/admin-guide/device-registry-config/index.html
similarity index 83%
copy from docs/admin-guide/device-registry-config/index.html
copy to docs/1.2/admin-guide/device-registry-config/index.html
index bde4a3d..71f875e 100644
--- a/docs/admin-guide/device-registry-config/index.html
+++ b/docs/1.2/admin-guide/device-registry-config/index.html
@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="stable" class="js csstransforms3d">
+<html lang="1.2" class="js csstransforms3d">
   <head>
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
@@ -18,22 +18,22 @@
 <meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
 <meta name="theme-color" content="#ffffff">
 
-    <title>Device Registry Configuration :: Eclipse Hono&trade;</title>
+    <title>Device Registry Configuration :: Eclipse Hono&trade; Vers.: 1.2</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -53,18 +53,18 @@
 
 <meta name="twitter:card" content="summary_large_image">
 <meta name="twitter:site" content="@EclipseHono">
-<meta name="twitter:title" content="Device Registry Configuration :: Eclipse Hono&amp;trade;">
+<meta name="twitter:title" content="Device Registry Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2">
 <meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
 <meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
 
 
-<meta property="og:title" content="Device Registry Configuration :: Eclipse Hono&amp;trade;" />
+<meta property="og:title" content="Device Registry Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2" />
 <meta property="og:type" content="website" />
-<meta property="og:url" content="https://www.eclipse.org/hono/docs/admin-guide/device-registry-config//" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/admin-guide/device-registry-config//" />
 <meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
 
   </head>
-  <body class="" data-url="/hono/docs/admin-guide/device-registry-config/">
+  <body class="" data-url="/hono/docs/1.2/admin-guide/device-registry-config/">
     <nav id="sidebar" class="">
 
 
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
-        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -106,12 +106,12 @@
  
   
     
-    <li data-nav-id="/hono/docs/concepts/" title="Concepts" class="dd-item 
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
         
         
         
         ">
-      <a href="/hono/docs/concepts/">
+      <a href="/hono/docs/1.2/concepts/">
           <i class="far fa-lightbulb"></i> Concepts
           
       </a>
@@ -131,8 +131,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/concepts/device-identity/" title="Device Identity" class="dd-item ">
-        <a href="/hono/docs/concepts/device-identity/">
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
         Device Identity
         
         </a>
@@ -150,8 +150,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
-        <a href="/hono/docs/concepts/tenancy/">
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
         Multi-Tenancy
         
         </a>
@@ -169,8 +169,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
-        <a href="/hono/docs/concepts/device-provisioning/">
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
         Device Provisioning
         
         </a>
@@ -188,8 +188,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
-        <a href="/hono/docs/concepts/connecting-devices/">
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
         Connecting Devices
         
         </a>
@@ -207,8 +207,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
-        <a href="/hono/docs/concepts/device-notifications/">
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
         Device Notifications
         
         </a>
@@ -226,8 +226,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
-        <a href="/hono/docs/concepts/command-and-control/">
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
         Command &amp; Control
         
         </a>
@@ -245,8 +245,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/concepts/resource-limits/" title="Resource limits" class="dd-item ">
-        <a href="/hono/docs/concepts/resource-limits/">
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
         Resource limits
         
         </a>
@@ -264,8 +264,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/concepts/connection-events/" title="Connection Events" class="dd-item ">
-        <a href="/hono/docs/concepts/connection-events/">
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
         Connection Events
         
         </a>
@@ -290,12 +290,12 @@
  
   
     
-    <li data-nav-id="/hono/docs/user-guide/" title="User Guide" class="dd-item 
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
         
         
         
         ">
-      <a href="/hono/docs/user-guide/">
+      <a href="/hono/docs/1.2/user-guide/">
           <i class="fas fa-book-reader"></i> User Guide
           
       </a>
@@ -315,8 +315,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
         Device Registry
         
         </a>
@@ -334,8 +334,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
-        <a href="/hono/docs/user-guide/http-adapter/">
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
         HTTP Adapter
         
         </a>
@@ -353,8 +353,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
-        <a href="/hono/docs/user-guide/mqtt-adapter/">
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
         MQTT Adapter
         
         </a>
@@ -372,8 +372,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
-        <a href="/hono/docs/user-guide/amqp-adapter/">
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
         AMQP Adapter
         
         </a>
@@ -391,8 +391,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
-        <a href="/hono/docs/user-guide/coap-adapter/">
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
         CoAP Adapter
         
         </a>
@@ -410,8 +410,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
-        <a href="/hono/docs/user-guide/kura-adapter/">
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
         Kura Adapter
         
         </a>
@@ -429,8 +429,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
-        <a href="/hono/docs/user-guide/sigfox-adapter/">
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
         Sigfox Adapter
         
         </a>
@@ -448,8 +448,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
-        <a href="/hono/docs/user-guide/jmeter_load_tests/">
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
         Load Tests with JMeter
         
         </a>
@@ -474,12 +474,12 @@
  
   
     
-    <li data-nav-id="/hono/docs/admin-guide/" title="Admin Guide" class="dd-item 
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
         parent
         
         
         ">
-      <a href="/hono/docs/admin-guide/">
+      <a href="/hono/docs/1.2/admin-guide/">
           <i class="fas fa-sliders-h"></i> Admin Guide
           
       </a>
@@ -499,8 +499,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/common-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
         Common Configuration
         
         </a>
@@ -518,8 +518,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/auth-server-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
         Auth Server Configuration
         
         </a>
@@ -537,8 +537,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item active">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item active">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
         Device Registry Configuration
         
         </a>
@@ -556,8 +556,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-connection-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
         Device Connection Service Configuration
         
         </a>
@@ -575,8 +575,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/http-adapter-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
         HTTP Adapter Configuration
         
         </a>
@@ -594,8 +594,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/amqp-adapter-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
         
         </a>
@@ -613,8 +613,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
         MQTT Adapter Configuration
         
         </a>
@@ -632,8 +632,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/kura-adapter-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
         Kura Adapter Configuration
         
         </a>
@@ -651,8 +651,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/hono-client-configuration/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
         Hono Client Configuration
         
         </a>
@@ -670,8 +670,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/amqp-network-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
         AMQP 1.0 Messaging Network Configuration
         
         </a>
@@ -689,8 +689,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
-        <a href="/hono/docs/admin-guide/secure_communication/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
         Secure Communication
         
         </a>
@@ -708,8 +708,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
-        <a href="/hono/docs/admin-guide/monitoring-tracing-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
         Monitoring &amp; Tracing
         
         </a>
@@ -734,12 +734,12 @@
  
   
     
-    <li data-nav-id="/hono/docs/dev-guide/" title="Developer Guide" class="dd-item 
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
         
         
         
         ">
-      <a href="/hono/docs/dev-guide/">
+      <a href="/hono/docs/1.2/dev-guide/">
           <i class="fas fa-tools"></i> Developer Guide
           
       </a>
@@ -759,8 +759,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
-        <a href="/hono/docs/dev-guide/building_hono/">
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
         Building from Source
         
         </a>
@@ -778,8 +778,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
-        <a href="/hono/docs/dev-guide/amqp_adapter_client/">
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
         AMQP Adapter Client for Java
         
         </a>
@@ -797,8 +797,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
-        <a href="/hono/docs/dev-guide/java_client_consumer/">
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
         Consuming Messages from Java
         
         </a>
@@ -816,8 +816,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
-        <a href="/hono/docs/dev-guide/custom_http_adapter/">
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
         Implement a Custom Hono HTTP Protocol Adapter
         
         </a>
@@ -842,12 +842,12 @@
  
   
     
-    <li data-nav-id="/hono/docs/api/" title="API" class="dd-item 
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
         
         
         
         ">
-      <a href="/hono/docs/api/">
+      <a href="/hono/docs/1.2/api/">
           &nbsp;<i class='fas fa-plug'></i>&nbsp;API
           
       </a>
@@ -867,8 +867,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
-        <a href="/hono/docs/api/telemetry/">
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
         Telemetry API
         
         </a>
@@ -886,8 +886,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/event/" title="Event API Specification" class="dd-item ">
-        <a href="/hono/docs/api/event/">
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
         Event API
         
         </a>
@@ -905,8 +905,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
-        <a href="/hono/docs/api/command-and-control/">
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
         Command &amp; Control API
         
         </a>
@@ -924,8 +924,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/tenant/" title="Tenant API Specification" class="dd-item ">
-        <a href="/hono/docs/api/tenant/">
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
         Tenant API
         
         </a>
@@ -943,8 +943,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
-        <a href="/hono/docs/api/device-connection/">
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
         Device Connection API
         
         </a>
@@ -962,8 +962,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
-        <a href="/hono/docs/api/device-registration/">
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
         Device Registration API
         
         </a>
@@ -981,8 +981,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/credentials/" title="Credentials API Specification" class="dd-item ">
-        <a href="/hono/docs/api/credentials/">
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
         Credentials API
         
         </a>
@@ -1000,8 +1000,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/authentication/" title="Authentication API Specification" class="dd-item ">
-        <a href="/hono/docs/api/authentication/">
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
         Authentication API
         
         </a>
@@ -1019,8 +1019,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/management/" title="Device Registry Management API Specification" class="dd-item ">
-        <a href="/hono/docs/api/management/">
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
         Device Registry Management API
         
         </a>
@@ -1038,8 +1038,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/metrics/" title="Metrics" class="dd-item ">
-        <a href="/hono/docs/api/metrics/">
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
         Metrics
         
         </a>
@@ -1064,12 +1064,12 @@
  
   
     
-    <li data-nav-id="/hono/docs/deployment/" title="Deployment" class="dd-item 
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
         
         
         
         ">
-      <a href="/hono/docs/deployment/">
+      <a href="/hono/docs/1.2/deployment/">
           <i class="fas fa-shipping-fast"></i> Deployment
           
       </a>
@@ -1089,8 +1089,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
-        <a href="/hono/docs/deployment/helm-based-deployment/">
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
         Helm based Deployment
         
         </a>
@@ -1108,8 +1108,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
-        <a href="/hono/docs/deployment/openshift/">
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
         OpenShift / OKD
         
         </a>
@@ -1127,8 +1127,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
-        <a href="/hono/docs/deployment/create-kubernetes-cluster/">
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
         Setting up a Kubernetes Cluster
         
         </a>
@@ -1146,8 +1146,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
-        <a href="/hono/docs/deployment/resource-limitation/">
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
         Limiting Resource Usage
         
         </a>
@@ -1172,12 +1172,12 @@
  
   
     
-    <li data-nav-id="/hono/docs/architecture/" title="Architecture" class="dd-item 
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
         
         
         
         ">
-      <a href="/hono/docs/architecture/">
+      <a href="/hono/docs/1.2/architecture/">
           <i class="fas fa-landmark"></i> Architecture
           
       </a>
@@ -1197,8 +1197,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/architecture/component-view/" title="Component View" class="dd-item ">
-        <a href="/hono/docs/architecture/component-view/">
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
         Component View
         
         </a>
@@ -1216,8 +1216,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
-        <a href="/hono/docs/architecture/auth/">
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
         Authentication/Authorization
         
         </a>
@@ -1275,9 +1275,11 @@
               
               
                   
+              
+                  
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/device-registry-config/" selected>stable (1.2)</option>
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/device-registry-config/" selected>1.2</option>
                     
                   
               
@@ -1293,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/device-registry-config/">1.1</option>
@@ -1311,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/device-registry-config/">1.0</option>
@@ -1370,6 +1376,12 @@
         <div id="overlay"></div>
         
         
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
 
     
         <div class="padding highlightable">
@@ -1412,7 +1424,7 @@
             
           
           
-            <a href='/hono/docs/'>Documentation</a> > <a href='/hono/docs/admin-guide/'>Admin Guide</a> > Device Registry Configuration
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/admin-guide/'>Admin Guide</a> > Device Registry Configuration
           
          
           
@@ -1463,20 +1475,20 @@
         
 
 
-<p>The Device Registry component provides an exemplary implementation of Eclipse Hono&trade;&rsquo;s <a href="/hono/docs/api/device-registration/">Device Registration</a>,
-<a href="/hono/docs/api/credentials/">Credentials</a>, <a href="/hono/docs/api/tenant/">Tenant</a> and <a href="/hono/docs/api/device-connection/">Device Connection</a> APIs.</p>
+<p>The Device Registry component provides an exemplary implementation of Eclipse Hono&trade;&rsquo;s <a href="/hono/docs/1.2/api/device-registration/">Device Registration</a>,
+<a href="/hono/docs/1.2/api/credentials/">Credentials</a>, <a href="/hono/docs/1.2/api/tenant/">Tenant</a> and <a href="/hono/docs/1.2/api/device-connection/">Device Connection</a> APIs.</p>
 
 <p>Protocol adapters use these APIs to determine a device&rsquo;s registration status, e.g. if it is enabled and if it is registered with a particular tenant, and to authenticate a device before accepting any data for processing from it.</p>
 
 <p>There is no particular technical reason to implement these three APIs in one component, so for production scenarios there might be up to three different components each implementing one of the API&rsquo;s.</p>
 
-<p>The Device Registry component also exposes <a href="/hono/docs/user-guide/device-registry/">HTTP based resources</a> for managing tenants and the registration information and credentials of devices.</p>
+<p>The Device Registry component also exposes <a href="/hono/docs/1.2/user-guide/device-registry/">HTTP based resources</a> for managing tenants and the registration information and credentials of devices.</p>
 
 <p>The Device Registry is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding <a href="https://hub.docker.com/r/eclipse/hono-service-device-registry-file/">Docker image</a> created from it.</p>
 
 <h2 id="service-configuration">Service Configuration</h2>
 
-<p>In addition to the following options, this component supports the options described in <a href="/hono/docs/admin-guide/common-config/">Common Configuration</a>.</p>
+<p>In addition to the following options, this component supports the options described in <a href="/hono/docs/1.2/admin-guide/common-config/">Common Configuration</a>.</p>
 
 <p>The following table provides an overview of the configuration variables and corresponding command line options for configuring the Device Registry.</p>
 
@@ -1878,7 +1890,7 @@
 
 <p>The Device Registry requires a connection to an implementation of Hono&rsquo;s Authentication API in order to authenticate and authorize client requests.</p>
 
-<p>The connection is configured according to <a href="/hono/docs/admin-guide/hono-client-configuration/">Hono Client Configuration</a>
+<p>The connection is configured according to <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">Hono Client Configuration</a>
 where the <code>${PREFIX}</code> is set to <code>HONO_AUTH</code>. Since Hono&rsquo;s Authentication Service does not allow caching of the responses, the cache properties
 can be ignored.</p>
 
@@ -1920,7 +1932,7 @@
 
 <h2 id="metrics-configuration">Metrics Configuration</h2>
 
-<p>See <a href="/hono/docs/admin-guide/monitoring-tracing-config/">Monitoring &amp; Tracing Admin Guide</a> for details on how to configure the reporting of metrics.</p>
+<p>See <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">Monitoring &amp; Tracing Admin Guide</a> for details on how to configure the reporting of metrics.</p>
 
 <h2 id="device-identities-file-format">Device Identities File Format</h2>
 
@@ -2889,20 +2901,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.2/admin-guide/hono-client-configuration/index.html b/docs/1.2/admin-guide/hono-client-configuration/index.html
new file mode 100644
index 0000000..9902650
--- /dev/null
+++ b/docs/1.2/admin-guide/hono-client-configuration/index.html
@@ -0,0 +1,2760 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Hono Client Configuration :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Hono Client Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Hono Client Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/admin-guide/hono-client-configuration//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item active">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/admin-guide/hono-client-configuration/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/hono-client-configuration/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/admin-guide/hono-client-configuration/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/admin-guide/hono-client-configuration/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/admin-guide/hono-client-configuration/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/admin-guide/hono-client-configuration.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/admin-guide/'>Admin Guide</a> > Hono Client Configuration
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#connection-properties">Connection Properties</a></li>
+<li><a href="#response-caching">Response Caching</a></li>
+<li><a href="#using-tls">Using TLS</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Hono Client Configuration</h1>
+          
+
+        
+
+
+<p>The <code>org.eclipse.hono.client.HonoConnection</code> factory can be used to create AMQP 1.0 connections to Hono&rsquo;s service components.</p>
+
+<p>The factory uses environment variables and/or command line options to configure the connection to the service and the caching of
+responses to service invocations. All variables used for configuring the connection factory for a particular service share a
+common <em>prefix</em>. This way, multiple sets of variables can be used to configure multiple factories for connecting to different
+service endpoints without interfering with each other. For example, the set of variables for configuring the connection factory
+for the Device Registration service may use the common prefix <code>HONO_REGISTRATION</code> whereas the set for configuring the factory
+for the Credentials service may use <code>HONO_CREDENTIALS</code>.</p>
+
+<h2 id="connection-properties">Connection Properties</h2>
+
+<p>The following table provides an overview of the configuration variables and corresponding command line options for configuring
+the AMQP connection to the service.
+Note that the variables map to the properties of classes <code>org.eclipse.hono.config.ClientConfigProperties</code>
+and <code>org.eclipse.client.RequestResponseClientConfigProperties</code> which can be used to programmatically configure a client.</p>
+
+<p>The variable names contain <code>${PREFIX}</code> as a placeholder for the particular <em>common prefix</em> being used. The <code>${prefix}</code> placeholder
+used in the command line option name is the same as <code>${PREFIX}</code>, using all lower case characters and <code>.</code> instead of <code>_</code> as the
+delimiter,  e.g. the variable prefix <code>HONO_CREDENTIALS</code> corresponds to the command line option prefix <code>hono.credentials</code>).</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="center">Mandatory</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>${PREFIX}_AMQPHOSTNAME</code><br><code>--${prefix}.amqpHostname</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The name to use as the <em>hostname</em> in the client&rsquo;s AMQP <em>open</em> frame during connection establishment. This variable can be used to indicate the <em>virtual host</em> to connect to on the server.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_CERTPATH</code><br><code>--${prefix}.certPath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the PEM file containing the certificate that the client should use for authenticating to the server. This variable must be used in conjunction with <code>${PREFIX}_KEY_PATH</code>.<br>Alternatively, the <code>${PREFIX}_KEYSTOREPATH</code> variable can be used to configure a key store containing both the key as well as the certificate.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_CONNECTTIMEOUT</code><br><code>--${prefix}.connectTimeout</code></td>
+<td align="center">no</td>
+<td align="left"><code>5000</code></td>
+<td align="left">The maximum amount of time (milliseconds) that the client should wait for the AMQP connection to be opened. This includes the time for TCP/TLS connection establishment, SASL handshake and exchange of the AMQP <em>open</em> frame. This property can be used to tune the time period to wait according to the network latency involved with the connection between the client and the service.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_CREDENTIALSPATH</code><br><code>--${prefix}.credentialsPath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to a properties file that contains a <em>username</em> and a <em>password</em> property to use for authenticating to the service.<br>This variable is an alternative to using <code>${PREFIX}_USERNAME</code> and <code>${PREFIX}_PASSWORD</code> which has the advantage of not needing to expose the secret (password) in the client process&rsquo; environment.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_FLOWLATENCY</code><br><code>--${prefix}.flowLatency</code></td>
+<td align="center">no</td>
+<td align="left"><code>20</code></td>
+<td align="left">The maximum amount of time (milliseconds) that the client should wait for <em>credits</em> after a link to the service has been established.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_HOST</code><br><code>--${prefix}.host</code></td>
+<td align="center">no</td>
+<td align="left"><code>localhost</code></td>
+<td align="left">The IP address or name of the host to connect to. <strong>NB</strong> This needs to be set to an address that can be resolved within the network the adapter runs on. When running as a Docker container, use Docker&rsquo;s <code>--network</code> command line option to attach the local container to the Docker network that the service is running on.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_HOSTNAMEVERIFICATIONREQUIRED</code><br><code>--${prefix}.hostnameVerificationRequired</code></td>
+<td align="center">no</td>
+<td align="left"><code>true</code></td>
+<td align="left">A flag indicating whether the value of the <code>${PREFIX}_HOST</code> variable must match the <em>distinguished name</em> or any of the <em>alternative names</em> asserted by the server&rsquo;s certificate when connecting using TLS.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_IDLETIMEOUT</code><br><code>--${prefix}.idleTimeout</code></td>
+<td align="center">no</td>
+<td align="left"><code>16000</code></td>
+<td align="left">Sets the amount of time in milliseconds after which a connection will be closed when no frames have been received from the remote peer. This property is also used to configure a heartbeat mechanism, checking that the connection is still alive. The corresponding heartbeat interval will be set to <em>idleTimeout/2</em> ms.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_INITIALCREDITS</code><br><code>--${prefix}.initialCredits</code></td>
+<td align="center">no</td>
+<td align="left"><code>200</code></td>
+<td align="left">The number of <em>credits</em> that a consuming client will initially issue to the service (sender) after link creation. This value effectively limits the number of messages that can be <em>in flight</em> unsettled.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_KEYPATH</code><br><code>--${prefix}.keyPath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the (PKCS8) PEM file containing the private key that the client should use for authenticating to the server. Note that the private key is not protected by a password. You should therefore make sure that the key file can only be read by the user that the client process is running under. This variable must be used in conjunction with <code>${PREFIX}_CERTPATH</code>. Alternatively, the <code>${PREFIX}_KEYSTOREPATH</code> variable can be used to configure a key store containing both the key as well as the certificate.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_KEYSTOREPASSWORD</code><br><code>--${prefix}.keyStorePassword</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The password required to read the contents of the key store.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_KEYSTOREPATH</code><br><code>--${prefix}.keyStorePath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the Java key store containing the private key and certificate that the client should use for authenticating to the server. Either this variable or the <code>${PREFIX}_KEYPATH</code> and <code>${PREFIX}_CERTPATH</code> variables need to be set in order to enable <em>SASL External</em> based authentication to the server. The key store format can be either <code>JKS</code> or <code>PKCS12</code> indicated by a <code>.jks</code> or <code>.p12</code> file suffix respectively.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_LINKESTABLISMENTTIMEOUT</code><br><code>--${prefix}.linkEstablishmentTimeout</code></td>
+<td align="center">no</td>
+<td align="left"><code>1000</code></td>
+<td align="left">The maximum amount of time (milliseconds) that the client should wait for the service&rsquo;s <em>attach</em> frame during link establishment. This property can be used to tune the time period to wait according to the network latency involved with the communication link between the client and the service.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_NAME</code><br><code>--${prefix}.name</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The name to use as the <em>container-id</em> in the client&rsquo;s AMQP <em>open</em> frame during connection establishment.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_PASSWORD</code><br><code>--${prefix}.password</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The password to use for authenticating to the service.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_PORT</code><br><code>--${prefix}.port</code></td>
+<td align="center">no</td>
+<td align="left"><code>5671</code></td>
+<td align="left">The port that the service is listening on.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_SENDMESSAGETIMEOUT</code><br><code>--${prefix}.sendMessageTimeout</code></td>
+<td align="center">no</td>
+<td align="left"><code>1000</code></td>
+<td align="left">The maximum number of milliseconds to wait for a delivery update after an event or command message was sent before the send operation is failed. Setting this value to a higher value increases the chance of successful service invocation in situations where network latency is high.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_RECONNECTATTEMPTS</code><br><code>--${prefix}.reconnectAttempts</code></td>
+<td align="center">no</td>
+<td align="left"><code>-1</code></td>
+<td align="left">The number of attempts (in addition to the original connection attempt) that the client should make in order to establish an AMQP connection with the peer before giving up. The default value of this property is -1 which means that the client will try forever.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_RECONNECTDELAYINCREMENT</code><br><code>--${prefix}.reconnectDelayIncrement</code></td>
+<td align="center">no</td>
+<td align="left"><code>100</code></td>
+<td align="left">The factor (milliseconds) used in the exponential backoff algorithm for determining the delay before trying to re-establish an AMQP connection with the peer. The delay after an initial, failed connection attempt will be the value of the <code>${PREFIX}_RECONNECTMINDELAY</code> variable. Each subsequent connection attempt will use a random delay between the minimum delay and the value determined by exponentially increasing the delay by the <code>${PREFIX}_RECONNECTDELAYINCREMENT</code> factor. The overall limit of the delay time is defined by the <code>${PREFIX}_RECONNECTMAXDELAY</code> variable.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_RECONNECTMAXDELAY</code><br><code>--${prefix}.reconnectMaxDelay</code></td>
+<td align="center">no</td>
+<td align="left"><code>7000</code></td>
+<td align="left">The maximum number of milliseconds to wait before trying to re-establish an AMQP connection with the peer.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_RECONNECTMINDELAY</code><br><code>--${prefix}.reconnectMinDelay</code></td>
+<td align="center">no</td>
+<td align="left"><code>0</code></td>
+<td align="left">The minimum number of milliseconds to wait before trying to re-establish an AMQP connection with the peer.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_REQUESTTIMEOUT</code><br><code>--${prefix}.requestTimeout</code></td>
+<td align="center">no</td>
+<td align="left"><code>200</code></td>
+<td align="left">The maximum number of milliseconds to wait for a response before a service invocation is failed. Setting this value to a higher value increases the chance of successful service invocation in situations where network latency is high.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_SECUREPROTOCOLS</code><br><code>--${prefix}.secureProtocols</code></td>
+<td align="center">no</td>
+<td align="left"><code>TLSv1.2</code></td>
+<td align="left">A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the <a href="https://vertx.io/docs/vertx-core/java/#ssl">vert.x documentation</a> for a list of supported protocol names.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_TLSENABLED</code><br><code>--${prefix}.tlsEnabled</code></td>
+<td align="center">no</td>
+<td align="left"><code>false</code></td>
+<td align="left">If set to <code>true</code> the connection to the peer will be encrypted using TLS and the peer&rsquo;s identity will be verified using the JVM&rsquo;s configured standard trust store.<br>This variable only needs to be set to enable TLS explicitly if no specific trust store is configured using the <code>${PREFIX}_TRUSTSTOREPATH</code> variable.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_TRUSTSTOREPATH</code><br><code>--${prefix}.trustStorePath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the Java key store containing the CA certificates the adapter uses for authenticating the service. This property <strong>must</strong> be set if the service has been configured to support TLS. The key store format can be either <code>JKS</code>, <code>PKCS12</code> or <code>PEM</code> indicated by a <code>.jks</code>, <code>.p12</code> or <code>.pem</code> file suffix respectively.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_TRUSTSTOREPASSWORD</code><br><code>--${prefix}.trustStorePassword</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The password required to read the contents of the trust store.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_USERNAME</code><br><code>--${prefix}.username</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The username to use for authenticating to the service. This property (and the corresponding <em>password</em>) needs to be set in order to enable <em>SASL Plain</em> based authentication to the service.</td>
+</tr>
+</tbody>
+</table>
+
+<h2 id="response-caching">Response Caching</h2>
+
+<p>The clients created by a Hono client factory support the caching of responses received in response to service invocations. Caching can greatly improve performance by preventing costly invocations of remote service operations. However, it usually only makes sense for resources that do not change too frequently. The Hono client follows the <a href="https://tools.ietf.org/html/rfc2616#section-13.4">approach to caching used in HTTP 1.1</a>. In particular, it supports <a href="https://tools.ietf.org/html/rfc2616#section-14.9"><em>cache directives</em></a> that a service includes in the response messages it sends back to the Hono client.</p>
+
+<p>In order to enable caching, the <code>org.eclipse.hono.client.impl.HonoClientImpl</code> factory class needs to be configured with a cache manager using the <em>setCacheManager</em> method. Any specific client created by the factory will then cache responses to service invocations based on the following rules:</p>
+
+<ol>
+<li>If the response contains a <code>no-cache</code> directive, the response is not cached at all.</li>
+<li>Otherwise, if the response contains a <code>max-age</code> directive, the response is cached for the number of seconds specified by the directive.</li>
+<li>Otherwise, if the response message does not contain any of the above directives and the response&rsquo;s status code is one of the codes defined in <a href="https://tools.ietf.org/html/rfc2616#section-13.4">RFC 2616, Section 13.4 Response Cacheability</a>, the response is put to the cache using the default timeout defined by the <code>${PREFIX}_RESPONSECACHEDEFAULTTIMEOUT</code> variable as the maximum age.</li>
+</ol>
+
+<p>The following table provides an overview of the configuration variables and corresponding command line options for configuring the Hono client&rsquo;s caching behavior.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="center">Mandatory</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>${PREFIX}_RESPONSECACHEMINSIZE</code><br><code>--${prefix}.responseCacheMinSize</code></td>
+<td align="center">no</td>
+<td align="left"><code>20</code></td>
+<td align="left">The minimum number of responses that can be cached.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_RESPONSECACHEMAXSIZE</code><br><code>--${prefix}.responseCacheMaxSize</code></td>
+<td align="center">no</td>
+<td align="left"><code>1000</code></td>
+<td align="left">The maximum number of responses that can be cached. It is up to the particular cache implementation, how to deal with new cache entries once this limit has been reached.</td>
+</tr>
+
+<tr>
+<td align="left"><code>${PREFIX}_RESPONSECACHEDEFAULTTIMEOUT</code><br><code>--${prefix}.responseCacheDefaultTimeout</code></td>
+<td align="center">no</td>
+<td align="left"><code>600</code></td>
+<td align="left">The default number of seconds after which cached responses should be considered invalid.</td>
+</tr>
+</tbody>
+</table>
+
+<h2 id="using-tls">Using TLS</h2>
+
+<p>The factory can be configured to use TLS for</p>
+
+<ul>
+<li>authenticating the server during connection establishment and</li>
+<li>(optionally) authenticating to the server using a client certificate (if the server supports this)</li>
+</ul>
+
+<p>In order to authenticate the server by means of the server&rsquo;s certificate, the factory needs to be configured with a <em>trust anchor</em> containing the <em>certificate authorities</em> that the client trusts. The trust anchor can be configured explicitly by means of the <code>${PREFIX}_TRUSTSTOREPATH</code> and <code>${PREFIX}_TRUSTSTOREPASSWORD</code> variables. This is most useful in cases where the server&rsquo;s certificate has not been signed by one of the public root CAs that are contained in the JRE&rsquo;s standard trust store. However, if the server does use a certificate signed by such a public CA, then it is sufficient to set the <code>${PREFIX}_TLSENABLED</code> variable to <code>true</code> in order for the client to support TLS when connecting to the server.</p>
+
+<p>The client can also be configured to authenticate to the server by means of an X.509 client certificate if the server is configured to support this. The <code>${PREFIX}_CERTPATH</code> and <code>${PREFIX}_KEYPATH</code> variables can be used to set the paths to PEM files containing the certificate and private key. Alternatively, the <code>${PREFIX}_KEYSTOREPATH</code> and <code>${PREFIX}_KEYSTOREPASSWORD</code> variables can be used to set the path and password of a key store which contains both the certificate as well as the private key.</p>
+
+<p>The factory supports TLS 1.2 only by default for negotiating TLS sessions with servers. Additional protocols can be enabled by setting the <code>${PREFIX}_SECUREPROTOCOLS</code> variable to a comma separated list of protocol names as defined in the <a href="https://vertx.io/docs/vertx-core/java/#ssl">vert.x documentation</a>. However, great care should be taken when enabling older protocols because most of them are vulnerable to attacks.</p>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/admin-guide/http-adapter-config/index.html b/docs/1.2/admin-guide/http-adapter-config/index.html
new file mode 100644
index 0000000..5b8c437
--- /dev/null
+++ b/docs/1.2/admin-guide/http-adapter-config/index.html
@@ -0,0 +1,2688 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>HTTP Adapter Configuration :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="HTTP Adapter Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="HTTP Adapter Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/admin-guide/http-adapter-config//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/admin-guide/http-adapter-config/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item active">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/admin-guide/http-adapter-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/http-adapter-config/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/admin-guide/http-adapter-config/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/admin-guide/http-adapter-config/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/admin-guide/http-adapter-config/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/admin-guide/http-adapter-config.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/admin-guide/'>Admin Guide</a> > HTTP Adapter Configuration
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#service-configuration">Service Configuration</a></li>
+<li><a href="#port-configuration">Port Configuration</a>
+<ul>
+<li><a href="#secure-port-only">Secure Port Only</a></li>
+<li><a href="#insecure-port-only">Insecure Port Only</a></li>
+<li><a href="#dual-port">Dual Port</a></li>
+<li><a href="#ephemeral-ports">Ephemeral Ports</a></li>
+</ul></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>HTTP Adapter Configuration</h1>
+          
+
+        
+
+
+<p>The HTTP protocol adapter exposes a HTTP based API for Eclipse Hono&trade;&rsquo;s Telemetry and Event endpoints.</p>
+
+<p>The adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding <a href="https://hub.docker.com/r/eclipse/hono-adapter-http-vertx/">Docker image</a> created from it.</p>
+
+<p>The adapter supports the following standard configuration options:</p>
+
+<ul>
+<li><a href="/hono/docs/1.2/admin-guide/common-config/#java-vm-options">Common Java VM Options</a></li>
+<li><a href="/hono/docs/1.2/admin-guide/common-config/#vert-x-options">Common vert.x Options</a></li>
+<li><a href="/hono/docs/1.2/admin-guide/common-config/#protocol-adapter-options">Common Protocol Adapter Options</a></li>
+<li><a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">Monitoring Options</a></li>
+</ul>
+
+<h2 id="service-configuration">Service Configuration</h2>
+
+<p>The following table provides an overview of the configuration variables and corresponding command line options for configuring the HTTP adapter.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="center">Mandatory</th>
+<th align="left">Default</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>HONO_APP_MAX_INSTANCES</code><br><code>--hono.app.maxInstances</code></td>
+<td align="center">no</td>
+<td align="left"><em>#CPU cores</em></td>
+<td align="left">The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HTTP_AUTHENTICATION_REQUIRED</code><br><code>--hono.http.authenticationRequired</code></td>
+<td align="center">no</td>
+<td align="left"><code>true</code></td>
+<td align="left">If set to <code>true</code> the protocol adapter requires devices to authenticate when connecting to the adapter. The credentials provided by the device are verified using the configured <a href="#credentials-service-connection-configuration">Credentials Service</a>. Devices that have failed to authenticate are not allowed to publish any data.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HTTP_BIND_ADDRESS</code><br><code>--hono.http.bindAddress</code></td>
+<td align="center">no</td>
+<td align="left"><code>127.0.0.1</code></td>
+<td align="left">The IP address of the network interface that the secure port should be bound to.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HTTP_CERT_PATH</code><br><code>--hono.http.certPath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the PEM file containing the certificate that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with <code>HONO_HTTP_KEY_PATH</code>.<br>Alternatively, the <code>HONO_HTTP_KEY_STORE_PATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HTTP_DEFAULTS_ENABLED</code><br><code>--hono.http.defaultsEnabled</code></td>
+<td align="center">no</td>
+<td align="left"><code>true</code></td>
+<td align="left">If set to <code>true</code> the protocol adapter uses <em>default values</em> registered for a device to augment messages published by the device with missing information like a content type. In particular, the protocol adapter adds default values registered for the device as (application) properties with the same name to the AMQP 1.0 messages it sends downstream to the AMQP Messaging Network.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HTTP_INSECURE_PORT</code><br><code>--hono.http.insecurePort</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The insecure port the protocol adapter should listen on.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HTTP_INSECURE_PORT_BIND_ADDRESS</code><br><code>--hono.http.insecurePortBindAddress</code></td>
+<td align="center">no</td>
+<td align="left"><code>127.0.0.1</code></td>
+<td align="left">The IP address of the network interface that the insecure port should be bound to.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HTTP_INSECURE_PORT_ENABLED</code><br><code>--hono.http.insecurePortEnabled</code></td>
+<td align="center">no</td>
+<td align="left"><code>false</code></td>
+<td align="left">If set to <code>true</code> the protocol adapter will open an insecure port (not secured by TLS) using either the port number set via <code>HONO_HTTP_INSECURE_PORT</code> or the default port number (<code>8080</code>) if not set explicitly.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HTTP_KEY_PATH</code><br><code>--hono.http.keyPath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the (PKCS8) PEM file containing the private key that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with <code>HONO_HTTP_CERT_PATH</code>. Alternatively, the <code>HONO_HTTP_KEY_STORE_PATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HTTP_KEY_STORE_PASSWORD</code><br><code>--hono.http.keyStorePassword</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The password required to read the contents of the key store.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HTTP_KEY_STORE_PATH</code><br><code>--hono.http.keyStorePath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the Java key store containing the private key and certificate that the protocol adapter should use for authenticating to clients. Either this option or the <code>HONO_HTTP_KEY_PATH</code> and <code>HONO_HTTP_CERT_PATH</code> options need to be set in order to enable TLS secured connections with clients. The key store format can be either <code>JKS</code> or <code>PKCS12</code> indicated by a <code>.jks</code> or <code>.p12</code> file suffix respectively.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HTTP_SNI</code><br><code>--hono.http.sni</code></td>
+<td align="center">no</td>
+<td align="left"><code>false</code></td>
+<td align="left">Set whether the server supports Server Name Indication. By default, the server will not support SNI and the option is <code>false</code>. However, if set to <code>true</code> then the key store format , <code>HONO_HTTP_KEY_STORE_PATH</code>,  should be either <code>JKS</code> or <code>PKCS12</code> indicated by a <code>.jks</code> or <code>.p12</code> file suffix respectively.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HTTP_NATIVE_TLS_REQUIRED</code><br><code>--hono.http.nativeTlsRequired</code></td>
+<td align="center">no</td>
+<td align="left"><code>false</code></td>
+<td align="left">The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM&rsquo;s default SSL engine if not available. However, if set to <code>true</code>, the server will fail to start at all in this case.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HTTP_MAX_PAYLOAD_SIZE</code><br><code>--hono.http.maxPayloadSize</code></td>
+<td align="center">no</td>
+<td align="left"><code>2048</code></td>
+<td align="left">The maximum allowed size of an incoming HTTP request&rsquo;s body in bytes. Requests with a larger body size are rejected with a 413 <code>Request entity too large</code> response.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HTTP_PORT</code><br><code>--hono.http.port</code></td>
+<td align="center">no</td>
+<td align="left"><code>8443</code></td>
+<td align="left">The secure port that the protocol adapter should listen on.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HTTP_REALM</code><br><code>--hono.http.realm</code></td>
+<td align="center">no</td>
+<td align="left"><code>Hono</code></td>
+<td align="left">The name of the <em>realm</em> that unauthenticated devices are prompted to provide credentials for. The realm is used in the <em>WWW-Authenticate</em> header returned to devices in response to unauthenticated requests.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HTTP_SECURE_PROTOCOLS</code><br><code>--hono.http.secureProtocols</code></td>
+<td align="center">no</td>
+<td align="left"><code>TLSv1.2</code></td>
+<td align="left">A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the <a href="https://vertx.io/docs/vertx-core/java/#ssl">vert.x documentation</a> for a list of supported protocol names.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HTTP_TENANT_IDLE_TIMEOUT</code><br><code>--hono.http.tenantIdleTimeout</code></td>
+<td align="center">no</td>
+<td align="left"><code>0ms</code></td>
+<td align="left">The duration after which the protocol adapter removes local state of the tenant (e.g. open AMQP links) with an amount and a unit, e.g. <code>2h</code> for 2 hours. See the <a href="https://docs.spring.io/spring-boot/docs/current/reference/html/spring-boot-features.html#boot-features-external-config-conversion-duration">Spring Boot documentation</a> for an explanation of the format. The value <code>0ms</code> disables the timeout.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The variables only need to be set if the default value does not match your environment.</p>
+
+<h2 id="port-configuration">Port Configuration</h2>
+
+<p>The HTTP protocol adapter can be configured to listen for connections on</p>
+
+<ul>
+<li>a secure port only (default) or</li>
+<li>an insecure port only or</li>
+<li>both a secure and an insecure port (dual port configuration)</li>
+</ul>
+
+<p>The HTTP protocol adapter will fail to start if none of the ports is configured properly.</p>
+
+<h3 id="secure-port-only">Secure Port Only</h3>
+
+<p>The protocol adapter needs to be configured with a private key and certificate in order to open a TLS secured port.</p>
+
+<p>There are two alternative ways for doing so:</p>
+
+<ol>
+<li>Setting the <code>HONO_HTTP_KEY_STORE_PATH</code> and the <code>HONO_HTTP_KEY_STORE_PASSWORD</code> variables in order to load the key &amp; certificate from a password protected key store, or</li>
+<li>setting the <code>HONO_HTTP_KEY_PATH</code> and <code>HONO_HTTP_CERT_PATH</code> variables in order to load the key and certificate from two separate PEM files in PKCS8 format.</li>
+</ol>
+
+<p>When starting up, the protocol adapter will bind a TLS secured socket to the default secure port 8443. The port number can also be set explicitly using the <code>HONO_HTTP_PORT</code> variable.</p>
+
+<p>The <code>HONO_HTTP_BIND_ADDRESS</code> variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the <em>loopback device</em> only, i.e. the port will only be accessible from the local host. Setting this variable to <code>0.0.0.0</code> will let the port being bound to <strong>all</strong> network interfaces (be careful not to expose the port unintentionally to the outside world).</p>
+
+<h3 id="insecure-port-only">Insecure Port Only</h3>
+
+<p>The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by</p>
+
+<ul>
+<li>explicitly setting <code>HONO_HTTP_INSECURE_PORT</code> to a valid port number, or by</li>
+<li>implicitly configuring the default port (8080) by simply setting <code>HONO_HTTP_INSECURE_PORT_ENABLED</code> to <code>true</code>.</li>
+</ul>
+
+<p>The protocol adapter issues a warning on the console if <code>HONO_HTTP_INSECURE_PORT</code> is set to the default secure HTTP port (8443).</p>
+
+<p>The <code>HONO_HTTP_INSECURE_PORT_BIND_ADDRESS</code> variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the <em>loopback device</em> only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.</p>
+
+<p>Setting this variable to <code>0.0.0.0</code> will let the port being bound to <strong>all</strong> network interfaces (be careful not to expose the port unintentionally to the outside world).</p>
+
+<h3 id="dual-port">Dual Port</h3>
+
+<p>The protocol adapter may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.</p>
+
+<h3 id="ephemeral-ports">Ephemeral Ports</h3>
+
+<p>Both the secure as well as the insecure port numbers may be explicitly set to <code>0</code>. The protocol adapter will then use arbitrary (unused) port numbers determined by the operating system during startup.</p>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/admin-guide/index.html b/docs/1.2/admin-guide/index.html
new file mode 100644
index 0000000..c239cac
--- /dev/null
+++ b/docs/1.2/admin-guide/index.html
@@ -0,0 +1,2454 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Admin Guide :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Admin Guide :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Admin Guide :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/admin-guide//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/admin-guide/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        parent
+        active
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/admin-guide/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/admin-guide/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/admin-guide/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/admin-guide/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/admin-guide/_index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > Admin Guide
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+              </div>
+            </div>
+            
+
+        
+          <div id="chapter">
+        
+        <div id="body-inner">
+          
+
+        
+
+
+
+
+<h1 id="admin-guide">Admin Guide</h1>
+
+<p>Learn how to operate Eclipse Hono&trade; and look up the configuration options of its components.</p>
+
+
+<footer class=" footline" >
+	
+</footer>
+
+        
+            </div> 
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
diff --git a/docs/1.2/admin-guide/index.xml b/docs/1.2/admin-guide/index.xml
new file mode 100644
index 0000000..b7d66bc
--- /dev/null
+++ b/docs/1.2/admin-guide/index.xml
@@ -0,0 +1,128 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>Admin Guide on Eclipse Hono&amp;trade; Vers.: 1.2</title>
+    <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/</link>
+    <description>Recent content in Admin Guide on Eclipse Hono&amp;trade; Vers.: 1.2</description>
+    <generator>Hugo -- gohugo.io</generator>
+    <language>en-us</language>
+    
+	<atom:link href="https://www.eclipse.org/hono/docs/1.2/admin-guide/index.xml" rel="self" type="application/rss+xml" />
+    
+    
+    <item>
+      <title>Common Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/common-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/common-config/</guid>
+      <description>&lt;p&gt;Many Hono components support a common set of configuration options. This section
+describes those options.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Auth Server Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/auth-server-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/auth-server-config/</guid>
+      <description>&lt;p&gt;The Auth Server component exposes a service endpoint implementing Eclipse Hono&amp;trade;&amp;rsquo;s &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/authentication/&#34;&gt;Authentication&lt;/a&gt; API. Other services use this component for authenticating clients and retrieving a token asserting the client&amp;rsquo;s identity and corresponding authorities.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Device Registry Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/device-registry-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/device-registry-config/</guid>
+      <description>&lt;p&gt;The Device Registry component provides an exemplary implementation of Eclipse Hono&amp;trade;&amp;rsquo;s &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/device-registration/&#34;&gt;Device Registration&lt;/a&gt;,
+&lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/credentials/&#34;&gt;Credentials&lt;/a&gt;, &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/tenant/&#34;&gt;Tenant&lt;/a&gt; and &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/device-connection/&#34;&gt;Device Connection&lt;/a&gt; APIs.&lt;/p&gt;
+
+&lt;p&gt;Protocol adapters use these APIs to determine a device&amp;rsquo;s registration status, e.g. if it is enabled and if it is registered with a particular tenant, and to authenticate a device before accepting any data for processing from it.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Configuring the Device Connection Service</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/device-connection-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/device-connection-config/</guid>
+      <description>&lt;p&gt;The Device Connection service provides an implementation of Eclipse Hono&amp;trade;&amp;rsquo;s &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/device-connection/&#34;&gt;Device Connection API&lt;/a&gt;.&lt;/p&gt;
+
+&lt;p&gt;Protocol adapters use this API to store and retrieve information about the gateway that a device is using to connect to Hono&amp;rsquo;s protocol adapters. This information is necessary for routing commands to the particular protocol adapter instance that the gateway used by the device is connected to.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>HTTP Adapter Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/http-adapter-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/http-adapter-config/</guid>
+      <description>&lt;p&gt;The HTTP protocol adapter exposes a HTTP based API for Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry and Event endpoints.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>AMQP Adapter Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-adapter-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-adapter-config/</guid>
+      <description>&lt;p&gt;The AMQP protocol adapter allows clients (devices and gateway components) that speaks AMQP 1.0 to publish telemetry messages and events to Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry and Event endpoints.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>MQTT Adapter Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/mqtt-adapter-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/mqtt-adapter-config/</guid>
+      <description>&lt;p&gt;The MQTT protocol adapter exposes an MQTT topic hierarchy for publishing messages and events to Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry and Event endpoints.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Kura Adapter Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/kura-adapter-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/kura-adapter-config/</guid>
+      <description>&lt;p&gt;The Kura protocol adapter exposes an MQTT topic hierarchy allowing Eclipse Kura&amp;trade; based gateways to publish &lt;em&gt;control&lt;/em&gt; and &lt;em&gt;data&lt;/em&gt; messages to Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry and Event endpoints.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Hono Client Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/hono-client-configuration/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/hono-client-configuration/</guid>
+      <description>&lt;p&gt;The &lt;code&gt;org.eclipse.hono.client.HonoConnection&lt;/code&gt; factory can be used to create AMQP 1.0 connections to Hono&amp;rsquo;s service components.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>AMQP 1.0 Messaging Network Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-network-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-network-config/</guid>
+      <description>&lt;p&gt;The &lt;em&gt;Qpid Dispatch Router&lt;/em&gt;, together with the &lt;em&gt;Apache Artemis&lt;/em&gt; message broker, serves as the default &lt;em&gt;AMQP 1.0 Messaging Network&lt;/em&gt; that is used in Hono&amp;rsquo;s example deployment as described in the &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/deployment/&#34;&gt;Deployment Guides&lt;/a&gt;.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Secure Communication</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/secure_communication/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/secure_communication/</guid>
+      <description>&lt;p&gt;The individual components of an Eclipse Hono&amp;trade; installation, e.g. the protocol adapters, &lt;em&gt;AMQP Messaging Network&lt;/em&gt;, &lt;em&gt;Hono Auth&lt;/em&gt; etc., and the clients attaching to Hono in order to send and receive data all communicate with each other using AMQP 1.0 over TCP. The Hono components and the clients will usually not be located on the same local network but will probably communicate over public networking infrastructure. For most use cases it is therefore desirable, if not necessary, to provide for confidentiality of the data being transferred between these components. This section describes how Hono supports confidentiality by means of &lt;em&gt;Transport Layer Security&lt;/em&gt; (TLS) and how to configure it.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Monitoring &amp; Tracing</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/monitoring-tracing-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/monitoring-tracing-config/</guid>
+      <description>&lt;p&gt;The individual components of an Eclipse Hono&amp;trade; installation need to work together in order to provide their functionality to devices and applications. Under normal circumstances these interactions work flawlessly. However, due to the nature of distributed systems, any one (or more) of the components may crash or become otherwise unavailable due to arbitrary reasons. This page describes how Hono supports operations teams by providing insights into the individual service components and their interactions with each other by means of reporting metrics and tracing the processing of individual messages through the system.&lt;/p&gt;</description>
+    </item>
+    
+  </channel>
+</rss>
\ No newline at end of file
diff --git a/docs/1.2/admin-guide/kura-adapter-config/index.html b/docs/1.2/admin-guide/kura-adapter-config/index.html
new file mode 100644
index 0000000..a7bf51f
--- /dev/null
+++ b/docs/1.2/admin-guide/kura-adapter-config/index.html
@@ -0,0 +1,2702 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Kura Adapter Configuration :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Kura Adapter Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Kura Adapter Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/admin-guide/kura-adapter-config//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item active">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/admin-guide/kura-adapter-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/kura-adapter-config/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/admin-guide/kura-adapter-config/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/admin-guide/kura-adapter-config/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/admin-guide/kura-adapter-config/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/admin-guide/kura-adapter-config.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/admin-guide/'>Admin Guide</a> > Kura Adapter Configuration
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#service-configuration">Service Configuration</a></li>
+<li><a href="#port-configuration">Port Configuration</a>
+<ul>
+<li><a href="#secure-port-only">Secure Port Only</a></li>
+<li><a href="#insecure-port-only">Insecure Port Only</a></li>
+<li><a href="#dual-port">Dual Port</a></li>
+<li><a href="#ephemeral-ports">Ephemeral Ports</a></li>
+</ul></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Kura Adapter Configuration</h1>
+          
+
+        
+
+
+<p>The Kura protocol adapter exposes an MQTT topic hierarchy allowing Eclipse Kura&trade; based gateways to publish <em>control</em> and <em>data</em> messages to Eclipse Hono&trade;&rsquo;s Telemetry and Event endpoints.</p>
+
+<p>The adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding <a href="https://hub.docker.com/r/eclipse/hono-adapter-kura/">Docker image</a> created from it.</p>
+
+<p>The adapter supports the following standard configuration options:</p>
+
+<ul>
+<li><a href="/hono/docs/1.2/admin-guide/common-config/#java-vm-options">Common Java VM Options</a></li>
+<li><a href="/hono/docs/1.2/admin-guide/common-config/#vert-x-options">Common vert.x Options</a></li>
+<li><a href="/hono/docs/1.2/admin-guide/common-config/#protocol-adapter-options">Common Protocol Adapter Options</a></li>
+<li><a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">Monitoring Options</a></li>
+</ul>
+
+<h2 id="service-configuration">Service Configuration</h2>
+
+<p>The following table provides an overview of the configuration variables and corresponding command line options for configuring the MQTT adapter.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="center">Mandatory</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>HONO_APP_MAX_INSTANCES</code><br><code>--hono.app.maxInstances</code></td>
+<td align="center">no</td>
+<td align="left"><em>#CPU cores</em></td>
+<td align="left">The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_AUTHENTICATION_REQUIRED</code><br><code>--hono.kura.authenticationRequired</code></td>
+<td align="center">no</td>
+<td align="left"><code>true</code></td>
+<td align="left">If set to <code>true</code> the protocol adapter requires devices to authenticate when connecting to the adapter. The credentials provided by the device are verified using the configured <a href="#credentials-service-connection-configuration">Credentials Service</a>. Devices that have failed to authenticate are not allowed to publish any data.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_BIND_ADDRESS</code><br><code>--hono.kura.bindAddress</code></td>
+<td align="center">no</td>
+<td align="left"><code>127.0.0.1</code></td>
+<td align="left">The IP address of the network interface that the secure port should be bound to.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_CERT_PATH</code><br><code>--hono.kura.certPath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the PEM file containing the certificate that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with <code>HONO_KURA_KEY_PATH</code>.<br>Alternatively, the <code>HONO_KURA_KEY_STORE_PATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_CONTROL_PREFIX</code><br><code>--hono.kura.controlPrefix</code></td>
+<td align="center">no</td>
+<td align="left"><code>$EDC</code></td>
+<td align="left">The <em>topic.control-prefix</em> to use for determining if a message published by a Kura gateway is a <em>control</em> message. All messages published to a topic that does not start with this prefix are considered <em>data</em> messages.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_CTRL_MSG_CONTENT_TYPE</code><br><code>--hono.kura.ctrlMsgContentType</code></td>
+<td align="center">no</td>
+<td align="left"><code>application/vnd.eclipse.kura-control</code></td>
+<td align="left">The content type to set on AMQP messages created from Kura <em>control</em> messages.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_DATA_MSG_CONTENT_TYPE</code><br><code>--hono.kura.dataMsgContentType</code></td>
+<td align="center">no</td>
+<td align="left"><code>application/vnd.eclipse.kura-data</code></td>
+<td align="left">The content type to set on AMQP messages created from Kura <em>data</em> messages.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_DEFAULTS_ENABLED</code><br><code>--hono.kura.defaultsEnabled</code></td>
+<td align="center">no</td>
+<td align="left"><code>true</code></td>
+<td align="left">If set to <code>true</code> the protocol adapter uses <em>default values</em> registered for a device to augment messages published by the device with missing information like a content type. In particular, the protocol adapter adds default values registered for the device as (application) properties with the same name to the AMQP 1.0 messages it sends downstream to the AMQP Messaging Network.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_INSECURE_PORT</code><br><code>--hono.kura.insecurePort</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The insecure port the protocol adapter should listen on.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_INSECURE_PORT_BIND_ADDRESS</code><br><code>--hono.kura.insecurePortBindAddress</code></td>
+<td align="center">no</td>
+<td align="left"><code>127.0.0.1</code></td>
+<td align="left">The IP address of the network interface that the insecure port should be bound to.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_INSECURE_PORT_ENABLED</code><br><code>--hono.kura.insecurePortEnabled</code></td>
+<td align="center">no</td>
+<td align="left"><code>false</code></td>
+<td align="left">If set to <code>true</code> the protocol adapter will open an insecure port (not secured by TLS) using either the port number set via <code>HONO_KURA_INSECURE_PORT</code> or the default MQTT port number (<code>1883</code>) if not set explicitly.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_KEY_PATH</code><br><code>--hono.kura.keyPath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the (PKCS8) PEM file containing the private key that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with <code>HONO_KURA_CERT_PATH</code>. Alternatively, the <code>HONO_KURA_KEY_STORE_PATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_KEY_STORE_PASSWORD</code><br><code>--hono.kura.keyStorePassword</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The password required to read the contents of the key store.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_KEY_STORE_PATH</code><br><code>--hono.kura.keyStorePath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the Java key store containing the private key and certificate that the protocol adapter should use for authenticating to clients. Either this option or the <code>HONO_KURA_KEY_PATH</code> and <code>HONO_KURA_CERT_PATH</code> options need to be set in order to enable TLS secured connections with clients. The key store format can be either <code>JKS</code> or <code>PKCS12</code> indicated by a <code>.jks</code> or <code>.p12</code> file suffix respectively.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_SNI</code><br><code>--hono.kura.sni</code></td>
+<td align="center">no</td>
+<td align="left"><code>false</code></td>
+<td align="left">Set whether the server supports Server Name Indication. By default, the server will not support SNI and the option is <code>false</code>. However, if set to <code>true</code> then the key store format , <code>HONO_KURA_KEY_STORE_PATH</code>,  should be either <code>JKS</code> or <code>PKCS12</code> indicated by a <code>.jks</code> or <code>.p12</code> file suffix respectively.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_MAX_PAYLOAD_SIZE</code><br><code>--hono.kura.maxPayloadSize</code></td>
+<td align="center">no</td>
+<td align="left"><code>2048</code></td>
+<td align="left">The maximum allowed size of an incoming MQTT message&rsquo;s payload in bytes. When a client sends a message with a larger payload, the message is discarded and the connection to the client gets closed.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_NATIVE_TLS_REQUIRED</code><br><code>--hono.kura.nativeTlsRequired</code></td>
+<td align="center">no</td>
+<td align="left"><code>false</code></td>
+<td align="left">The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM&rsquo;s default SSL engine if not available. However, if set to <code>true</code>, the server will fail to start at all in this case.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_PORT</code><br><code>--hono.kura.port</code></td>
+<td align="center">no</td>
+<td align="left"><code>8883</code></td>
+<td align="left">The secure port that the protocol adapter should listen on.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_SECURE_PROTOCOLS</code><br><code>--hono.kura.secureProtocols</code></td>
+<td align="center">no</td>
+<td align="left"><code>TLSv1.2</code></td>
+<td align="left">A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the <a href="https://vertx.io/docs/vertx-core/java/#ssl">vert.x documentation</a> for a list of supported protocol names.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_TENANT_IDLE_TIMEOUT</code><br><code>--hono.kura.tenantIdleTimeout</code></td>
+<td align="center">no</td>
+<td align="left"><code>0ms</code></td>
+<td align="left">The duration after which the protocol adapter removes local state of the tenant (e.g. open AMQP links) with an amount and a unit, e.g. <code>2h</code> for 2 hours. See the <a href="https://docs.spring.io/spring-boot/docs/current/reference/html/spring-boot-features.html#boot-features-external-config-conversion-duration">Spring Boot documentation</a> for an explanation of the format. The value <code>0ms</code> disables the timeout.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The variables only need to be set if the default values do not match your environment.</p>
+
+<h2 id="port-configuration">Port Configuration</h2>
+
+<p>The Kura protocol adapter can be configured to listen for connections on</p>
+
+<ul>
+<li>a secure port only (default) or</li>
+<li>an insecure port only or</li>
+<li>both a secure and an insecure port (dual port configuration)</li>
+</ul>
+
+<p>The Kura protocol adapter will fail to start if none of the ports is configured properly.</p>
+
+<h3 id="secure-port-only">Secure Port Only</h3>
+
+<p>The protocol adapter needs to be configured with a private key and certificate in order to open a TLS secured port.</p>
+
+<p>There are two alternative ways for doing so:</p>
+
+<ol>
+<li>either setting the <code>HONO_KURA_KEY_STORE_PATH</code> and the <code>HONO_KURA_KEY_STORE_PASSWORD</code> variables in order to load the key &amp; certificate from a password protected key store, or</li>
+<li>setting the <code>HONO_KURA_KEY_PATH</code> and <code>HONO_KURA_CERT_PATH</code> variables in order to load the key and certificate from two separate PEM files in PKCS8 format.</li>
+</ol>
+
+<p>When starting up, the protocol adapter will bind a TLS secured socket to the default secure MQTT port 8883. The port number can also be set explicitly using the <code>HONO_KURA_PORT</code> variable.</p>
+
+<p>The <code>HONO_KURA_BIND_ADDRESS</code> variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the <em>loopback device</em> only, i.e. the port will only be accessible from the local host. Setting this variable to <code>0.0.0.0</code> will let the port being bound to <strong>all</strong> network interfaces (be careful not to expose the port unintentionally to the outside world).</p>
+
+<h3 id="insecure-port-only">Insecure Port Only</h3>
+
+<p>The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by</p>
+
+<ul>
+<li>explicitly setting <code>HONO_KURA_INSECURE_PORT</code> to a valid port number, or by</li>
+<li>implicitly configuring the default MQTT port (1883) by simply setting <code>HONO_KURA_INSECURE_PORT_ENABLED</code> to <code>true</code>.</li>
+</ul>
+
+<p>The protocol adapter issues a warning on the console if <code>HONO_KURA_INSECURE_PORT</code> is set to the default secure MQTT port (8883).</p>
+
+<p>The <code>HONO_KURA_INSECURE_PORT_BIND_ADDRESS</code> variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the <em>loopback device</em> only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.</p>
+
+<p>Setting this variable to <code>0.0.0.0</code> will let the port being bound to <strong>all</strong> network interfaces (be careful not to expose the port unintentionally to the outside world).</p>
+
+<h3 id="dual-port">Dual Port</h3>
+
+<p>The protocol adapter may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.</p>
+
+<h3 id="ephemeral-ports">Ephemeral Ports</h3>
+
+<p>Both the secure as well as the insecure port numbers may be explicitly set to <code>0</code>. The protocol adapter will then use arbitrary (unused) port numbers determined by the operating system during startup.</p>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/admin-guide/monitoring-tracing-config/index.html b/docs/1.2/admin-guide/monitoring-tracing-config/index.html
new file mode 100644
index 0000000..1734aeb
--- /dev/null
+++ b/docs/1.2/admin-guide/monitoring-tracing-config/index.html
@@ -0,0 +1,2684 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Monitoring & Tracing :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Monitoring &amp; Tracing :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Monitoring &amp; Tracing :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/admin-guide/monitoring-tracing-config//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item active">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/admin-guide/monitoring-tracing-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/admin-guide/monitoring-tracing-config/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/admin-guide/monitoring-tracing-config/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/admin-guide/monitoring-tracing-config/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/admin-guide/monitoring-tracing-config.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/admin-guide/'>Admin Guide</a> > Monitoring & Tracing
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#monitoring">Monitoring</a>
+<ul>
+<li><a href="#configuring-a-metrics-back-end">Configuring a Metrics Back End</a></li>
+<li><a href="#using-prometheus">Using Prometheus</a></li>
+</ul></li>
+<li><a href="#health-check-server-configuration">Health Check Server Configuration</a></li>
+<li><a href="#tracing">Tracing</a>
+<ul>
+<li><a href="#configuring-a-tracer">Configuring a Tracer</a></li>
+</ul></li>
+<li><a href="#configuring-usage-of-jaeger-tracing-included-in-docker-images">Configuring usage of Jaeger tracing (included in Docker images)</a></li>
+<li><a href="#enforcing-the-recording-of-traces-for-a-tenant">Enforcing the recording of traces for a tenant</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Monitoring &amp; Tracing</h1>
+          
+
+        
+
+
+<p>The individual components of an Eclipse Hono&trade; installation need to work together in order to provide their functionality to devices and applications. Under normal circumstances these interactions work flawlessly. However, due to the nature of distributed systems, any one (or more) of the components may crash or become otherwise unavailable due to arbitrary reasons. This page describes how Hono supports operations teams by providing insights into the individual service components and their interactions with each other by means of reporting metrics and tracing the processing of individual messages through the system.</p>
+
+<p>When a device uploads telemetry data to the HTTP adapter, the adapter invokes operations on the Device Registration, Credentials and the Tenant services in order to authenticate and authorize the device before sending the telemetry data downstream to the AMQP 1.0 Messaging Network. The overall success of this process and the latency involved before the message reaches the consumer is determined by the individual interactions between the service components.</p>
+
+<h2 id="monitoring">Monitoring</h2>
+
+<p>In a production environment, an operations team will usually want to keep track of some <em>key performance indicators</em> (KPI) which allow the team to determine the overall <em>health</em> of the system, e.g. memory and CPU consumption etc. Hono supports the tracking of such KPIs by means of metrics it can be configured to report. The metrics are usually collected in a time series database like <em>InfluxDB</em> or <em>Prometheus</em> and then visualized on a monitoring dash-board built using frameworks like <em>Grafana</em>. Such a dash-board can usually also be configured to send alarms when certain thresholds are exceeded.</p>
+
+<p>Metrics usually provide insights into the past and current status of an individual component. The values can be aggregated to provide a picture of the overall system&rsquo;s status. As such, metrics provide a great way to <em>monitor</em> system health and, in particular, to anticipate resource shortages and use such knowledge to pro-actively prevent system failure.</p>
+
+<h3 id="configuring-a-metrics-back-end">Configuring a Metrics Back End</h3>
+
+<p>Hono uses <a href="http://micrometer.io/">Micrometer</a> for providing metrics. It is
+possible to drop in any Micrometer compatible back end. Hono also uses the
+Micrometer integration with Spring Boot and Vert.x.</p>
+
+<p>Please refer to the <a href="http://micrometer.io/docs">Micrometer documentation</a>
+for details regarding the configuration of a specific Micrometer back end.
+In most cases, you only need to add the back end specific jar files to the class path and
+add back end specific configuration to the <code>application.yml</code> file.</p>
+
+<p>The Hono build supports configuration of a specific metrics back end by means
+of Maven profiles. The following build profiles are currently supported:</p>
+
+<ul>
+<li><code>metrics-prometheus</code> – Enables the Prometheus backend.</li>
+<li><code>metrics-graphite</code> – Enables the Graphite backend.</li>
+<li><code>metrics-influxdb</code> – Enables the InfluxDB backend.</li>
+</ul>
+
+<p>Additionally to selecting a metrics back end, you may need to configure the
+back end using Spring configuration options. See the documentation mentioned
+above for more information.</p>
+
+<p>Note that none of the above profiles are active by default, i.e. you need to
+explicitly activate one of them when starting the build using Maven&rsquo;s <code>-p</code>
+command line parameter.</p>
+
+<h3 id="using-prometheus">Using Prometheus</h3>
+
+<p>Most of the metrics back ends have data being <em>pushed</em> to from the components
+reporting the metrics. However, Prometheus is different in that it <em>polls</em>
+(or <em>scrapes</em>) all components periodically for new metrics data.
+For this to work, the Prometheus server needs to be configured with the IP
+addresses of the components to monitor. In the example deployment that comes
+with Hono, the Prometheus server is configured with the names of the Kubernetes
+services corresponding to the Hono components that it should scrape.
+The components themselves need to expose a corresponding HTTP endpoint that
+the Prometheus server can connect to for scraping the meter data. All
+Hono components that report metrics can be configured to expose such an
+endpoint via their <a href="#health-check-server-configuration"><em>Health Check</em> server</a>
+which already exposes endpoints for determining the component&rsquo;s readiness and liveness status.</p>
+
+<h2 id="health-check-server-configuration">Health Check Server Configuration</h2>
+
+<p>All of Hono&rsquo;s service components and protocol adapters contain a <em>Health Check</em> server which can be configured to
+expose several HTTP endpoints for determining the component&rsquo;s status.
+In particular, the server exposes a <code>/readiness</code>, a <code>/liveness</code> and an optional <code>/prometheus</code> URI endpoint.</p>
+
+<p>The former two endpoints are supposed to be used by container orchestration platforms like Kubernetes to monitor the runtime status of the containers
+that it manages. These endpoints are <em>always</em> exposed when the health check server is started.</p>
+
+<p>The <code>/prometheus</code> endpoint can be used by a Prometheus server to retrieve collected meter data from the component. It is <em>only</em> exposed if Prometheus has
+been configured as the metrics back end as described <a href="#configuring-a-metrics-back-end">above</a>.</p>
+
+<p>The health check server can be configured by means of the following environment variables:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>HONO_HEALTHCHECK_BINDADDRESS</code><br><code>--hono.healthCheck.bindAddress</code></td>
+<td align="left"><code>127.0.0.1</code></td>
+<td align="left">The IP address of the network interface that the health check server&rsquo;s secure port should be bound to. The server will only be started if this property is set to some other than the default value and corresponding key material has been configured using the <code>HONO_HEALTHCHECK_KEYPATH</code> and <code>HONO_HEALTHCHECK_CERTPATH</code> variables.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HEALTHCHECK_CERTPATH</code><br><code>--hono.healthCheck.certPath</code></td>
+<td align="left">-</td>
+<td align="left">The absolute path to the PEM file containing the certificate that the secure server should use for authenticating to clients. This option must be used in conjunction with <code>HONO_HEALTHCHECK_KEYPATH</code>.<br>Alternatively, the <code>HONO_HEALTHCHECK_KEYSTOREPATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HEALTHCHECK_INSECUREPORTBINDADDRESS</code><br><code>--hono.healthCheck.insecurePortBindAddress</code></td>
+<td align="left"><code>127.0.0.1</code></td>
+<td align="left">The IP address of the network interface that the health check server&rsquo;s insecure port should be bound to. The server will only be started if this property is set to some other than the default value.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HEALTHCHECK_INSECUREPORT</code><br><code>--hono.healthCheck.insecurePort</code></td>
+<td align="left"><code>8088</code></td>
+<td align="left">The port that the insecure server should listen on.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HEALTHCHECK_KEYPATH</code><br><code>--hono.healthCheck.keyPath</code></td>
+<td align="left">-</td>
+<td align="left">The absolute path to the (PKCS8) PEM file containing the private key that the secure server should use for authenticating to clients. This option must be used in conjunction with <code>HONO_HEALTHCHECK_CERTPATH</code>. Alternatively, the <code>HONO_HEALTHCHECK_KEYSTOREPATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HEALTHCHECK_PORT</code><br><code>--hono.healthCheck.port</code></td>
+<td align="left"><code>8088</code></td>
+<td align="left">The port that the secure server should listen on.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HEALTHCHECK_KEYSTOREPASSWORD</code><br><code>--hono.healthCheck.keyStorePassword</code></td>
+<td align="left">-</td>
+<td align="left">The password required to read the contents of the key store.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_HEALTHCHECK_KEYSTOREPATH</code><br><code>--hono.healthCheck.keyStorePath</code></td>
+<td align="left">-</td>
+<td align="left">The absolute path to the Java key store containing the private key and certificate that the secure server should use for authenticating to clients. Either this option or the <code>HONO_HEALTHCHECK_KEYPATH</code> and <code>HONO_HEALTHCHECK_CERTPATH</code> options need to be set in order to enable TLS secured connections with clients. The key store format can be either <code>JKS</code> or <code>PKCS12</code> indicated by a <code>.jks</code> or <code>.p12</code> file suffix respectively. The <code>HONO_HEALTHCHECK_KEYSTOREPASSWORD</code> variable can be used to set the password required for reading the key store.</td>
+</tr>
+</tbody>
+</table>
+
+<div class="alert alert-warning">
+    <h4 class="alert-heading"><i class="fas fa-exclamation-triangle"></i> Failure to start</h4>
+    <div>The component/service will fail to start if neither the secure not the insecure server have been configured properly.</div>
+</div>
+
+
+<h2 id="tracing">Tracing</h2>
+
+<p>In normal operation the vast majority of messages should be flowing through the system without any noteworthy delays or problems. In fact, that is the whole purpose of Hono. However, that doesn&rsquo;t mean that nothing can go wrong. For example, when a tenant&rsquo;s device administrator changes the credentials of a device in the Credentials service but has not yet updated the credentials on the device yet, then the device will start to fail in uploading any data to the protocol adapter it connects to. After a while, a back end application&rsquo;s administrator might notice, that there hasn&rsquo;t been any data being received from that particular device for quite some time. The application administrator therefore calls up the Hono operations team and complains about the data <em>being lost somewhere</em>.</p>
+
+<p>The operations team will have a hard time determining what is happening, because it will need to figure out which components have been involved in the processing of the device and why the data hasn&rsquo;t been processed as usual. The metrics alone usually do not help much here because metrics are usually not scoped to individual devices. The logs written by the individual components, on the other hand, might contain enough information to correlate individual entries in the log with each other and thus <em>trace</em> the processing of the message throughout the system. However, this is usually a very tedious (and error prone) process and the relevant information is often only logged at a level (e.g. <em>DEBUG</em>) that is not used in production (often <em>INFO</em> or above).</p>
+
+<p>In order to address this problem, Hono&rsquo;s service components are instrumented using <a href="http://opentracing.io">OpenTracing</a>. OpenTracing provides <em>Vendor-neutral APIs and instrumentation for distributed tracing</em>. The OpenTracing web page provides a <a href="https://opentracing.io/docs/supported-tracers/">list of supported tracer implementations</a> from which users can choose in order to collect (and examine) the tracing information generated by Hono&rsquo;s individual components.</p>
+
+<h3 id="configuring-a-tracer">Configuring a Tracer</h3>
+
+<p><strong>Hint</strong>: The description in this chapter applies to any compatible OpenTracing implementation. For an easier approach to configure usage of <a href="https://www.jaegertracing.io/">Jaeger tracing</a>, see the next chapter.</p>
+
+<p>Hono&rsquo;s components use the <a href="https://github.com/opentracing-contrib/java-tracerresolver">OpenTracing Tracer Resolver</a> mechanism to find and initialize a concrete OpenTracing implementation during startup of the component. The discovery mechanism is using Java&rsquo;s <a href="https://docs.oracle.com/javase/9/docs/api/java/util/ServiceLoader.html">ServiceLoader</a> and as such relies on the required resources to be available on the class path.</p>
+
+<p>When starting up any of Hono&rsquo;s Docker images as a container, the JVM will look for additional jar files to include in its class path in the container&rsquo;s <code>/opt/hono/extensions</code> folder. Thus, using a specific implementation of OpenTracing is just a matter of configuring the container to mount a volume or binding a host folder at that location and putting the implementation&rsquo;s jar files and resources into the corresponding volume or host folder.</p>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Note</h4>
+    <div>This also means that (currently) only Tracer implementations can be used with Hono that also implement the Tracer Resolver mechanism.</div>
+</div>
+
+
+<p>Assuming that the HTTP adapter should be configured to use <a href="https://www.jaegertracing.io/">Jaeger tracing</a>, the following steps are necessary:</p>
+
+<ol>
+<li>Download <a href="https://github.com/jaegertracing/jaeger-client-java/tree/master/jaeger-tracerresolver">Jaeger&rsquo;s Java Tracer Resolver</a> implementation and its dependencies (see the hint at the end).</li>
+<li>Put the jars to a folder on the Docker host, e.g. <code>/tmp/jaeger</code>.</li>
+
+<li><p>Start the HTTP adapter Docker image mounting the host folder:</p>
+
+<pre><code class="language-sh">docker run --name hono-adapter-http-vertx \
+--mount type=bind,src=/tmp/jaeger,dst=/opt/hono/extensions,ro \
+... \
+eclipse/hono-adapter-http-vertx
+</code></pre></li>
+</ol>
+
+<p><strong>Note</strong>: the command given above does not contain the environment variables and secrets that are required to configure the service properly. The environment variables for configuring the Jaeger client are also missing. Please refer to the <a href="https://github.com/jaegertracing/jaeger-client-java/blob/master/jaeger-core/README.md">Jaeger documentation</a> for details.</p>
+
+<p>When the HTTP adapter starts up, it will look for a working implementation of the Tracer Resolver on its classpath and (if found) initialize and use it for publishing traces. The adapter&rsquo;s log file will indicate the name of the Tracer implementation being used.</p>
+
+<p>Using a Docker <em>volume</em> instead of a <em>bind mount</em> works the same way but requires the use of <code>volume</code> as the <em>type</em> of the <code>--mount</code> parameter. Please refer to the <a href="https://docs.docker.com/edge/engine/reference/commandline/service_create/#add-bind-mounts-volumes-or-memory-filesystems">Docker reference documentation</a> for details.</p>
+
+<p><strong>Hint</strong>: to resolve all dependencies for <code>jaeger-tracerresolver</code> in order to provide them to <code>/opt/hono/extensions</code>, you may want to rely on Maven&rsquo;s dependency plugin. To obtain all jar files you can invoke the following command in a simple Maven project that contains only the dependency to <code>jaeger-tracerresolver</code>:</p>
+
+<pre><code class="language-sh">mvn dependency:copy-dependencies
+</code></pre>
+
+<p>All jar files can then be found in the directory <code>target/dependency</code>.</p>
+
+<h2 id="configuring-usage-of-jaeger-tracing-included-in-docker-images">Configuring usage of Jaeger tracing (included in Docker images)</h2>
+
+<p>In case <a href="https://www.jaegertracing.io/">Jaeger tracing</a> shall be used, there is an alternative to putting the jar files in the container&rsquo;s <code>/opt/hono/extensions</code> folder as described above.
+This is to have the Jaeger tracing jar files be included in the Hono Docker images by using the <code>jaeger</code> Maven profile when building Hono.</p>
+
+<p>For example, building the HTTP adapter image with the Jaeger client included:</p>
+
+<pre><code class="language-sh"># in directory: hono/adapters/http-vertx/
+mvn clean install -Pbuild-docker-image,jaeger
+</code></pre>
+
+<p>Note that when running the created docker image, the environment variables for configuring the Jaeger client still need to be set. Please refer to the <a href="https://github.com/jaegertracing/jaeger-client-java/blob/master/jaeger-core/README.md">Jaeger documentation</a> for details.</p>
+
+<h2 id="enforcing-the-recording-of-traces-for-a-tenant">Enforcing the recording of traces for a tenant</h2>
+
+<p>Typically, in production systems, the tracing components will be configured to not store <em>all</em> trace spans in the tracing backend, in order to reduce the performance impact. For debugging purposes it can however be beneficial to enforce the recording of certain traces. Hono allows this by providing a configuration option in the Tenant information with which all traces concerning the processing of telemetry, event and command messages for that specific tenant will be recorded. Furthermore, this enforced trace sampling can be restricted to only apply to messages sent in the context of a specific authentication identifier. Please refer to the <a href="/hono/docs/1.2/api/tenant/#tracing-format">description of the <code>tracing</code> object</a> in the Tenant Information for details.</p>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/admin-guide/mqtt-adapter-config/index.html b/docs/1.2/admin-guide/mqtt-adapter-config/index.html
new file mode 100644
index 0000000..30baf18
--- /dev/null
+++ b/docs/1.2/admin-guide/mqtt-adapter-config/index.html
@@ -0,0 +1,2695 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>MQTT Adapter Configuration :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="MQTT Adapter Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="MQTT Adapter Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/admin-guide/mqtt-adapter-config//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item active">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/admin-guide/mqtt-adapter-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/admin-guide/mqtt-adapter-config/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/admin-guide/mqtt-adapter-config/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/admin-guide/mqtt-adapter-config/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/admin-guide/mqtt-adapter-config.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/admin-guide/'>Admin Guide</a> > MQTT Adapter Configuration
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#service-configuration">Service Configuration</a></li>
+<li><a href="#port-configuration">Port Configuration</a>
+<ul>
+<li><a href="#secure-port-only">Secure Port Only</a></li>
+<li><a href="#insecure-port-only">Insecure Port Only</a></li>
+<li><a href="#dual-port">Dual Port</a></li>
+<li><a href="#ephemeral-ports">Ephemeral Ports</a></li>
+</ul></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>MQTT Adapter Configuration</h1>
+          
+
+        
+
+
+<p>The MQTT protocol adapter exposes an MQTT topic hierarchy for publishing messages and events to Eclipse Hono&trade;&rsquo;s Telemetry and Event endpoints.</p>
+
+<p>The adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding <a href="https://hub.docker.com/r/eclipse/hono-adapter-mqtt-vertx/">Docker image</a> created from it.</p>
+
+<p>The adapter supports the following standard configuration options:</p>
+
+<ul>
+<li><a href="/hono/docs/1.2/admin-guide/common-config/#java-vm-options">Common Java VM Options</a></li>
+<li><a href="/hono/docs/1.2/admin-guide/common-config/#vert-x-options">Common vert.x Options</a></li>
+<li><a href="/hono/docs/1.2/admin-guide/common-config/#protocol-adapter-options">Common Protocol Adapter Options</a></li>
+<li><a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">Monitoring Options</a></li>
+</ul>
+
+<h2 id="service-configuration">Service Configuration</h2>
+
+<p>The following table provides an overview of the configuration variables and corresponding command line options for configuring the MQTT adapter.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="center">Mandatory</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>HONO_APP_MAX_INSTANCES</code><br><code>--hono.app.maxInstances</code></td>
+<td align="center">no</td>
+<td align="left"><em>#CPU cores</em></td>
+<td align="left">The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_CONNECTION_EVENTS_PRODUCER</code><br><code>--hono.connectionEvents.producer</code></td>
+<td align="center">no</td>
+<td align="left"><code>logging</code></td>
+<td align="left">The implementation of <em>connection events</em> producer which is to be used. This may be <code>logging</code> or <code>events</code>.<br>See <a href="/hono/docs/1.2/concepts/connection-events/">Connection Events</a></td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_AUTHENTICATION_REQUIRED</code><br><code>--hono.mqtt.authenticationRequired</code></td>
+<td align="center">no</td>
+<td align="left"><code>true</code></td>
+<td align="left">If set to <code>true</code> the protocol adapter requires devices to authenticate when connecting to the adapter. The credentials provided by the device are verified using the configured <a href="#credentials-service-connection-configuration">Credentials Service</a>. Devices that have failed to authenticate are not allowed to publish any data.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_BIND_ADDRESS</code><br><code>--hono.mqtt.bindAddress</code></td>
+<td align="center">no</td>
+<td align="left"><code>127.0.0.1</code></td>
+<td align="left">The IP address of the network interface that the secure port should be bound to.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_CERT_PATH</code><br><code>--hono.mqtt.certPath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the PEM file containing the certificate that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with <code>HONO_MQTT_KEY_PATH</code>.<br>Alternatively, the <code>HONO_MQTT_KEY_STORE_PATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_COMMAND_ACK_TIMEOUT</code><br><code>--hono.mqtt.commandAckTimeout</code></td>
+<td align="center">no</td>
+<td align="left"><code>100</code></td>
+<td align="left">The amount of time (milliseconds) after which the sending of a command to a device using QoS 1 is considered to be failed. The value of this variable should be increased in cases where devices are connected over a network with high latency.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_DEFAULTS_ENABLED</code><br><code>--hono.mqtt.defaultsEnabled</code></td>
+<td align="center">no</td>
+<td align="left"><code>true</code></td>
+<td align="left">If set to <code>true</code> the protocol adapter uses <em>default values</em> registered for a device to augment messages published by the device with missing information like a content type. In particular, the protocol adapter adds default values registered for the device as (application) properties with the same name to the AMQP 1.0 messages it sends downstream to the AMQP Messaging Network.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_INSECURE_PORT_BIND_ADDRESS</code><br><code>--hono.mqtt.insecurePortBindAddress</code></td>
+<td align="center">no</td>
+<td align="left"><code>127.0.0.1</code></td>
+<td align="left">The IP address of the network interface that the insecure port should be bound to.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_INSECURE_PORT_ENABLED</code><br><code>--hono.mqtt.insecurePortEnabled</code></td>
+<td align="center">no</td>
+<td align="left"><code>false</code></td>
+<td align="left">If set to <code>true</code> the protocol adapter will open an insecure port (not secured by TLS) using either the port number set via <code>HONO_MQTT_INSECURE_PORT</code> or the default MQTT port number (<code>1883</code>) if not set explicitly.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_KEY_PATH</code><br><code>--hono.mqtt.keyPath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the (PKCS8) PEM file containing the private key that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with <code>HONO_MQTT_CERT_PATH</code>. Alternatively, the <code>HONO_MQTT_KEY_STORE_PATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_KEY_STORE_PASSWORD</code><br><code>--hono.mqtt.keyStorePassword</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The password required to read the contents of the key store.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_KEY_STORE_PATH</code><br><code>--hono.mqtt.keyStorePath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the Java key store containing the private key and certificate that the protocol adapter should use for authenticating to clients. Either this option or the <code>HONO_MQTT_KEY_PATH</code> and <code>HONO_MQTT_CERT_PATH</code> options need to be set in order to enable TLS secured connections with clients. The key store format can be either <code>JKS</code> or <code>PKCS12</code> indicated by a <code>.jks</code> or <code>.p12</code> file suffix respectively.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_SNI</code><br><code>--hono.mqtt.sni</code></td>
+<td align="center">no</td>
+<td align="left"><code>false</code></td>
+<td align="left">Set whether the server supports Server Name Indication. By default, the server will not support SNI and the option is <code>false</code>. However, if set to <code>true</code> then the key store format , <code>HONO_MQTT_KEY_STORE_PATH</code>,  should be either <code>JKS</code> or <code>PKCS12</code> indicated by a <code>.jks</code> or <code>.p12</code> file suffix respectively.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_MAX_CONNECTIONS</code><br><code>--hono.mqtt.maxConnections</code></td>
+<td align="center">no</td>
+<td align="left"><code>0</code></td>
+<td align="left">The maximum number of concurrent connections that the protocol adapter should accept. If not set (or set to <code>0</code>), the protocol adapter determines a reasonable value based on the available resources like memory and CPU.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_MAX_PAYLOAD_SIZE</code><br><code>--hono.mqtt.maxPayloadSize</code></td>
+<td align="center">no</td>
+<td align="left"><code>2048</code></td>
+<td align="left">The maximum allowed size of an incoming MQTT message&rsquo;s payload in bytes. When a client sends a message with a larger payload, the message is discarded and the connection to the client gets closed.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_NATIVE_TLS_REQUIRED</code><br><code>--hono.mqtt.nativeTlsRequired</code></td>
+<td align="center">no</td>
+<td align="left"><code>false</code></td>
+<td align="left">The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM&rsquo;s default SSL engine if not available. However, if set to <code>true</code>, the server will fail to start at all in this case.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_PORT</code><br><code>--hono.mqtt.port</code></td>
+<td align="center">no</td>
+<td align="left"><code>8883</code></td>
+<td align="left">The secure port that the protocol adapter should listen on.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_SECURE_PROTOCOLS</code><br><code>--hono.mqtt.secureProtocols</code></td>
+<td align="center">no</td>
+<td align="left"><code>TLSv1.2</code></td>
+<td align="left">A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the <a href="https://vertx.io/docs/vertx-core/java/#ssl">vert.x documentation</a> for a list of supported protocol names.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_TENANT_IDLE_TIMEOUT</code><br><code>--hono.mqtt.tenantIdleTimeout</code></td>
+<td align="center">no</td>
+<td align="left"><code>0ms</code></td>
+<td align="left">The duration after which the protocol adapter removes local state of the tenant (e.g. open AMQP links) with an amount and a unit, e.g. <code>2h</code> for 2 hours. See the <a href="https://docs.spring.io/spring-boot/docs/current/reference/html/spring-boot-features.html#boot-features-external-config-conversion-duration">Spring Boot documentation</a> for an explanation of the format. The value <code>0ms</code> disables the timeout.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The variables only need to be set if the default values do not match your environment.</p>
+
+<h2 id="port-configuration">Port Configuration</h2>
+
+<p>The MQTT protocol adapter can be configured to listen for connections on</p>
+
+<ul>
+<li>a secure port only (default) or</li>
+<li>an insecure port only or</li>
+<li>both a secure and an insecure port (dual port configuration)</li>
+</ul>
+
+<p>The MQTT protocol adapter will fail to start if none of the ports is configured properly.</p>
+
+<h3 id="secure-port-only">Secure Port Only</h3>
+
+<p>The protocol adapter needs to be configured with a private key and certificate in order to open a TLS secured port.</p>
+
+<p>There are two alternative ways for doing so:</p>
+
+<ol>
+<li>either setting the <code>HONO_MQTT_KEY_STORE_PATH</code> and the <code>HONO_MQTT_KEY_STORE_PASSWORD</code> variables in order to load the key &amp; certificate from a password protected key store, or</li>
+<li>setting the <code>HONO_MQTT_KEY_PATH</code> and <code>HONO_MQTT_CERT_PATH</code> variables in order to load the key and certificate from two separate PEM files in PKCS8 format.</li>
+</ol>
+
+<p>When starting up, the protocol adapter will bind a TLS secured socket to the default secure MQTT port 8883. The port number can also be set explicitly using the <code>HONO_MQTT_PORT</code> variable.</p>
+
+<p>The <code>HONO_MQTT_BIND_ADDRESS</code> variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the <em>loopback device</em> only, i.e. the port will only be accessible from the local host. Setting this variable to <code>0.0.0.0</code> will let the port being bound to <strong>all</strong> network interfaces (be careful not to expose the port unintentionally to the outside world).</p>
+
+<h3 id="insecure-port-only">Insecure Port Only</h3>
+
+<p>The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by</p>
+
+<ul>
+<li>explicitly setting <code>HONO_MQTT_INSECURE_PORT</code> to a valid port number, or by</li>
+<li>implicitly configuring the default MQTT port (1883) by simply setting <code>HONO_MQTT_INSECURE_PORT_ENABLED</code> to <code>true</code>.</li>
+</ul>
+
+<p>The protocol adapter issues a warning on the console if <code>HONO_MQTT_INSECURE_PORT</code> is set to the default secure MQTT port (8883).</p>
+
+<p>The <code>HONO_MQTT_INSECURE_PORT_BIND_ADDRESS</code> variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the <em>loopback device</em> only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.</p>
+
+<p>Setting this variable to <code>0.0.0.0</code> will let the port being bound to <strong>all</strong> network interfaces (be careful not to expose the port unintentionally to the outside world).</p>
+
+<h3 id="dual-port">Dual Port</h3>
+
+<p>The protocol adapter may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.</p>
+
+<h3 id="ephemeral-ports">Ephemeral Ports</h3>
+
+<p>Both the secure as well as the insecure port numbers may be explicitly set to <code>0</code>. The protocol adapter will then use arbitrary (unused) port numbers determined by the operating system during startup.</p>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/admin-guide/secure_communication/index.html b/docs/1.2/admin-guide/secure_communication/index.html
new file mode 100644
index 0000000..21a3137
--- /dev/null
+++ b/docs/1.2/admin-guide/secure_communication/index.html
@@ -0,0 +1,2812 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Secure Communication :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Secure Communication :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Secure Communication :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/admin-guide/secure_communication//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/admin-guide/secure_communication/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item active">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/admin-guide/secure_communication/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/secure_communication/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/admin-guide/secure_communication/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/admin-guide/secure_communication/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/admin-guide/secure_communication/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/admin-guide/secure_communication.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/admin-guide/'>Admin Guide</a> > Secure Communication
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#enabling-tls">Enabling TLS</a>
+<ul>
+<li><a href="#auth-server">Auth Server</a></li>
+<li><a href="#dispatch-router">Dispatch Router</a></li>
+<li><a href="#device-registry">Device Registry</a></li>
+<li><a href="#http-adapter">HTTP Adapter</a></li>
+<li><a href="#mqtt-adapter">MQTT Adapter</a></li>
+<li><a href="#kura-adapter">Kura Adapter</a></li>
+<li><a href="#client-application">Client Application</a></li>
+</ul></li>
+<li><a href="#using-openssl">Using OpenSSL</a>
+<ul>
+<li><a href="#configuring-containers">Configuring Containers</a></li>
+</ul></li>
+<li><a href="#server-name-indication-sni">Server Name Indication (SNI)</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Secure Communication</h1>
+          
+
+        
+
+
+<p>The individual components of an Eclipse Hono&trade; installation, e.g. the protocol adapters, <em>AMQP Messaging Network</em>, <em>Hono Auth</em> etc., and the clients attaching to Hono in order to send and receive data all communicate with each other using AMQP 1.0 over TCP. The Hono components and the clients will usually not be located on the same local network but will probably communicate over public networking infrastructure. For most use cases it is therefore desirable, if not necessary, to provide for confidentiality of the data being transferred between these components. This section describes how Hono supports confidentiality by means of <em>Transport Layer Security</em> (TLS) and how to configure it.</p>
+
+<h2 id="enabling-tls">Enabling TLS</h2>
+
+<p>All of Hono&rsquo;s components can be configured to use TLS for establishing an encrypted communication channel with peers. When a client initiates a connection with a server, the TLS handshake protocol is used to negotiate parameters of a secure channel to be used for exchanging data. The most important of those parameters is a secret (symmetric) encryption key that is only known to the client and the server and which is used to transparently encrypt all data being sent over the connection as long as the connection exists. With each new connection, a new secret key is negotiated.</p>
+
+<p>Using TLS in this way requires configuring the server component with a cryptographic <em>private/public key</em> pair and a <em>certificate</em> which <em>binds</em> an <em>identity claim</em> to the public key. It is out of scope of this document to describe the full process of creating such a key pair and acquiring a corresponding certificate. The <code>demo-certs</code> module already contains a set of keys and certificates to be used for evaluation and demonstration purposes. Throughout the rest of this section we will use these keys and certificates . Please refer to the <code>demo-certs/README.md</code> file for details regarding how to create your own keys and certificates.</p>
+
+<p>Within a Hono installation the following communication channels can be secured with TLS:</p>
+
+<ol>
+<li>Applications connecting to <em>Dispatch Router</em> - Client applications consuming e.g. Telemetry data from Hono connect to the AMQP Messaging Network. This connection can be secured by configuring the client and the messaging network for TLS.</li>
+<li><em>Device Registry</em> connecting to <em>Auth Server</em> - The Device Registry connects to the Auth Server in order to verify client credentials and determine the client&rsquo;s authorities. This (internal) connection can (should) be secured by configuring the Auth Server and Device Registry for TLS.</li>
+<li><em>Protocol Adapter</em> to <em>Device Registry</em> - A protocol adapter connects to the Device Registry in order to retrieve assertions regarding the registration status of devices. This (internal) connection can be secured by configuring the protocol adapter and the Device Registry for TLS.</li>
+<li><em>Protocol Adapter</em> connecting to <em>AMQP Messaging Network</em> - A protocol adapter connects to the messaging network in order to forward telemetry data and commands hence and forth between downstream components (client applications) and devices. This (internal) connection can be secured by configuring the Dispatch Router and the protocol adapters for TLS.</li>
+<li><em>Devices</em> connecting to a <em>Protocol Adapter</em> - Devices use TLS to both authenticate the protocol adapter and to establish an encrypted channel that provides integrity and privacy when transmitting data. Note that the specifics of if and how TLS can be used with a particular protocol adapter is specific to the transport protocol the adapter uses for communicating with the devices.</li>
+<li><em>Liveness/readiness probes</em> connecting to <em>Service Health Checks</em> - Systems like Kubernetes are periodically checking the health status of the individual services . This communication can be secured by configuring the health check of the individual services to expose a secure endpoint.</li>
+</ol>
+
+<h3 id="auth-server">Auth Server</h3>
+
+<p>The Auth Server supports the use of TLS for connections to clients. Please refer to the <a href="/hono/docs/1.2/admin-guide/auth-server-config/">Auth Server admin guide</a> for details regarding the required configuration steps.</p>
+
+<p>The <code>demo-certs/certs</code> folder includes the following demo keys and certificates to be used with the Auth Server for that purpose.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">File</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>auth-server-key.pem</code></td>
+<td align="left">The example private key for creating signatures.</td>
+</tr>
+
+<tr>
+<td align="left"><code>auth-server-cert.pem</code></td>
+<td align="left">The example certificate asserting the server&rsquo;s identity.</td>
+</tr>
+
+<tr>
+<td align="left"><code>trusted-certs.pem</code></td>
+<td align="left">Trusted CA certificates to use for verifying signatures.</td>
+</tr>
+</tbody>
+</table>
+
+<h3 id="dispatch-router">Dispatch Router</h3>
+
+<p>The Dispatch Router reads its configuration from a file on startup (the default location is <code>/etc/qpid-dispatch/qdrouterd.conf</code>). Please refer to the <a href="https://qpid.apache.org/components/dispatch-router/index.html">Dispatch Router documentation</a> for details regarding the configuration of TLS/SSL.</p>
+
+<p>The <code>demo-certs/certs</code> folder includes the following demo keys and certificates to be used with the Dispatch Router for that purpose:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">File</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>qdrouter-key.pem</code></td>
+<td align="left">The example private key for creating signatures.</td>
+</tr>
+
+<tr>
+<td align="left"><code>qdrouter-cert.pem</code></td>
+<td align="left">The example certificate asserting the server&rsquo;s identity.</td>
+</tr>
+
+<tr>
+<td align="left"><code>trusted-certs.pem</code></td>
+<td align="left">Trusted CA certificates to use for verifying signatures.</td>
+</tr>
+</tbody>
+</table>
+
+<h3 id="device-registry">Device Registry</h3>
+
+<p>The Device Registry supports the use of TLS for connections to protocol adapters and the Auth Server.
+Please refer to the <a href="/hono/docs/1.2/admin-guide/device-registry-config/">Device Registry admin guide</a> for details regarding the required configuration steps.</p>
+
+<p>The <code>demo-certs/certs</code> folder contains the following demo keys and certificates to be used with the Device Registry for that purpose.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">File</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>auth-server-cert.pem</code></td>
+<td align="left">The certificate of the Auth Server, used to verify the signatures of tokens issued by the Auth Server.</td>
+</tr>
+
+<tr>
+<td align="left"><code>device-registry-key.pem</code></td>
+<td align="left">The example private key for creating signatures.</td>
+</tr>
+
+<tr>
+<td align="left"><code>device-registry-cert.pem</code></td>
+<td align="left">The example certificate asserting the server&rsquo;s identity.</td>
+</tr>
+
+<tr>
+<td align="left"><code>trusted-certs.pem</code></td>
+<td align="left">Trusted CA certificates to use for verifying signatures.</td>
+</tr>
+</tbody>
+</table>
+
+<h3 id="http-adapter">HTTP Adapter</h3>
+
+<p>The HTTP adapter supports the use of TLS for its connections to the Tenant service, the Device Registration service, the Credentials service and the AMQP Messaging Network. The adapter also supports the use of TLS for connections with devices. For this purpose, the adapter can be configured with a server certificate and private key.
+Please refer to the <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">HTTP adapter admin guide</a> for details regarding the required configuration steps.</p>
+
+<p>The <code>demo-certs/certs</code> folder contains the following demo keys and certificates to be used with the HTTP adapter for that purpose.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">File</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>http-adapter-key.pem</code></td>
+<td align="left">The example private key for creating signatures.</td>
+</tr>
+
+<tr>
+<td align="left"><code>http-adapter-cert.pem</code></td>
+<td align="left">The example certificate asserting the adapter&rsquo;s identity.</td>
+</tr>
+
+<tr>
+<td align="left"><code>trusted-certs.pem</code></td>
+<td align="left">Trusted CA certificates to use for verifying signatures.</td>
+</tr>
+</tbody>
+</table>
+
+<h3 id="mqtt-adapter">MQTT Adapter</h3>
+
+<p>The MQTT adapter supports the use of TLS for its connections to the Tenant service, the Device Registration service, the Credentials service and the AMQP Messaging Network. The adapter also supports the use of TLS for connections with devices. For this purpose, the adapter can be configured with a server certificate and private key.
+Please refer to the <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">MQTT adapter admin guide</a> for details regarding the required configuration steps.</p>
+
+<p>The <code>demo-certs/certs</code> folder contains the following demo keys and certificates to be used with the MQTT adapter for that purpose.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">File</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>mqtt-adapter-key.pem</code></td>
+<td align="left">The example private key for creating signatures.</td>
+</tr>
+
+<tr>
+<td align="left"><code>mqtt-adapter-cert.pem</code></td>
+<td align="left">The example certificate asserting the adapter&rsquo;s identity.</td>
+</tr>
+
+<tr>
+<td align="left"><code>trusted-certs.pem</code></td>
+<td align="left">Trusted CA certificates to use for verifying signatures.</td>
+</tr>
+</tbody>
+</table>
+
+<h3 id="kura-adapter">Kura Adapter</h3>
+
+<p>The Kura adapter supports the use of TLS for its connections to the Tenant service, the Device Registration service, the Credentials service and the AMQP Messaging Network. The adapter also supports the use of TLS for connections with devices. For this purpose, the adapter can be configured with a server certificate and private key.
+Please refer to the <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">Kura adapter admin guide</a> for details regarding the required configuration steps.</p>
+
+<p>The <code>demo-certs/certs</code> folder contains the following demo keys and certificates to be used with the Kura adapter for that purpose.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">File</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>kura-adapter-key.pem</code></td>
+<td align="left">The example private key for creating signatures.</td>
+</tr>
+
+<tr>
+<td align="left"><code>kura-adapter-cert.pem</code></td>
+<td align="left">The example certificate asserting the adapter&rsquo;s identity.</td>
+</tr>
+
+<tr>
+<td align="left"><code>trusted-certs.pem</code></td>
+<td align="left">Trusted CA certificates to use for verifying signatures.</td>
+</tr>
+</tbody>
+</table>
+
+<h3 id="client-application">Client Application</h3>
+
+<p>When the connection between an application client and Hono (i.e. the Dispatch Router) is supposed to be secured by TLS (which is a good idea),
+then the client application needs to be configured to trust the CA that signed the Dispatch Router&rsquo;s certificate chain.
+Clients can use the <code>org.eclipse.hono.client.HonoConnection.newConnection(ClientConfigProperties)</code> method to establish a connection
+to Hono. The <code>org.eclipse.hono.config.ClientConfigProperties</code> instance passed in to the method needs to be configured
+with the trust store containing the CA&rsquo;s certificate.
+Please refer to the <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">Hono Client configuration guide</a> for details regarding the
+corresponding configuration properties that need to be set.</p>
+
+<p>The <code>demo-certs/certs</code> folder contains the following demo keys to be used with client applications for that purpose.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">File</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>trusted-certs.pem</code></td>
+<td align="left">Trusted CA certificates to use for verifying signatures.</td>
+</tr>
+</tbody>
+</table>
+
+<h2 id="using-openssl">Using OpenSSL</h2>
+
+<p>Hono&rsquo;s individual services are implemented in Java and therefore, by default, use the SSL/TLS engine that comes with the Java Virtual Machine that the services are running on. In case of the Docker images provided by Hono this is the SSL engine of OpenJDK. While the standard SSL engine has the advantage of being a part of the JVM itself and thus being available on every operating system that the JVM is running on without further installation, it provides only limited performance and throughput when compared to native TLS implementations like <a href="https://www.openssl.org/">OpenSSL</a>.</p>
+
+<p>In order to address this problem, the Netty networking library that is used in Hono&rsquo;s components can be configured to employ the OpenSSL instead of the JVM&rsquo;s SSL engine by means of Netty&rsquo;s <a href="http://netty.io/wiki/forked-tomcat-native.html">Forked Tomcat Native</a> (tcnative) module.</p>
+
+<p>The tcnative module comes in several flavors, corresponding to the way that the OpenSSL library has been linked in. The statically linked versions include a specific version of OpenSSL (or <a href="https://boringssl.googlesource.com/">BoringSSL</a> for that matter) and is therefore most easy to use on supported platforms, regardless of whether another version of OpenSSL is already installed or not. In contrast, the dynamically linked variants depend on a particular version of OpenSSL being already installed on the operating system. Both approaches have their pros and cons and Hono therefore does not include tcnative in its Docker images by default, i.e. Hono&rsquo;s services will use the JVM&rsquo;s default SSL engine by default.</p>
+
+<h3 id="configuring-containers">Configuring Containers</h3>
+
+<p>When starting up any of Hono&rsquo;s Docker images as a container, the JVM will look for additional jar files to include in its classpath in the container&rsquo;s <code>/opt/hono/extensions</code> folder. Thus, using a specific variant of tcnative is just a matter of configuring the container to mount a volume or binding a host folder at that location and putting the desired variant of tcnative into the corresponding volume or host folder.r
+Assuming that the Auth Server should be run with the statically linked, BoringSSL based tcnative variant, the following steps are necessary:</p>
+
+<ol>
+<li><a href="http://netty.io/wiki/forked-tomcat-native.html#how-to-download-netty-tcnative-boringssl-static">Download tcnative</a> matching the platform architecture (<em>linux-x86_64</em>).</li>
+<li>Put the jar file to a folder on the Docker host, e.g. <code>/tmp/tcnative</code>.</li>
+<li>Start the Auth Server Docker image mounting the host folder:</li>
+</ol>
+
+<pre><code class="language-sh">docker run --name hono-auth-server --mount type=bind,src=/tmp/tcnative,dst=/opt/hono/extensions,ro ... eclipse/hono-service-auth
+</code></pre>
+
+<p>Note that the command given above does not contain the environment variables and secrets that are usually required to configure the service properly.</p>
+
+<p>When the Auth Server starts up, it will look for a working variant of tcnative on its classpath and (if found) use it for establishing TLS connections. The service&rsquo;s log file will indicate whether the JVM&rsquo;s default SSL engine or OpenSSL is used.</p>
+
+<p>Using a Docker <em>volume</em> instead of a <em>bind mount</em> works the same way but requires the use of <code>volume</code> as the <em>type</em> of the <code>--mount</code> parameter. Please refer to the <a href="https://docs.docker.com/edge/engine/reference/commandline/service_create/#add-bind-mounts-volumes-or-memory-filesystems">Docker reference documentation</a> for details.</p>
+
+<h2 id="server-name-indication-sni">Server Name Indication (SNI)</h2>
+
+<p><a href="https://tools.ietf.org/html/rfc6066#section-3">Server Name Indication</a> can be used to indicate to a server the host name that the client wants to
+connect to as part of the TLS handshake. This is useful in order to be able to host multiple <em>virtual</em> servers on a single network address.
+In particular, SNI allows server components to select a server certificate that matches the domain name indicated by the client using SNI.</p>
+
+<p>Hono&rsquo;s protocol adapters support <em>virtual</em> servers by means of SNI as described above. Devices can then connect to a protocol adapter using any one
+of the configured <em>virtual</em> domain names.</p>
+
+<p>The following steps a re necessary in order to configure the protocol adapters with multiple <em>virtual</em> servers:</p>
+
+<ol>
+<li>Create Server Certificate(s)</li>
+</ol>
+
+<p>When a device establishes a connection to one of Hono&rsquo;s protocol adapters using one of its <em>virtual</em> domain names, then it includes the domain name in
+   its TLS <em>hello</em> message by means of the SNI extension. The server can then use this information to determine the matching server certificate and
+   corresponding private key that is required to perform the TLS handshake.</p>
+
+<p>It is therefore necessary to create a private key and certificate for each <em>virtual</em> server to be hosted.
+   The <em>virtual</em> server&rsquo;s domain name needs to be added to the certificate&rsquo;s <em>Subject Alternative Name</em> (SAN) list in order for Hono to be able to
+   determine the key/certificate pair to use for the TLS handshake with the device.
+   Please refer to the <a href="https://vertx.io/docs/vertx-core/java/#_server_name_indication_sni">vert.x SNI guide</a> for details on how this works under the hood.</p>
+
+<p>Hono&rsquo;s protocol adapters then need to be configured with the server certificates and keys. In order to do so, the certificates and corresponding private
+   keys need to be added to a <em>key store</em>. Hono supports the <em>JKS</em> and <em>PKCS12</em> key store formats for that purpose.
+   Once the key store has been created, Hono&rsquo;s protocol adapters need to be configured with the path to the key store by means of the adapters&rsquo;
+   <code>KEY_STORE_PATH</code> configuration variable. Please refer to the <a href="/hono/docs/1.2/admin-guide/">protocol adapter admin guides</a> for details on how to
+   configure the key store path.</p>
+
+<ol>
+<li>Enable SNI for Hono&rsquo;s Protocol Adapters</li>
+</ol>
+
+<p>Hono&rsquo;s protocol adapters can be configured to support SNI by means of the <code>SNI</code> configuration variable. Please refer to the
+   <a href="/hono/docs/1.2/admin-guide/">protocol adapter admin guides</a> for details on how to set this variable.</p>
+
+<ol>
+<li>Verify Configuration</li>
+</ol>
+
+<p>The setup can be verified by means of the command line tools that are part of <a href="https://www.openssl.org/">OpenSSL</a>.
+   Assuming that the MQTT protocol adapter&rsquo;s IP address is <code>10.100.84.23</code>, its secure endpoint is bound to port 31884 and it has
+   been configured with a certificate using domain name <em>my-hono.eclipse.org</em>, then the following command can be used to test
+   if a TLS secured connection with the adapter using that virtual host name can be established successfully:</p>
+
+<pre><code class="language-sh">   openssl s_client -connect 10.100.84.23:31884 -servername my-hono.eclipse.org
+</code></pre>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/api/authentication/get-token.svg b/docs/1.2/api/authentication/get-token.svg
new file mode 100644
index 0000000..a71589a
--- /dev/null
+++ b/docs/1.2/api/authentication/get-token.svg
@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="544.8px" preserveAspectRatio="none" style="width:470px;height:544px;" version="1.1" viewBox="0 0 470 544" width="470.4px" zoomAndPan="magnify"><defs><filter height="300%" id="fqoijhe1a4k0w" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#fqoijhe1a4k0w)" height="100.0781" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="357" y="200.1938"/><rect fill="#FFFFFF" filter="url(#fqoijhe1a4k0w)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="357" y="440.1094"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="43.2" x2="43.2" y1="45.9563" y2="496.6688"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="363" x2="363" y1="45.9563" y2="496.6688"/><rect fill="#FEFECE" filter="url(#fqoijhe1a4k0w)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="27.5941">Client</text><rect fill="#FEFECE" filter="url(#fqoijhe1a4k0w)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="495.4688"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="519.4629">Client</text><rect fill="#FEFECE" filter="url(#fqoijhe1a4k0w)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="136.8" x="292.2" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="120" x="300.6" y="27.5941">Authentication</text><rect fill="#FEFECE" filter="url(#fqoijhe1a4k0w)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="136.8" x="292.2" y="495.4688"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="120" x="300.6" y="519.4629">Authentication</text><rect fill="#FFFFFF" filter="url(#fqoijhe1a4k0w)" height="100.0781" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="357" y="200.1938"/><rect fill="#FFFFFF" filter="url(#fqoijhe1a4k0w)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="357" y="440.1094"/><polygon fill="#A80036" points="348.6,78.5156,360.6,83.3156,348.6,88.1156,353.4,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="355.8" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="290.4" x="52.2" y="77.2365">1.0 SASL PLAIN (username/password)</text><path d="M283.2,98.9156 L283.2,128.9156 L438,128.9156 L438,110.9156 L426,98.9156 L283.2,98.9156 " fill="#FBFB77" filter="url(#fqoijhe1a4k0w)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M426,98.9156 L426,110.9156 L438,110.9156 L426,98.9156 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="129.6" x="290.4" y="119.3959">verify credentials</text><polygon fill="#A80036" points="57,160.4344,45,165.2344,57,170.0344,52.2,165.2344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="361.8" y1="165.2344" y2="165.2344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="96" x="64.2" y="159.1553">1.1 SASL OK</text><polygon fill="#A80036" points="342.6,195.3937,354.6,200.1938,342.6,204.9938,347.4,200.1938" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="349.8" y1="200.1938" y2="200.1938"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="52.2" y="194.1146">2.0 open</text><path d="M265.2,215.7938 L265.2,263.7938 L456,263.7938 L456,227.7938 L444,215.7938 L265.2,215.7938 " fill="#FBFB77" filter="url(#fqoijhe1a4k0w)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M444,215.7938 L444,227.7938 L456,227.7938 L444,215.7938 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="165.6" x="272.4" y="236.274">determine authorities</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="97.2" x="272.4" y="254.4334">create token</text><polygon fill="#A80036" points="57,295.4719,45,300.2719,57,305.0719,52.2,300.2719" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="361.8" y1="300.2719" y2="300.2719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="64.2" y="294.1928">2.1 open</text><polygon fill="#A80036" points="348.6,330.4313,360.6,335.2313,348.6,340.0313,353.4,335.2313" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="355.8" y1="335.2313" y2="335.2313"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="168" x="52.2" y="329.1521">3.0 attach(REC, "cbs")</text><polygon fill="#A80036" points="57,365.3906,45,370.1906,57,374.9906,52.2,370.1906" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="361.8" y1="370.1906" y2="370.1906"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="78" x="64.2" y="364.1115">3.1 attach</text><polygon fill="#A80036" points="57,400.35,45,405.15,57,409.95,52.2,405.15" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="361.8" y1="405.15" y2="405.15"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="144" x="64.2" y="399.0709">3.2 transfer(token)</text><polygon fill="#A80036" points="342.6,435.3094,354.6,440.1094,342.6,444.9094,347.4,440.1094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="349.8" y1="440.1094" y2="440.1094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="68.4" x="52.2" y="434.0303">4.0 close</text><polygon fill="#A80036" points="57,470.2687,45,475.0687,57,479.8688,52.2,475.0687" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="361.8" y1="475.0687" y2="475.0687"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="68.4" x="64.2" y="468.9896">4.1 close</text><!--
+@startuml
+scale 1.2
+
+participant Client
+participant Authentication
+
+Client -> Authentication: 1.0 SASL PLAIN (username/password)
+
+note over Authentication
+    verify credentials
+end note
+
+Client <- Authentication: 1.1 SASL OK
+
+Client -> Authentication ++: 2.0 open
+
+note over Authentication
+    determine authorities
+    create token
+end note
+
+Client <- Authentication - -: 2.1 open
+
+Client -> Authentication: 3.0 attach(REC, "cbs")
+Client <- Authentication: 3.1 attach
+Client <- Authentication: 3.2 transfer(token)
+
+Client -> Authentication ++: 4.0 close
+Client <- Authentication - -: 4.1 close
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/authentication/index.html b/docs/1.2/api/authentication/index.html
new file mode 100644
index 0000000..e970cab
--- /dev/null
+++ b/docs/1.2/api/authentication/index.html
@@ -0,0 +1,2638 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Authentication API Specification :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Authentication API Specification :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Authentication API Specification :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/api/authentication//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/api/authentication/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item active">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/api/authentication/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/authentication/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/api/authentication/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/api/authentication/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/api/authentication/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/api/authentication/index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/api/'>API</a> > Authentication API Specification
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#get-token">Get Token</a></li>
+<li><a href="#token-format">Token Format</a>
+<ul>
+<li><a href="#resource-authorities">Resource Authorities</a></li>
+<li><a href="#operation-authorities">Operation Authorities</a></li>
+</ul></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Authentication API Specification</h1>
+          
+
+        
+
+
+<p>The <em>Authentication API</em> is used to retrieve a <em>token</em> asserting a subject&rsquo;s identity and granted authorities. Other service implementations use such a token to make authorization decisions on a client&rsquo;s request to read or write from/to a resource or to invoke a certain operation.</p>
+
+<p>The Authentication API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to an Authentication service using an AMQP 1.0 client in order to invoke operations of the API as described in the following sections.</p>
+
+<p>Note that a component implementing this API will most likely need to also provide means to add, alter or remove identities and authorities as well. However, Hono itself does not require this kind of functionality, thus this kind of functionality is considered out of scope of this API.</p>
+
+<p>In a real world environment there will often already be an <em>identity management system</em> in place. In such cases it can make sense to just implement a <em>facade</em> exposing the Authentication API operations and mapping them to the underlying existing system&rsquo;s functionality.</p>
+
+<h2 id="get-token">Get Token</h2>
+
+<p>Clients use this operation to</p>
+
+<ul>
+<li>verify a set of credentials and</li>
+<li>retrieve a token asserting the authenticated subject&rsquo;s identity and granted authorities.</li>
+</ul>
+
+<p><strong>Message Flow</strong></p>
+
+<p>The following sequence diagram illustrates the flow of messages involved in a <em>Client</em> retrieving a token.</p>
+
+<figure>
+    <img src="get-token.svg"/> <figcaption>
+            <h4>Get Token message flow</h4>
+        </figcaption>
+</figure>
+
+
+<ol>
+<li>The <em>Client</em> and <em>Authentication</em> service have agreed to use the SASL PLAIN mechanism for authenticating the client. The <em>Client</em> therefore sends the credentials of the identity it wants to retrieve a token for. The <em>Authentication</em> service successfully verifies the credentials and establishes the <em>authorization ID</em>.
+
+<ol>
+<li>The <em>Authentication</em> service completes the SASL exchange with a successful outcome (SASL OK).</li>
+</ol></li>
+<li>The <em>Client</em> continues by opening an AMQP connection with the <em>Authentication</em> service. The <em>Authentication</em> service creates a token asserting the <em>authorization ID</em> and authorities established during the SASL exchange and associates it with the connection.</li>
+<li>The <em>Client</em> opens a receiving link using source address <code>cbs</code>.
+
+<ol>
+<li>The <em>Authentication</em> service opens the link and</li>
+<li>sends the token associated with the connection to the <em>Client</em>.</li>
+</ol></li>
+<li>The <em>Client</em> closes the connection.</li>
+</ol>
+
+<p><strong>Token Message Format</strong></p>
+
+<p>On successful establishment of the receiving link with the client as described above, the server sends a message to the client containing a token asserting the identity and authorities of the client that has been authenticated as part of establishing the underlying AMQP connection.</p>
+
+<p>The following table provides an overview of the properties of the message sent to the client.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="left">Location</th>
+<th align="left">Type</th>
+<th align="left">Value</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>type</em></td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left"><code>amqp:jwt</code></td>
+</tr>
+</tbody>
+</table>
+
+<p>The message&rsquo;s body consists of a single AMQP 1.0 <em>AmqpValue</em> section which contains the UTF-8 representation of a JSON Web Token as defined in <a href="#token-format">Token Format</a>.</p>
+
+<h2 id="token-format">Token Format</h2>
+
+<p>The token returned by the <em>get Token</em> operation is a cryptographically signed JSON Web Token as defined by <a href="https://tools.ietf.org/html/rfc7519">RFC 7519</a>.</p>
+
+<p>The token contains the following mandatory <em>claims</em>:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="left">Type</th>
+<th align="left">Value</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>sub</em></td>
+<td align="left"><a href="https://tools.ietf.org/html/rfc7519#section-4.1.2">RFC 7519, Section 4.1.2</a></td>
+<td align="left">The <em>authorization ID</em> of the authenticated client. This represents the asserted identity.</td>
+</tr>
+
+<tr>
+<td align="left"><em>exp</em></td>
+<td align="left"><a href="https://tools.ietf.org/html/rfc7519#section-4.1.4">RFC 7519, Section 4.1.4</a></td>
+<td align="left">The point in time after which the claims contained in this token must be considered no longer valid. Clients MUST NOT use any information from a token that has expired.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The subject&rsquo;s authorities on resources and operations are represented by additional JWT <em>claims</em> with a name identifying the resource or operation and a value containing the activities the subject is allowed to perform. The following activities are supported:</p>
+
+<ul>
+<li>READ - The client is allowed to establish a receiving link using the resource&rsquo;s node address as the link&rsquo;s <em>source address</em>.</li>
+<li>WRITE - The client is allowed to establish a sending link using the resource&rsquo;s node address as the link&rsquo;s <em>target address</em>.</li>
+<li>EXECUTE - The client is allowed to <em>invoke</em> an operation on an endpoint, i.e. send a message over a link with a <em>subject</em> representing the operation name and the link&rsquo;s target address representing the API endpoint&rsquo;s node address.</li>
+</ul>
+
+<p>The allowed activities are encoded in a claim&rsquo;s value by means of simply concatenating the activities&rsquo; initial characters (<code>R</code>, <code>W</code>, <code>E</code>).</p>
+
+<p>The token may contain any number of additional claims which may be ignored by clients that do not understand their meaning.</p>
+
+<h3 id="resource-authorities">Resource Authorities</h3>
+
+<p>A client&rsquo;s authority on a resource is represented by a JWT <em>claim</em> with a name containing the resource node address prefixed with <code>r:</code> and a value containing the activities the client is allowed to perform on the resource. The node address MAY contain one or more wildcard (<code>*</code>) characters to represent <em>any</em> string.</p>
+
+<p><strong>Example:</strong></p>
+
+<p>Assuming a client which is allowed to</p>
+
+<ul>
+<li>send and consume events for tenant <code>my-tenant</code> and</li>
+<li>consume telemetry data for all tenants</li>
+</ul>
+
+<p>the corresponding claims (in the token&rsquo;s JSON representation) would look like this:</p>
+
+<pre><code class="language-json">{
+  ...
+  &quot;r:event/my-tenant&quot;: &quot;RW&quot;,
+  &quot;r:telemetry/*&quot;: &quot;R&quot;,
+  ...
+}
+</code></pre>
+
+<h3 id="operation-authorities">Operation Authorities</h3>
+
+<p>A client&rsquo;s authority to invoke an endpoint&rsquo;s operation(s) is represented by a JWT <em>claim</em> with a name containing the endpoint&rsquo;s node address and operation identifier prefixed with <code>o:</code> and a value of <code>E</code> (for <code>EXECUTE</code>). The endpoint node address MAY contain one or more wildcard (<code>*</code>) characters to represent <em>any</em> string. The operation identifier is the <em>subject</em> value defined by the corresponding API for the operation. The operation identifier MAY be set to <code>*</code> to represent <em>any</em> operation of the endpoint.</p>
+
+<p><strong>Example:</strong></p>
+
+<p>Assuming a client which is allowed to</p>
+
+<ul>
+<li>invoke the Device Registration API&rsquo;s <em>assert Registration</em> operation for any tenant and</li>
+<li>invoke all methods of the Credentials API for tenant <code>my-tenant</code></li>
+</ul>
+
+<p>the corresponding claims (in the token&rsquo;s JSON representation) would look like this:</p>
+
+<pre><code class="language-json">{
+  ...
+  &quot;o:registration/*:assert&quot;: &quot;E&quot;,
+  &quot;o:credentials/my-tenant:*&quot;: &quot;E&quot;,
+  ...
+}
+</code></pre>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/api/command-and-control/device_not_connected.svg b/docs/1.2/api/command-and-control/device_not_connected.svg
new file mode 100644
index 0000000..47ad864
--- /dev/null
+++ b/docs/1.2/api/command-and-control/device_not_connected.svg
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="234px" preserveAspectRatio="none" style="width:777px;height:234px;" version="1.1" viewBox="0 0 777 234" width="777.6px" zoomAndPan="magnify"><defs><filter height="300%" id="f522yk1blx9om" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="115.2" x2="115.2" y1="45.9563" y2="186.8344"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="672.6" x2="672.6" y1="45.9563" y2="186.8344"/><rect fill="#FEFECE" filter="url(#f522yk1blx9om)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="27.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="36" y="27.5941">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#f522yk1blx9om)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="27.6" y="185.6344"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="36" y="209.6285">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#f522yk1blx9om)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="188.4" x="576.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="171.6" x="585" y="27.5941">Business Application</text><rect fill="#FEFECE" filter="url(#f522yk1blx9om)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="188.4" x="576.6" y="185.6344"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="171.6" x="585" y="209.6285">Business Application</text><polygon fill="#A80036" points="128.4,78.5156,116.4,83.3156,128.4,88.1156,123.6,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="121.2" x2="672" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="529.2" x="135.6" y="77.2365">transfer(to: "command/DEFAULT_TENANT/4711", subject: "switchOn")</text><path d="M9.6,98.9156 L9.6,128.9156 L216,128.9156 L216,110.9156 L204,98.9156 L9.6,98.9156 " fill="#FBFB77" filter="url(#f522yk1blx9om)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M204,98.9156 L204,110.9156 L216,110.9156 L204,98.9156 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="181.2" x="16.8" y="119.3959">device is not connected</text><polygon fill="#A80036" points="658.8,160.4344,670.8,165.2344,658.8,170.0344,663.6,165.2344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="115.2" x2="666" y1="165.2344" y2="165.2344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="220.8" x="123.6" y="159.1553">disposition(state: "released")</text><!--
+@startuml
+scale 1.2
+
+participant "AMQP 1.0 Network"
+participant "Business Application"
+
+"Business Application" -> "AMQP 1.0 Network": transfer(to: "command/DEFAULT_TENANT/4711", subject: "switchOn")
+note over "AMQP 1.0 Network"
+device is not connected
+end note
+"AMQP 1.0 Network" -> "Business Application": disposition(state: "released")
+@enduml
+
+PlantUML version 1.2019.07(Mon Jun 24 19:59:20 UTC 2019)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/command-and-control/index.html b/docs/1.2/api/command-and-control/index.html
new file mode 100644
index 0000000..84184a6
--- /dev/null
+++ b/docs/1.2/api/command-and-control/index.html
@@ -0,0 +1,2859 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Command & Control API Specification :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Command &amp; Control API Specification :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Command &amp; Control API Specification :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/api/command-and-control//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/api/command-and-control/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item active">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/api/command-and-control/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/command-and-control/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/api/command-and-control/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/api/command-and-control/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/api/command-and-control/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/api/command-and-control/index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/api/'>API</a> > Command & Control API Specification
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#send-a-one-way-command">Send a One-Way Command</a></li>
+<li><a href="#send-a-request-response-command">Send a (Request/Response) Command</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Command &amp; Control API Specification</h1>
+          
+
+        
+
+
+<p>The <em>Command &amp; Control</em> API of Eclipse Hono&trade; is used by <em>Business Applications</em> to send commands to connected devices.</p>
+
+<p>Commands can be used to trigger actions on devices. Examples include updating a configuration property, installing a software component or switching the state of an actuator.</p>
+
+<p>Hono distinguishes two types of commands. The first type is <em>one-way</em> only. In this case the sender of the command does not expect the device to send back a message in response to the command. This type of command is referred to as a <em>one-way command</em> in the remainder of this page. One-way commands may be used to e.g. <em>notify</em> a device about a change of state.</p>
+
+<p>The second type of commands expects a <em>response</em> to be sent back from the device as a result of processing the command. In this case the response contains a <em>status</em> code which indicates whether the command could be processed successfully. If so, the response may also include data representing the result of processing the command. This type of command is plainly referred to as a <em>command</em> because it represents the default case.</p>
+
+<p>The Command &amp; Control API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using AMQP 1.0 in order to invoke operations of the API as described in the following sections. Throughout the remainder of this page we will simply use AMQP when referring to AMQP 1.0.</p>
+
+<h2 id="send-a-one-way-command">Send a One-Way Command</h2>
+
+<p>Business Applications use this operation to send a command to a device for which they do not expect to receive a response from the device.</p>
+
+<p><strong>Preconditions</strong></p>
+
+<ol>
+<li>The <em>Business Application</em> has established an AMQP connection with the AMQP 1.0 Network.</li>
+<li>The <em>Business Application</em> has established an AMQP link in role <em>sender</em> with the target address <code>command/${tenant_id}</code>, where <code>${tenant_id}</code> is the ID of the tenant that the device belongs to. This link is used by the <em>Business Application</em> to send command messages.</li>
+</ol>
+
+<p>The following sequence diagram illustrates the establishment of the required link:</p>
+
+<figure>
+    <img src="send_preconditions.svg"/> <figcaption>
+            <h4>Application connecting to the AMQP 1.0 Messaging Network</h4>
+        </figcaption>
+</figure>
+
+
+<p><strong>Message Format</strong></p>
+
+<p>The following table provides an overview of the properties the <em>Business Application</em> needs to set on a one-way command message.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>to</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST contain the target address <code>command/${tenant_id}/${device_id}</code> of the message, where <code>${device_id}</code> is the ID of the device to send the message to.</td>
+</tr>
+
+<tr>
+<td align="left"><em>subject</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The name of the command to be executed by the device.</td>
+</tr>
+
+<tr>
+<td align="left"><em>content-type</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">If present, MUST contain a <em>Media Type</em> as defined by <a href="https://tools.ietf.org/html/rfc2046">RFC 2046</a> which describes the semantics and format of the command&rsquo;s input data contained in the message payload. However, not all protocol adapters will support this property as not all transport protocols provide means to convey this information, e.g. MQTT 3.1.1 has no notion of message headers.</td>
+</tr>
+
+<tr>
+<td align="left"><em>message-id</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">An identifier that uniquely identifies the message at the sender side.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The command message MAY contain arbitrary payload to be sent to the device in a single AMQP <em>Data</em> section. The value of the message&rsquo;s <em>subject</em> property may provide a hint to the device regarding the format, encoding and semantics of the payload data.</p>
+
+<p>Hono indicates the outcome of the operation by means of the following AMQP delivery states:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Delivery State</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>accepted</code></td>
+<td align="left">The command has been delivered to the device for processing.</td>
+</tr>
+
+<tr>
+<td align="left"><code>released</code></td>
+<td align="left">The command has not been delivered to the device because the device is (currently) not connected.</td>
+</tr>
+
+<tr>
+<td align="left"><code>rejected</code></td>
+<td align="left">The command has not been delivered to the device because it does not contain all required information.</td>
+</tr>
+</tbody>
+</table>
+
+<p><strong>Note</strong> that Hono relies on the particular protocol adapter to deliver commands to devices. Depending on the used transport protocol and the adapter&rsquo;s implementation, the <code>accepted</code> outcome may thus indicate any of the following:</p>
+
+<ul>
+<li>An <em>attempt</em> has been made to deliver the command to the device. However, it is unclear if the device has received (or processed) the command.</li>
+<li>The device has acknowledged the reception of the command but has not processed the command yet.</li>
+<li>The device has received and processed the command.</li>
+</ul>
+
+<p><strong>Examples</strong></p>
+
+<p>The following sequence diagram shows the successful delivery of a one-way command called <code>switchOn</code> to device <code>4711</code> of the <code>DEFAULT_TENANT</code>:</p>
+
+<figure>
+    <img src="one_way_success.svg"/> <figcaption>
+            <h4>Successfully send a One-Way Command</h4>
+        </figcaption>
+</figure>
+
+
+<p>The following sequence diagram shows how the delivery of the same one-way command fails because the device is not connected:</p>
+
+<figure>
+    <img src="device_not_connected.svg"/> <figcaption>
+            <h4>Device not connected</h4>
+        </figcaption>
+</figure>
+
+
+<p>The following sequence diagram illustrates how a malformed command sent by a <em>Business Application</em> gets rejected:</p>
+
+<figure>
+    <img src="malformed_message.svg"/> <figcaption>
+            <h4>Malformed Command message</h4>
+        </figcaption>
+</figure>
+
+
+<h2 id="send-a-request-response-command">Send a (Request/Response) Command</h2>
+
+<p><em>Business Applications</em> use this operation to send a command to a device for which they expect the device to send back a response.</p>
+
+<p><a name="receiver-link-precondition"></a></p>
+
+<p><strong>Preconditions</strong></p>
+
+<ol>
+<li>The <em>Business Application</em> has established an AMQP connection with the AMQP 1.0 Network.</li>
+<li>The <em>Business Application</em> has established an AMQP link in role <em>sender</em> with the target address <code>command/${tenant_id}</code>, where <code>${tenant_id}</code> is the ID of the tenant that the device belongs to. This link is used by the <em>Business Application</em> to send command messages.</li>
+<li>The <em>Business Application</em> has established an AMQP link in role <em>receiver</em> with the source address <code>command_response/${tenant_id}/${reply_id}</code>.
+This link is used by the <em>Business Application</em> to receive the response to the command from the device. This link’s source address is also used as the <code>reply-to</code> address for the request messages. The <code>${reply_id}</code> may be any arbitrary string chosen by the application.</li>
+</ol>
+
+<p>The following sequence diagram illustrates the establishment of the required links:</p>
+
+<figure>
+    <img src="receive_preconditions.svg"/> <figcaption>
+            <h4>Application connecting to the AMQP 1.0 Messaging Network</h4>
+        </figcaption>
+</figure>
+
+
+<p><strong>Command Message Format</strong></p>
+
+<p>The following table provides an overview of the properties the <em>Business Application</em> needs to set on a command message.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>to</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST contain the target address <code>command/${tenant_id}/${device_id}</code> of the message, where <code>${device_id}</code> is the ID of the device to send the message to.</td>
+</tr>
+
+<tr>
+<td align="left"><em>subject</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST contain the command name to be executed by a device.</td>
+</tr>
+
+<tr>
+<td align="left"><em>content-type</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">If present, MUST contain a <em>Media Type</em> as defined by <a href="https://tools.ietf.org/html/rfc2046">RFC 2046</a> which describes the semantics and format of the command&rsquo;s input data contained in the message payload. However, not all protocol adapters will support this property as not all transport protocols provide means to convey this information, e.g. MQTT 3.1.1 has no notion of message headers.</td>
+</tr>
+
+<tr>
+<td align="left"><em>correlation-id</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MAY contain an ID used to correlate a response message to the original request. If set, it is used as the <em>correlation-id</em> property in the response, otherwise the value of the <em>message-id</em> property is used. Either this or the <em>message-id</em> property MUST be set.</td>
+</tr>
+
+<tr>
+<td align="left"><em>message-id</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MAY contain an identifier that uniquely identifies the message at the sender side. Either this or the <em>correlation-id</em> property MUST be set.</td>
+</tr>
+
+<tr>
+<td align="left"><em>reply-to</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST contain the source address that the application expects to receive the response from. This address MUST be the same as the source address used for establishing the client&rsquo;s receiver link (see <a href="./#receiver-link-precondition">Preconditions</a> above).</td>
+</tr>
+</tbody>
+</table>
+
+<p>The command message MAY contain arbitrary payload to be sent to the device in a single AMQP <em>Data</em> section. The value of the command message&rsquo;s <em>subject</em> value may provide a hint to the device regarding the format, encoding and semantics of the payload data.</p>
+
+<p>Hono uses following AMQP delivery states to indicate the outcome of sending the command to the device:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Delivery State</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>accepted</code></td>
+<td align="left">The command has been delivered to the device for processing.</td>
+</tr>
+
+<tr>
+<td align="left"><code>released</code></td>
+<td align="left">The command has not been delivered to the device because the device is (currently) not connected.</td>
+</tr>
+
+<tr>
+<td align="left"><code>rejected</code></td>
+<td align="left">The command has not been delivered to the device because it does not contain all required information.</td>
+</tr>
+</tbody>
+</table>
+
+<p><strong>Note</strong> that Hono relies on the particular protocol adapter to deliver commands to devices. Depending on the used transport protocol and the adapter&rsquo;s implementation, the <code>accepted</code> outcome may thus indicate any of the following:</p>
+
+<ul>
+<li>An <em>attempt</em> has been made to deliver the command to the device. However, it is unclear if the device has received (or processed) the command.</li>
+<li>The device has acknowledged the reception of the command but has not processed the command yet.</li>
+</ul>
+
+<p>An application can determine the overall outcome of the operation by means of the response to the command that is sent back by the device. An application should consider execution of a command to have failed, if it does not receive a response within a reasonable amount of time.</p>
+
+<p><strong>Response Message Format</strong></p>
+
+<p>The following table provides an overview of the properties set on a message sent in response to a command.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>content-type</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">If present, MUST contain a <em>Media Type</em> as defined by <a href="https://tools.ietf.org/html/rfc2046">RFC 2046</a> which describes the semantics and format of the command&rsquo;s input data contained in the message payload. However, not all protocol adapters will support this property as not all transport protocols provide means to convey this information, e.g. MQTT 3.1.1 has no notion of message headers.</td>
+</tr>
+
+<tr>
+<td align="left"><em>correlation-id</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST contain the correlation ID used to match the command message with the response message containing the result of execution on the device.</td>
+</tr>
+
+<tr>
+<td align="left"><em>device_id</em></td>
+<td align="center">yes</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The identifier of the device that sent the response.</td>
+</tr>
+
+<tr>
+<td align="left"><em>status</em></td>
+<td align="center">yes</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>integer</em></td>
+<td align="left">MUST indicate the status of the execution. See table below for possible values.</td>
+</tr>
+
+<tr>
+<td align="left"><em>tenant_id</em></td>
+<td align="center">yes</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The identifier of the tenant that the device belongs to.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The <em>status</em> property must contain an <a href="https://tools.ietf.org/html/rfc7231#section-6">HTTP 1.1 response status code</a>:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Code</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>2xx</em></td>
+<td align="left">The command has been processed successfully.</td>
+</tr>
+
+<tr>
+<td align="left"><em>4xx</em></td>
+<td align="left">The command could not be processed due to a client error, e.g. malformed message payload.</td>
+</tr>
+
+<tr>
+<td align="left"><em>5xx</em></td>
+<td align="left">The command could not be processed due to an internal problem at the device side.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The semantics of the individual codes are specific to the device and command. For status codes indicating an error (codes in the <code>400 - 599</code> range) the message body MAY contain a detailed description of the error that occurred.</p>
+
+<p>If a command message response contains a payload, the body of the message MUST consist of a single AMQP <em>Data</em> section containing the response message data.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>The following sequence diagram illustrates how a <em>Business Application</em> sends a command called <code>getReading</code> to device <code>4711</code> of the <code>DEFAULT_TENANT</code> and receives a response from the device:</p>
+
+<figure>
+    <img src="request_response_success.svg"/> <figcaption>
+            <h4>Successfully send a Command</h4>
+        </figcaption>
+</figure>
+
+
+<p>The sending of a command may fail for the same reasons as those illustrated for sending a one-way command. Additionally, the sending of a command may be considered unsuccessful by an application if it does not receive the response from the device in a reasonable amount of time:</p>
+
+<figure>
+    <img src="response_time_out.svg"/> <figcaption>
+            <h4>Command times out</h4>
+        </figcaption>
+</figure>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/api/command-and-control/malformed_message.svg b/docs/1.2/api/command-and-control/malformed_message.svg
new file mode 100644
index 0000000..20ecfd4
--- /dev/null
+++ b/docs/1.2/api/command-and-control/malformed_message.svg
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="318px" preserveAspectRatio="none" style="width:790px;height:318px;" version="1.1" viewBox="0 0 790 318" width="790.8px" zoomAndPan="magnify"><defs><filter height="300%" id="f10hxv9l3i6bed" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="116.4" x2="116.4" y1="45.9563" y2="270.1125"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="673.8" x2="673.8" y1="45.9563" y2="270.1125"/><rect fill="#FEFECE" filter="url(#f10hxv9l3i6bed)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="28.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="37.2" y="27.5941">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#f10hxv9l3i6bed)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="28.8" y="268.9125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="37.2" y="292.9066">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#f10hxv9l3i6bed)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="188.4" x="577.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="171.6" x="586.2" y="27.5941">Business Application</text><rect fill="#FEFECE" filter="url(#f10hxv9l3i6bed)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="188.4" x="577.8" y="268.9125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="171.6" x="586.2" y="292.9066">Business Application</text><polygon fill="#A80036" points="129.6,78.5156,117.6,83.3156,129.6,88.1156,124.8,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="122.4" x2="673.2" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="529.2" x="136.8" y="77.2365">transfer(to: "command/DEFAULT_TENANT/4711", subject: "switchOn")</text><path d="M9.6,98.9156 L9.6,128.9156 L218.4,128.9156 L218.4,110.9156 L206.4,98.9156 L9.6,98.9156 " fill="#FBFB77" filter="url(#f10hxv9l3i6bed)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M206.4,98.9156 L206.4,110.9156 L218.4,110.9156 L206.4,98.9156 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="183.6" x="16.8" y="119.3959">command is malformed</text><polygon fill="#A80036" points="660,160.4344,672,165.2344,660,170.0344,664.8,165.2344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="116.4" x2="667.2" y1="165.2344" y2="165.2344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="217.2" x="124.8" y="159.1553">disposition(state: "rejected")</text><path d="M567.6,180.8344 L567.6,246.8344 L776.4,246.8344 L776.4,192.8344 L764.4,180.8344 L567.6,180.8344 " fill="#FBFB77" filter="url(#f10hxv9l3i6bed)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M764.4,180.8344 L764.4,192.8344 L776.4,192.8344 L764.4,180.8344 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="139.2" x="574.8" y="201.3146">may want to close</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="574.8" y="219.474">response link</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="183.6" x="574.8" y="237.6334">(if scoped to command)</text><!--
+@startuml
+scale 1.2
+
+participant "AMQP 1.0 Network"
+participant "Business Application"
+
+"Business Application" -> "AMQP 1.0 Network": transfer(to: "command/DEFAULT_TENANT/4711", subject: "switchOn")
+note over "AMQP 1.0 Network"
+command is malformed
+end note
+"AMQP 1.0 Network" -> "Business Application": disposition(state: "rejected")
+
+note over "Business Application"
+may want to close
+response link
+(if scoped to command)
+end note
+@enduml
+
+PlantUML version 1.2019.07(Mon Jun 24 19:59:20 UTC 2019)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/command-and-control/one_way_success.svg b/docs/1.2/api/command-and-control/one_way_success.svg
new file mode 100644
index 0000000..c6218b3
--- /dev/null
+++ b/docs/1.2/api/command-and-control/one_way_success.svg
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="253.2px" preserveAspectRatio="none" style="width:759px;height:253px;" version="1.1" viewBox="0 0 759 253" width="759.6px" zoomAndPan="magnify"><defs><filter height="300%" id="frby4mmuumt0w" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="97.2" x2="97.2" y1="45.9563" y2="204.9938"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="654.6" x2="654.6" y1="45.9563" y2="204.9938"/><rect fill="#FEFECE" filter="url(#frby4mmuumt0w)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="18" y="27.5941">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#frby4mmuumt0w)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="9.6" y="203.7938"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="18" y="227.7879">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#frby4mmuumt0w)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="188.4" x="558.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="171.6" x="567" y="27.5941">Business Application</text><rect fill="#FEFECE" filter="url(#frby4mmuumt0w)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="188.4" x="558.6" y="203.7938"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="171.6" x="567" y="227.7879">Business Application</text><polygon fill="#A80036" points="110.4,78.5156,98.4,83.3156,110.4,88.1156,105.6,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="103.2" x2="654" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="529.2" x="117.6" y="77.2365">transfer(to: "command/DEFAULT_TENANT/4711", subject: "switchOn")</text><path d="M12,98.9156 L12,146.9156 L176.4,146.9156 L176.4,110.9156 L164.4,98.9156 L12,98.9156 " fill="#FBFB77" filter="url(#frby4mmuumt0w)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M164.4,98.9156 L164.4,110.9156 L176.4,110.9156 L164.4,98.9156 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="139.2" x="19.2" y="119.3959">forward command</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="69.6" x="19.2" y="137.5553">to device</text><polygon fill="#A80036" points="640.8,178.5938,652.8,183.3937,640.8,188.1938,645.6,183.3937" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="97.2" x2="648" y1="183.3937" y2="183.3937"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="105.6" y="177.3146">disposition(state: "accepted")</text><!--
+@startuml
+scale 1.2
+
+participant "AMQP 1.0 Network"
+participant "Business Application"
+
+"Business Application" -> "AMQP 1.0 Network": transfer(to: "command/DEFAULT_TENANT/4711", subject: "switchOn")
+note over "AMQP 1.0 Network"
+forward command
+to device
+end note
+"AMQP 1.0 Network" -> "Business Application": disposition(state: "accepted")
+@enduml
+
+PlantUML version 1.2019.07(Mon Jun 24 19:59:20 UTC 2019)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/command-and-control/receive_preconditions.svg b/docs/1.2/api/command-and-control/receive_preconditions.svg
new file mode 100644
index 0000000..63ba733
--- /dev/null
+++ b/docs/1.2/api/command-and-control/receive_preconditions.svg
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="327.6px" preserveAspectRatio="none" style="width:788px;height:327px;" version="1.1" viewBox="0 0 788 327" width="788.4px" zoomAndPan="magnify"><defs><filter height="300%" id="fy69okj2fbq34" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="97.2" x2="97.2" y1="45.9563" y2="279.7125"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="683.4" x2="683.4" y1="45.9563" y2="279.7125"/><rect fill="#FEFECE" filter="url(#fy69okj2fbq34)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="18" y="27.5941">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#fy69okj2fbq34)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="9.6" y="278.5125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="18" y="302.5066">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#fy69okj2fbq34)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="188.4" x="587.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="171.6" x="595.8" y="27.5941">Business Application</text><rect fill="#FEFECE" filter="url(#fy69okj2fbq34)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="188.4" x="587.4" y="278.5125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="171.6" x="595.8" y="302.5066">Business Application</text><polygon fill="#A80036" points="110.4,78.5156,98.4,83.3156,110.4,88.1156,105.6,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="103.2" x2="682.8" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="50.4" x="117.6" y="77.2365">open()</text><polygon fill="#A80036" points="669.6,113.475,681.6,118.275,669.6,123.075,674.4,118.275" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="97.2" x2="676.8" y1="118.275" y2="118.275"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="50.4" x="105.6" y="112.1959">open()</text><polygon fill="#A80036" points="110.4,148.4344,98.4,153.2344,110.4,158.0344,105.6,153.2344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="103.2" x2="682.8" y1="153.2344" y2="153.2344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="375.6" x="117.6" y="147.1553">attach(sender, target: "command/${tenant_id}")</text><polygon fill="#A80036" points="669.6,183.3937,681.6,188.1938,669.6,192.9938,674.4,188.1938" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="97.2" x2="676.8" y1="188.1938" y2="188.1938"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="388.8" x="105.6" y="182.1146">attach(receiver, source: "command/${tenant_id}")</text><polygon fill="#A80036" points="110.4,218.3531,98.4,223.1531,110.4,227.9531,105.6,223.1531" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="103.2" x2="682.8" y1="223.1531" y2="223.1531"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="558" x="117.6" y="217.074">attach(receiver, source: "command_response/${tenant_id}/${reply-id}")</text><polygon fill="#A80036" points="669.6,253.3125,681.6,258.1125,669.6,262.9125,674.4,258.1125" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="97.2" x2="676.8" y1="258.1125" y2="258.1125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="544.8" x="105.6" y="252.0334">attach(sender, target: "command_response/${tenant_id}/${reply-id}")</text><!--
+@startuml
+scale 1.2
+
+participant "AMQP 1.0 Network"
+participant "Business Application"
+
+"Business Application" -> "AMQP 1.0 Network": open()
+"AMQP 1.0 Network" -> "Business Application": open()
+"Business Application" -> "AMQP 1.0 Network": attach(sender, target: "command/${tenant_id}")
+"AMQP 1.0 Network" -> "Business Application": attach(receiver, source: "command/${tenant_id}")
+"Business Application" -> "AMQP 1.0 Network": attach(receiver, source: "command_response/${tenant_id}/${reply-id}")
+"AMQP 1.0 Network" -> "Business Application": attach(sender, target: "command_response/${tenant_id}/${reply-id}")
+@enduml
+
+PlantUML version 1.2019.07(Mon Jun 24 19:59:20 UTC 2019)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/command-and-control/request_response_success.svg b/docs/1.2/api/command-and-control/request_response_success.svg
new file mode 100644
index 0000000..99266fb
--- /dev/null
+++ b/docs/1.2/api/command-and-control/request_response_success.svg
@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="434.4px" preserveAspectRatio="none" style="width:777px;height:434px;" version="1.1" viewBox="0 0 777 434" width="777.6px" zoomAndPan="magnify"><defs><filter height="300%" id="fwzdake5u3445" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="97.2" x2="97.2" y1="45.9563" y2="386.9906"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="672.6" x2="672.6" y1="45.9563" y2="386.9906"/><rect fill="#FEFECE" filter="url(#fwzdake5u3445)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="18" y="27.5941">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#fwzdake5u3445)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="9.6" y="385.7906"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="18" y="409.7848">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#fwzdake5u3445)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="188.4" x="576.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="171.6" x="585" y="27.5941">Business Application</text><rect fill="#FEFECE" filter="url(#fwzdake5u3445)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="188.4" x="576.6" y="385.7906"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="171.6" x="585" y="409.7848">Business Application</text><polygon fill="#A80036" points="110.4,78.5156,98.4,83.3156,110.4,88.1156,105.6,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="103.2" x2="672" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="547.2" x="117.6" y="77.2365">transfer(to: "command/DEFAULT_TENANT/4711", subject: "getReading")</text><path d="M12,98.9156 L12,146.9156 L176.4,146.9156 L176.4,110.9156 L164.4,98.9156 L12,98.9156 " fill="#FBFB77" filter="url(#fwzdake5u3445)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M164.4,98.9156 L164.4,110.9156 L176.4,110.9156 L164.4,98.9156 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="139.2" x="19.2" y="119.3959">forward command</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="69.6" x="19.2" y="137.5553">to device</text><polygon fill="#A80036" points="658.8,178.5938,670.8,183.3937,658.8,188.1938,663.6,183.3937" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="97.2" x2="666" y1="183.3937" y2="183.3937"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="105.6" y="177.3146">disposition(state: "accepted")</text><path d="M16.8,198.9938 L16.8,246.9937 L172.8,246.9937 L172.8,210.9938 L160.8,198.9938 L16.8,198.9938 " fill="#FBFB77" filter="url(#fwzdake5u3445)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M160.8,198.9938 L160.8,210.9938 L172.8,210.9938 L160.8,198.9938 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="130.8" x="24" y="219.474">wait for response</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="90" x="24" y="237.6334">from device</text><polygon fill="#A80036" points="658.8,278.6719,670.8,283.4719,658.8,288.2719,663.6,283.4719" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="97.2" x2="666" y1="283.4719" y2="283.4719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="318" x="105.6" y="277.3928">transfer(status: "200", body: sensor data)</text><path d="M590.4,299.0719 L590.4,329.0719 L751.2,329.0719 L751.2,311.0719 L739.2,299.0719 L590.4,299.0719 " fill="#FBFB77" filter="url(#fwzdake5u3445)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M739.2,299.0719 L739.2,311.0719 L751.2,311.0719 L739.2,299.0719 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="135.6" x="597.6" y="319.5521">process response</text><polygon fill="#A80036" points="110.4,360.5906,98.4,365.3906,110.4,370.1906,105.6,365.3906" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="103.2" x2="672" y1="365.3906" y2="365.3906"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="117.6" y="359.3115">disposition(state: "accepted")</text><!--
+@startuml
+scale 1.2
+
+participant "AMQP 1.0 Network"
+participant "Business Application"
+
+"Business Application" -> "AMQP 1.0 Network": transfer(to: "command/DEFAULT_TENANT/4711", subject: "getReading")
+note over "AMQP 1.0 Network"
+forward command
+to device
+end note
+"AMQP 1.0 Network" -> "Business Application": disposition(state: "accepted")
+note over "AMQP 1.0 Network"
+wait for response
+from device
+end note
+"AMQP 1.0 Network" -> "Business Application": transfer(status: "200", body: sensor data)
+note over "Business Application"
+process response
+end note
+"Business Application" -> "AMQP 1.0 Network": disposition(state: "accepted")
+@enduml
+
+PlantUML version 1.2019.07(Mon Jun 24 19:59:20 UTC 2019)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/command-and-control/response_time_out.svg b/docs/1.2/api/command-and-control/response_time_out.svg
new file mode 100644
index 0000000..23a71e9
--- /dev/null
+++ b/docs/1.2/api/command-and-control/response_time_out.svg
@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="471.6px" preserveAspectRatio="none" style="width:858px;height:471px;" version="1.1" viewBox="0 0 858 471" width="858px" zoomAndPan="magnify"><defs><filter height="300%" id="f1p9gym2onaiff" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f1p9gym2onaiff)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="667.2" y="183.3937"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="97.2" x2="97.2" y1="45.9563" y2="423.3094"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="672.6" x2="672.6" y1="45.9563" y2="423.3094"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="815.4" x2="815.4" y1="45.9563" y2="423.3094"/><rect fill="#FEFECE" filter="url(#f1p9gym2onaiff)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="18" y="27.5941">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#f1p9gym2onaiff)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="9.6" y="422.1094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="18" y="446.1035">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#f1p9gym2onaiff)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="188.4" x="576.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="171.6" x="585" y="27.5941">Business Application</text><rect fill="#FEFECE" filter="url(#f1p9gym2onaiff)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="188.4" x="576.6" y="422.1094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="171.6" x="585" y="446.1035">Business Application</text><rect fill="#FEFECE" filter="url(#f1p9gym2onaiff)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="781.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="790.2" y="27.5941">Timer</text><rect fill="#FEFECE" filter="url(#f1p9gym2onaiff)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="781.8" y="422.1094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="790.2" y="446.1035">Timer</text><rect fill="#FFFFFF" filter="url(#f1p9gym2onaiff)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="667.2" y="183.3937"/><polygon fill="#A80036" points="110.4,78.5156,98.4,83.3156,110.4,88.1156,105.6,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="103.2" x2="672" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="547.2" x="117.6" y="77.2365">transfer(to: "command/DEFAULT_TENANT/4711", subject: "getReading")</text><path d="M12,98.9156 L12,146.9156 L176.4,146.9156 L176.4,110.9156 L164.4,98.9156 L12,98.9156 " fill="#FBFB77" filter="url(#f1p9gym2onaiff)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M164.4,98.9156 L164.4,110.9156 L176.4,110.9156 L164.4,98.9156 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="139.2" x="19.2" y="119.3959">forward command</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="69.6" x="19.2" y="137.5553">to device</text><polygon fill="#A80036" points="652.8,178.5938,664.8,183.3937,652.8,188.1938,657.6,183.3937" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="97.2" x2="660" y1="183.3937" y2="183.3937"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="105.6" y="177.3146">disposition(state: "accepted")</text><polygon fill="#A80036" points="801.6,213.5531,813.6,218.3531,801.6,223.1531,806.4,218.3531" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="673.2" x2="808.8" y1="218.3531" y2="218.3531"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="36" x="681.6" y="212.274">start</text><path d="M592.8,233.9531 L592.8,281.9531 L748.8,281.9531 L748.8,245.9531 L736.8,233.9531 L592.8,233.9531 " fill="#FBFB77" filter="url(#f1p9gym2onaiff)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M736.8,233.9531 L736.8,245.9531 L748.8,245.9531 L736.8,233.9531 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="130.8" x="600" y="254.4334">wait for response</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="90" x="600" y="272.5928">from device</text><polygon fill="#A80036" points="686.4,313.6312,674.4,318.4313,686.4,323.2313,681.6,318.4313" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="679.2" x2="814.8" y1="318.4313" y2="318.4313"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="104.4" x="693.6" y="312.3521">fail command</text><path d="M566.4,334.0313 L566.4,400.0313 L775.2,400.0313 L775.2,346.0313 L763.2,334.0313 L566.4,334.0313 " fill="#FBFB77" filter="url(#f1p9gym2onaiff)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M763.2,334.0313 L763.2,346.0313 L775.2,346.0313 L763.2,334.0313 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="139.2" x="573.6" y="354.5115">may want to close</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="573.6" y="372.6709">response link</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="183.6" x="573.6" y="390.8303">(if scoped to command)</text><!--
+@startuml
+scale 1.2
+
+participant "AMQP 1.0 Network"
+participant "Business Application"
+participant Timer
+
+"Business Application" -> "AMQP 1.0 Network": transfer(to: "command/DEFAULT_TENANT/4711", subject: "getReading")
+note over "AMQP 1.0 Network"
+forward command
+to device
+end note
+"AMQP 1.0 Network" -> "Business Application"++: disposition(state: "accepted")
+"Business Application" -> Timer-: start
+note over "Business Application"
+wait for response
+from device
+end note
+Timer -> "Business Application": fail command
+note over "Business Application"
+may want to close
+response link
+(if scoped to command)
+end note
+@enduml
+
+PlantUML version 1.2019.07(Mon Jun 24 19:59:20 UTC 2019)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/command-and-control/send_preconditions.svg b/docs/1.2/api/command-and-control/send_preconditions.svg
new file mode 100644
index 0000000..1a07746
--- /dev/null
+++ b/docs/1.2/api/command-and-control/send_preconditions.svg
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="258px" preserveAspectRatio="none" style="width:619px;height:258px;" version="1.1" viewBox="0 0 619 258" width="619.2px" zoomAndPan="magnify"><defs><filter height="300%" id="fjqnkoz0hmfro" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="97.2" x2="97.2" y1="45.9563" y2="209.7938"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="514.2" x2="514.2" y1="45.9563" y2="209.7938"/><rect fill="#FEFECE" filter="url(#fjqnkoz0hmfro)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="18" y="27.5941">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#fjqnkoz0hmfro)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="9.6" y="208.5938"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="18" y="232.5879">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#fjqnkoz0hmfro)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="188.4" x="418.2" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="171.6" x="426.6" y="27.5941">Business Application</text><rect fill="#FEFECE" filter="url(#fjqnkoz0hmfro)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="188.4" x="418.2" y="208.5938"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="171.6" x="426.6" y="232.5879">Business Application</text><polygon fill="#A80036" points="110.4,78.5156,98.4,83.3156,110.4,88.1156,105.6,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="103.2" x2="513.6" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="50.4" x="117.6" y="77.2365">open()</text><polygon fill="#A80036" points="500.4,113.475,512.4,118.275,500.4,123.075,505.2,118.275" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="97.2" x2="507.6" y1="118.275" y2="118.275"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="50.4" x="105.6" y="112.1959">open()</text><polygon fill="#A80036" points="110.4,148.4344,98.4,153.2344,110.4,158.0344,105.6,153.2344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="103.2" x2="513.6" y1="153.2344" y2="153.2344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="375.6" x="117.6" y="147.1553">attach(sender, target: "command/${tenant_id}")</text><polygon fill="#A80036" points="500.4,183.3937,512.4,188.1938,500.4,192.9938,505.2,188.1938" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="97.2" x2="507.6" y1="188.1938" y2="188.1938"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="388.8" x="105.6" y="182.1146">attach(receiver, source: "command/${tenant_id}")</text><!--
+@startuml
+scale 1.2
+
+participant "AMQP 1.0 Network"
+participant "Business Application"
+
+"Business Application" -> "AMQP 1.0 Network": open()
+"AMQP 1.0 Network" -> "Business Application": open()
+"Business Application" -> "AMQP 1.0 Network": attach(sender, target: "command/${tenant_id}")
+"AMQP 1.0 Network" -> "Business Application": attach(receiver, source: "command/${tenant_id}")
+@enduml
+
+PlantUML version 1.2019.07(Mon Jun 24 19:59:20 UTC 2019)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/credentials/get-credentials-success.svg b/docs/1.2/api/credentials/get-credentials-success.svg
new file mode 100644
index 0000000..c613d22
--- /dev/null
+++ b/docs/1.2/api/credentials/get-credentials-success.svg
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="318px" preserveAspectRatio="none" style="width:510px;height:318px;" version="1.1" viewBox="0 0 510 318" width="510px" zoomAndPan="magnify"><defs><filter height="300%" id="f1dsrh88hi7ryz" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f1dsrh88hi7ryz)" height="165.1969" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="406.2" y="83.3156"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="43.2" x2="43.2" y1="45.9563" y2="270.1125"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="412.2" x2="412.2" y1="45.9563" y2="270.1125"/><rect fill="#FEFECE" filter="url(#f1dsrh88hi7ryz)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="27.5941">Client</text><rect fill="#FEFECE" filter="url(#f1dsrh88hi7ryz)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="268.9125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="292.9066">Client</text><rect fill="#FEFECE" filter="url(#f1dsrh88hi7ryz)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="175.2" x="322.2" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="158.4" x="330.6" y="27.5941">Credentials Service</text><rect fill="#FEFECE" filter="url(#f1dsrh88hi7ryz)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="175.2" x="322.2" y="268.9125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="158.4" x="330.6" y="292.9066">Credentials Service</text><rect fill="#FFFFFF" filter="url(#f1dsrh88hi7ryz)" height="165.1969" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="406.2" y="83.3156"/><polygon fill="#A80036" points="391.8,78.5156,403.8,83.3156,391.8,88.1156,396.6,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="399" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="339.6" x="52.2" y="77.2365">transfer(subject: "get", body: search criteria)</text><path d="M49.2,98.9156 L49.2,164.9156 L258,164.9156 L258,110.9156 L246,98.9156 L49.2,98.9156 " fill="#FBFB77" filter="url(#f1dsrh88hi7ryz)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M246,98.9156 L246,110.9156 L258,110.9156 L246,98.9156 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="183.6" x="56.4" y="119.3959">search criteria is a JSON</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="152.4" x="56.4" y="137.5553">object that contains</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="126" x="56.4" y="155.7146">type and auth-id</text><path d="M327.6,182.1938 L327.6,212.1938 L492,212.1938 L492,194.1938 L480,182.1938 L327.6,182.1938 " fill="#FBFB77" filter="url(#f1dsrh88hi7ryz)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M480,182.1938 L480,194.1938 L492,194.1938 L480,182.1938 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="139.2" x="334.8" y="202.674">lookup credentials</text><polygon fill="#A80036" points="57,243.7125,45,248.5125,57,253.3125,52.2,248.5125" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="411" y1="248.5125" y2="248.5125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="64.2" y="242.4334">transfer(status: "200", body: credentials)</text><!--
+@startuml
+scale 1.2
+
+Client -> "Credentials Service"++: transfer(subject: "get", body: search criteria)
+note right of Client
+search criteria is a JSON
+object that contains
+type and auth-id
+end note
+
+note over "Credentials Service"
+lookup credentials
+end note
+
+"Credentials Service" -> Client- -: transfer(status: "200", body: credentials)
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/credentials/index.html b/docs/1.2/api/credentials/index.html
new file mode 100644
index 0000000..b8abb23
--- /dev/null
+++ b/docs/1.2/api/credentials/index.html
@@ -0,0 +1,3131 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Credentials API Specification :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Credentials API Specification :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Credentials API Specification :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/api/credentials//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/api/credentials/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item active">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/api/credentials/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/credentials/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/api/credentials/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/api/credentials/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/api/credentials/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/api/credentials/index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/api/'>API</a> > Credentials API Specification
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#preconditions-for-invoking-the-credentials-api">Preconditions for invoking the Credentials API</a></li>
+<li><a href="#get-credentials">Get Credentials</a></li>
+<li><a href="#delivery-states">Delivery States</a></li>
+<li><a href="#credentials-format">Credentials Format</a>
+<ul>
+<li><a href="#secrets-format">Secrets Format</a></li>
+<li><a href="#examples">Examples</a></li>
+</ul></li>
+<li><a href="#credential-verification">Credential Verification</a></li>
+<li><a href="#standard-credential-types">Standard Credential Types</a>
+<ul>
+<li><a href="#common-properties">Common Properties</a></li>
+<li><a href="#hashed-password">Hashed Password</a></li>
+<li><a href="#pre-shared-key">Pre-Shared Key</a></li>
+<li><a href="#x-509-certificate">X.509 Certificate</a></li>
+</ul></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Credentials API Specification</h1>
+          
+
+        
+
+
+<p>The <em>Credentials API</em> is used by <em>Protocol Adapters</em> to retrieve credentials used to authenticate <em>Devices</em> connecting to the adapter. In particular, the API supports to look up <em>shared secrets</em> which are often used by IoT devices by means of <em>username/password</em> based authentication schemes.</p>
+
+<p>Credentials are of a certain <em>type</em> which indicates which authentication mechanism the credentials can be used with. Each set of credentials also contains an <em>authentication identity</em> which is the identity claimed by the device during authentication. This authentication identity is usually different from the <em>device-id</em> the device has been registered under. A device may have multiple sets of credentials, using arbitrary <em>authentication identities</em>.</p>
+
+<p>The Credentials API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using an AMQP 1.0 client in order to invoke operations of the API as described in the following sections.</p>
+
+<p><a name="preconditions"></a></p>
+
+<h2 id="preconditions-for-invoking-the-credentials-api">Preconditions for invoking the Credentials API</h2>
+
+<ol>
+<li>Client has established an AMQP connection with the Credentials service.</li>
+<li>Client has established an AMQP link in role <em>sender</em> on the connection using target address <code>credentials/${tenant_id}</code>. This link is used by the client to send commands to the Credentials service.</li>
+<li>Client has established an AMQP link in role <em>receiver</em> on the connection using source address <code>credentials/${tenant_id}/${reply-to}</code> where <em>reply-to</em> may be any arbitrary string chosen by the client. This link is used by the client to receive responses to the requests it has sent to the Credentials service. This link&rsquo;s source address is also referred to as the <em>reply-to</em> address for the request messages.</li>
+</ol>
+
+<figure>
+    <img src="preconditions.svg"
+         alt="A client establishes an AMQP connection and the links required to invoke operations of the Credentials service"/> <figcaption>
+            <h4>Client connecting to Credentials service</h4>
+        </figcaption>
+</figure>
+
+
+<h2 id="get-credentials">Get Credentials</h2>
+
+<p>Protocol adapters use this command to <em>look up</em> credentials of a particular type for a device identity.</p>
+
+<p><strong>Message Flow</strong></p>
+
+<figure>
+    <img src="get-credentials-success.svg"
+         alt="A client sends a request message for looking up device credentials and receives a response containing the credentials"/> <figcaption>
+            <h4>Client looking up credentials for a device</h4>
+        </figcaption>
+</figure>
+
+
+<p><strong>Request Message Format</strong></p>
+
+<p>The following table provides an overview of the properties a client needs to set on an <em>get credentials</em> message.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">AMQP Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>correlation-id</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>message-id</em></td>
+<td align="left">MAY contain an ID used to correlate a response message to the original request. If set, it is used as the <em>correlation-id</em> property in the response, otherwise the value of the <em>message-id</em> property is used. Either this or the <em>message-id</em> property MUST be set.</td>
+</tr>
+
+<tr>
+<td align="left"><em>message-id</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MAY contain an identifier that uniquely identifies the message at the sender side. Either this or the <em>correlation-id</em> property MUST be set.</td>
+</tr>
+
+<tr>
+<td align="left"><em>reply-to</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST contain the source address that the client wants to receive response messages from. This address MUST be the same as the source address used for establishing the client&rsquo;s receive link (see <a href="#preconditions-for-invoking-the-credentials-api">Preconditions</a>).</td>
+</tr>
+
+<tr>
+<td align="left"><em>subject</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST contain the value <code>get</code>.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The body of the request MUST consist of a single <em>Data</em> section containing a UTF-8 encoded string representation of a single JSON object having the following members:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">JSON Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>type</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The type of credentials to look up. Potential values include (but are not limited to) <code>psk</code>, <code>x509-cert</code>, <code>hashed-password</code> etc.</td>
+</tr>
+
+<tr>
+<td align="left"><em>auth-id</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The authentication identifier to look up credentials for.</td>
+</tr>
+
+<tr>
+<td align="left"><em>client-certificate</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The client certificate the device authenticated with. If present, it MUST be the DER encoding of the (validated) X.509 client certificate as a Base64 encoded byte array and it&rsquo;s subject DN MUST match the <em>auth-id</em>.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The <em>client-certificate</em> property MAY be used by the service implementation for auto-provisioning of devices.
+To do so, the device registry needs to create credentials (and registration data) for the device if they do not already exist.</p>
+
+<p>Additionally, the body MAY contain arbitrary properties that service implementations can use to determine a device&rsquo;s identity.</p>
+
+<p>The following request payload may be used to look up the hashed password for a device with the authentication identifier <code>sensor1</code>:</p>
+
+<pre><code class="language-json">{
+  &quot;type&quot;: &quot;hashed-password&quot;,
+  &quot;auth-id&quot;: &quot;sensor1&quot;
+}
+</code></pre>
+
+<p>The following request payload may be used to look up <em>or create</em> <code>x509-cert</code> credentials for a device with the authentication identifier <code>CN=device-1,O=ACME Corporation</code>:</p>
+
+<pre><code class="language-json">{
+  &quot;type&quot;: &quot;x509-cert&quot;,
+  &quot;auth-id&quot;: &quot;CN=device-1,O=ACME Corporation&quot;,
+  &quot;client-certificate&quot;: &quot;DeviceCert==&quot;
+}
+</code></pre>
+
+<p><strong>Response Message Format</strong></p>
+
+<p>A response to a <em>get credentials</em> request contains the following properties:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">AMQP Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>correlation-id</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>message-id</em></td>
+<td align="left">Contains the <em>message-id</em> (or the <em>correlation-id</em>, if specified) of the request message that this message is the response to.</td>
+</tr>
+
+<tr>
+<td align="left"><em>content-type</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST be set to <code>application/json</code> if the invocation of the operation was successful and the body of the response message contains payload as described below.</td>
+</tr>
+
+<tr>
+<td align="left"><em>status</em></td>
+<td align="center">yes</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>int</em></td>
+<td align="left">Contains the status code indicating the outcome of the operation. Concrete values and their semantics are defined below.</td>
+</tr>
+
+<tr>
+<td align="left"><em>cache_control</em></td>
+<td align="center">no</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">Contains an <a href="https://tools.ietf.org/html/rfc2616#section-14.9">RFC 2616</a> compliant <em>cache directive</em>. The directive contained in the property MUST be obeyed by clients that are caching responses.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The response message payload MUST contain credential information as defined in <a href="#credentials-format">Credentials Format</a> if the <em>status</em> is <code>200</code> or <code>201</code>.</p>
+
+<p>The response message&rsquo;s <em>status</em> property may contain the following codes:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Code</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>200</em></td>
+<td align="left">OK, the payload contains the credentials for the authentication identifier.</td>
+</tr>
+
+<tr>
+<td align="left"><em>201</em></td>
+<td align="left">Created, the payload contains the newly created credentials for the authentication identifier.</td>
+</tr>
+
+<tr>
+<td align="left"><em>400</em></td>
+<td align="left">Bad Request, the request message did not contain all mandatory properties or the subject DN of the certificate does not match the authentication identifier.</td>
+</tr>
+
+<tr>
+<td align="left"><em>404</em></td>
+<td align="left">Not Found, there are no credentials registered matching the criteria.</td>
+</tr>
+</tbody>
+</table>
+
+<p>For status codes indicating an error (codes in the <code>400 - 499</code> range) the message body MAY contain a detailed description of the error that occurred.
+In this case, the response message&rsquo;s <em>content-type</em> property SHOULD be set accordingly.</p>
+
+<h2 id="delivery-states">Delivery States</h2>
+
+<p>The Credentials service uses the following AMQP message delivery states when receiving request messages from clients:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Delivery State</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>ACCEPTED</em></td>
+<td align="left">Indicates that the request message has been received and accepted for processing.</td>
+</tr>
+
+<tr>
+<td align="left"><em>REJECTED</em></td>
+<td align="left">Indicates that the request message has been received but cannot be processed. The disposition frame&rsquo;s <em>error</em> field contains information regarding the reason why. Clients should not try to re-send the request using the same message properties in this case.</td>
+</tr>
+</tbody>
+</table>
+
+<h2 id="credentials-format">Credentials Format</h2>
+
+<p>Credential data is carried in the body of an AMQP message as part of a single <em>Data</em> section. The message&rsquo;s <em>content-type</em> property must be set to <code>application/json</code>.</p>
+
+<p>The credential data is contained in the Data section as a UTF-8 encoded string representation of a single JSON object. It is an error to include payload that is not of this type.</p>
+
+<p>The table below provides an overview of the standard members defined for the JSON object:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">JSON Type</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>device-id</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left"></td>
+<td align="left">The ID of the device to which the credentials belong.</td>
+</tr>
+
+<tr>
+<td align="left"><em>type</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left"></td>
+<td align="left">The credential type name. The value may be arbitrarily chosen by clients but SHOULD reflect the particular type of authentication mechanism the credentials are to be used with. Possible values include (but are not limited to) <code>psk</code>, <code>x509-cert</code>, <code>hashed-password</code> etc.</td>
+</tr>
+
+<tr>
+<td align="left"><em>auth-id</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left"></td>
+<td align="left">The identity that the device should be authenticated as.</td>
+</tr>
+
+<tr>
+<td align="left"><em>enabled</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>boolean</em></td>
+<td align="left"><em>true</em></td>
+<td align="left">If set to <em>false</em> the credentials are not supposed to be used to authenticate devices any longer. This may e.g. be used to disable a particular mechanism for authenticating the device. <strong>NB</strong> It is the responsibility of the protocol adapter to make use of this information.</td>
+</tr>
+
+<tr>
+<td align="left"><em>secrets</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>array</em></td>
+<td align="left"></td>
+<td align="left">A list of secrets scoped to a particular time period. See <a href="#secrets-format">Secrets Format</a> for details. <strong>NB</strong> This array must contain at least one element - an empty array is considered an error.</td>
+</tr>
+</tbody>
+</table>
+
+<p>For each set of credentials the combination of <em>auth-id</em> and <em>type</em> MUST be unique within a tenant.</p>
+
+<p>The device registry may choose to not return information which is not suitable for authentication a device. This includes for example the <code>enabled</code> property. If set to <code>false</code>, then the device registry may choose to treat this request as if no credentials would be found. For secrets for example, this could mean that the device registry does not return secrets which are not valid at the current point in time.</p>
+
+<p><strong>NB</strong> Care needs to be taken that the value for the <em>authentication identifier</em> is compliant with the authentication mechanism(s) it is supposed to be used with. For example, when using standard HTTP Basic authentication, the <em>username</em> part of the Basic Authorization header value (which corresponds to the <em>auth-id</em>) MUST not contain any <em>colon</em> (<code>:</code>) characters, because the colon character is used as the separator between username and password. Similar constraints may exist for other authentication mechanisms, so the <em>authentication identifier</em> needs to be chosen with the anticipated mechanism(s) being used in mind. Otherwise, devices may fail to authenticate with protocol adapters, even if the credentials provided by the device match the credentials registered for the device. In general, using only characters from the <code>[a-zA-Z0-9_-]</code> range for the authentication identifier should be compatible with most mechanisms.</p>
+
+<h3 id="secrets-format">Secrets Format</h3>
+
+<p>Each set of credentials may contain arbitrary <em>secrets</em> scoped to a particular <em>validity period</em> during which the secrets may be used for authenticating a device. The validity periods MAY overlap in order to support the process of changing a secret on a device that itself doesn&rsquo;t support the definition of multiple secrets for gapless authentication across adjacent validity periods.</p>
+
+<p>The table below contains the properties used to define the validity period of a single secret:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">JSON Type</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>not-before</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>string</em></td>
+<td align="left"><code>null</code></td>
+<td align="left">The point in time from which on the secret may be used to authenticate devices. If not <em>null</em>, the value MUST be an <a href="https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations">ISO 8601 compliant <em>combined date and time representation in extended format</em></a>. <strong>NB</strong> It is up to the discretion of the protocol adapter to make use of this information.</td>
+</tr>
+
+<tr>
+<td align="left"><em>not-after</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>string</em></td>
+<td align="left"><code>null</code></td>
+<td align="left">The point in time until which the secret may be used to authenticate devices. If not <em>null</em>, the value MUST be an <a href="https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations">ISO 8601 compliant <em>combined date and time representation in extended format</em></a>. <strong>NB</strong> It is up to the discretion of the protocol adapter to make use of this information.</td>
+</tr>
+</tbody>
+</table>
+
+<h3 id="examples">Examples</h3>
+
+<p>Below is an example for a payload containing <a href="#hashed-password">a hashed password</a> for device <code>4711</code> with auth-id <code>sensor1</code> using SHA512 as the hashing function with a 4 byte salt (Base64 encoding of <code>0x32AEF017</code>). Note that the payload does not contain a <code>not-before</code> property, thus it may be used immediately up until X-mas eve 2017.</p>
+
+<pre><code class="language-json">{
+  &quot;device-id&quot;: &quot;4711&quot;,
+  &quot;type&quot;: &quot;hashed-password&quot;,
+  &quot;auth-id&quot;: &quot;sensor1&quot;,
+  &quot;enabled&quot;: true,
+  &quot;secrets&quot;: [{
+    &quot;not-after&quot;: &quot;2017-12-24T19:00:00+0100&quot;,
+    &quot;pwd-hash&quot;: &quot;AQIDBAUGBwg=&quot;,
+    &quot;salt&quot;: &quot;Mq7wFw==&quot;,
+    &quot;hash-function&quot;: &quot;sha-512&quot;
+  }]
+}
+</code></pre>
+
+<p>The next example contains two <a href="#pre-shared-key">pre-shared keys</a> with overlapping validity periods for device <code>myDevice</code> with PSK identity <code>little-sensor2</code>.</p>
+
+<pre><code class="language-json">{
+  &quot;device-id&quot;: &quot;myDevice&quot;,
+  &quot;type&quot;: &quot;psk&quot;,
+  &quot;auth-id&quot;: &quot;little-sensor2&quot;,
+  &quot;enabled&quot;: true,
+  &quot;secrets&quot;: [{
+    &quot;not-after&quot;: &quot;2017-07-01T00:00:00+0100&quot;,
+    &quot;key&quot;: &quot;cGFzc3dvcmRfb2xk&quot;
+  },{
+    &quot;not-before&quot;: &quot;2017-06-29T00:00:00+0100&quot;,
+    &quot;key&quot;: &quot;cGFzc3dvcmRfbmV3&quot;
+  }]
+}
+</code></pre>
+
+<h2 id="credential-verification">Credential Verification</h2>
+
+<p>Protocol Adapters are responsible for authenticating devices when they connect. The Credentials API provides the <a href="#get-credentials">Get Credentials</a> operation to support Protocol Adapters in doing so as illustrated below:</p>
+
+<p>The following sequence diagram illustrates the flow of messages involved in a <em>Protocol Adapter</em> authenticating a device.
+This is shown for the <em>MQTT Protocol Adapter</em> as example how a device authenticates with a username and a hashed-password.
+The mechanism can be transferred to other protocols in a similar manner.</p>
+
+<figure>
+    <img src="mqtt_adapter_device_authentication.svg"
+         alt="The MQTT Adapter sends a request message for looking up credentials presented by a device and receives a response containing the credentials for verification"/> <figcaption>
+            <h4>MQTT Adapter authenticates device using the Credentials service</h4>
+        </figcaption>
+</figure>
+
+
+<p>Protocol adapters MUST comply with the following rules when verifying credentials presented by a device:</p>
+
+<ul>
+<li>Credentials that have their <em>enabled</em> property set to <code>false</code> MUST NOT be used for authentication.</li>
+
+<li><p>Adapters MUST only consider secrets for authentication which</p>
+
+<ul>
+<li>have their <em>not-before</em> property set to either <code>null</code> or the current or a past point in time <strong>and</strong></li>
+<li>have their <em>not-after</em> property set to either <code>null</code> or the current or a future point in time.</li>
+</ul></li>
+</ul>
+
+<h2 id="standard-credential-types">Standard Credential Types</h2>
+
+<p>The following sections define some standard credential types and their properties. Applications are encouraged to make use of these types. However, the types are not enforced anywhere in Hono and clients may of course add application specific properties to the credential types.</p>
+
+<h3 id="common-properties">Common Properties</h3>
+
+<p>All credential types used with Hono MUST contain <code>device-id</code>, <code>type</code>, <code>auth-id</code>, <code>enabled</code> and <code>secrets</code> properties as defined in <a href="#credentials-format">Credentials Format</a>.</p>
+
+<h3 id="hashed-password">Hashed Password</h3>
+
+<p>A credential type for storing a (hashed) password for a device.</p>
+
+<p>Example:</p>
+
+<pre><code class="language-json">{
+  &quot;device-id&quot;: &quot;4711&quot;,
+  &quot;type&quot;: &quot;hashed-password&quot;,
+  &quot;auth-id&quot;: &quot;sensor1&quot;,
+  &quot;secrets&quot;: [{
+    &quot;pwd-hash&quot;: &quot;AQIDBAUGBwg=&quot;,
+    &quot;salt&quot;: &quot;Mq7wFw==&quot;,
+    &quot;hash-function&quot;: &quot;sha-512&quot;
+  }]
+}
+</code></pre>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">JSON Type</th>
+<th align="left">Default</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>type</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left"></td>
+<td align="left">The credential type name, always <code>hashed-password</code>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>auth-id</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left"></td>
+<td align="left">The identity that the device should be authenticated as.</td>
+</tr>
+
+<tr>
+<td align="left"><em>pwd-hash</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left"></td>
+<td align="left">The password hash (see table below for details).</td>
+</tr>
+
+<tr>
+<td align="left"><em>salt</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>string</em></td>
+<td align="left"></td>
+<td align="left">The Base64 encoding of the <em>salt</em> used in the password hash (see table below for details).</td>
+</tr>
+
+<tr>
+<td align="left"><nobr><em>hash-function</em><nobr></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>string</em></td>
+<td align="left"><code>sha-256</code></td>
+<td align="left">The name of the hash function used to create the password hash. The hash functions supported by Hono are described in the table below.</td>
+</tr>
+</tbody>
+</table>
+
+<p><strong>NB</strong> It is strongly recommended to use salted password hashes only. Furthermore, the salt should be unique per user and password, so no lookup table or rainbow table attacks can be used to crack the salt-hashed password.
+Whenever a password is updated for a user, the salt should change as well.</p>
+
+<p><strong>NB</strong> The example above does not contain any of the <code>not-before</code>, <code>not-after</code> and <code>enabled</code> properties, thus the credentials can be used at any time according to the rules defined in <a href="#credential-verification">Credential Verification</a>.</p>
+
+<p>The table below describes the hash functions supported by Hono and how they map to the <em>secret</em> structure.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Salt Usage</th>
+<th align="left">Salt Location</th>
+<th align="left">Password Hash Format</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>sha-256</em></td>
+<td align="center">optional</td>
+<td align="left"><em>salt</em> field</td>
+<td align="left">The Base64 encoding of the bytes resulting from applying the <em>sha-256</em> hash function to the byte array consisting of the salt bytes (if a salt is used) and the UTF-8 encoding of the clear text password.</td>
+</tr>
+
+<tr>
+<td align="left"><em>sha-512</em></td>
+<td align="center">optional</td>
+<td align="left"><em>salt</em> field</td>
+<td align="left">The Base64 encoding of the bytes resulting from applying the <em>sha-512</em> hash function to the byte array consisting of the salt bytes (if a salt is used) and the UTF-8 encoding of the clear text password.</td>
+</tr>
+
+<tr>
+<td align="left"><em>bcrypt</em></td>
+<td align="center">mandatory</td>
+<td align="left"><em>pwd-hash</em> value</td>
+<td align="left">The output of applying the <em>Bcrypt</em> hash function to the clear text password. The salt is contained in the password hash.<br><strong>NB</strong> Hono (currently) uses <a href="https://docs.spring.io/spring-security/site/docs/4.2.7.RELEASE/reference/htmlsingle/#core-services-password-encoding">Spring Security</a> for matching clear text passwords against Bcrypt hashes. However, this library only supports hashes containing the <code>$2a$</code> prefix (see <a href="https://github.com/fpirsch/twin-bcrypt#about-prefixes">https://github.com/fpirsch/twin-bcrypt#about-prefixes</a>) so Hono will fail to verify any passwords for which the corresponding Bcrypt hashes returned by the Credentials service contain e.g. the <code>$2y$</code> prefix.</td>
+</tr>
+</tbody>
+</table>
+
+<h3 id="pre-shared-key">Pre-Shared Key</h3>
+
+<p>A credential type for storing a <em>Pre-shared Key</em> as used in TLS handshakes.</p>
+
+<p>Example:</p>
+
+<pre><code class="language-json">{
+  &quot;device-id&quot;: &quot;4711&quot;,
+  &quot;type&quot;: &quot;psk&quot;,
+  &quot;auth-id&quot;: &quot;little-sensor2&quot;,
+  &quot;secrets&quot;: [{
+    &quot;key&quot;: &quot;AQIDBAUGBwg=&quot;
+  }]
+}
+</code></pre>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">JSON Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>type</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The credential type name, always <code>psk</code>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>auth-id</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The PSK identity.</td>
+</tr>
+
+<tr>
+<td align="left"><em>key</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The Base64 encoded bytes representing the shared (secret) key.</td>
+</tr>
+</tbody>
+</table>
+
+<p><strong>NB</strong> The example above does not contain any of the <code>not-before</code>, <code>not-after</code> and <code>enabled</code> properties, thus the credentials can be used at any time according to the rules defined in <a href="#credential-verification">Credential Verification</a>.</p>
+
+<h3 id="x-509-certificate">X.509 Certificate</h3>
+
+<p>A credential type for storing the <a href="https://www.ietf.org/rfc/rfc2253.txt">RFC 2253</a> formatted <em>subject DN</em> of a client certificate that is used to authenticate the device as part of a TLS handshake.</p>
+
+<p>Example:</p>
+
+<pre><code class="language-json">{
+  &quot;device-id&quot;: &quot;4711&quot;,
+  &quot;type&quot;: &quot;x509-cert&quot;,
+  &quot;auth-id&quot;: &quot;CN=device-1,O=ACME Corporation&quot;,
+  &quot;secrets&quot;: [{}]
+}
+</code></pre>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">JSON Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>type</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The credential type name, always <code>x509-cert</code>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>auth-id</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The subject DN of the client certificate in the format defined by <a href="https://www.ietf.org/rfc/rfc2253.txt">RFC 2253</a>.</td>
+</tr>
+</tbody>
+</table>
+
+<p><strong>NB</strong> The example above does not contain any of the <code>not-before</code>, <code>not-after</code> and <code>enabled</code> properties. The <code>not-before</code> and <code>not-after</code> properties should be omitted if the validity period is the same as the period indicated by the client certificate&rsquo;s corresponding properties. It is still necessary to provide a (empty) JSON object in the <em>secrets</em> array, though.</p>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/api/credentials/mqtt_adapter_device_authentication.svg b/docs/1.2/api/credentials/mqtt_adapter_device_authentication.svg
new file mode 100644
index 0000000..e959d61
--- /dev/null
+++ b/docs/1.2/api/credentials/mqtt_adapter_device_authentication.svg
@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="369.6px" preserveAspectRatio="none" style="width:1081px;height:369px;" version="1.1" viewBox="0 0 1081 369" width="1081.2px" zoomAndPan="magnify"><defs><filter height="300%" id="f1qbr6ythy67tc" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f1qbr6ythy67tc)" height="216.9562" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="318.6" y="83.3156"/><rect fill="#FFFFFF" filter="url(#f1qbr6ythy67tc)" height="81.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="977.4" y="118.275"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="48" x2="48" y1="45.9563" y2="321.8719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="324" x2="324" y1="45.9563" y2="321.8719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="983.4" x2="983.4" y1="45.9563" y2="321.8719"/><rect fill="#FEFECE" filter="url(#f1qbr6ythy67tc)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="18" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#f1qbr6ythy67tc)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="9.6" y="320.6719"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="18" y="344.666">Device</text><rect fill="#FEFECE" filter="url(#f1qbr6ythy67tc)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="135.6" x="254.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="262.8" y="27.5941">MQTT Adapter</text><rect fill="#FEFECE" filter="url(#f1qbr6ythy67tc)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="135.6" x="254.4" y="320.6719"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="262.8" y="344.666">MQTT Adapter</text><rect fill="#FEFECE" filter="url(#f1qbr6ythy67tc)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="175.2" x="893.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="158.4" x="901.8" y="27.5941">Credentials Service</text><rect fill="#FEFECE" filter="url(#f1qbr6ythy67tc)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="175.2" x="893.4" y="320.6719"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="158.4" x="901.8" y="344.666">Credentials Service</text><rect fill="#FFFFFF" filter="url(#f1qbr6ythy67tc)" height="216.9562" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="318.6" y="83.3156"/><rect fill="#FFFFFF" filter="url(#f1qbr6ythy67tc)" height="81.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="977.4" y="118.275"/><polygon fill="#A80036" points="304.2,78.5156,316.2,83.3156,304.2,88.1156,309,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="48.6" x2="311.4" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="247.2" x="57" y="77.2365">CONNECT(username, password)</text><polygon fill="#A80036" points="963,113.475,975,118.275,963,123.075,967.8,118.275" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="330.6" x2="970.2" y1="118.275" y2="118.275"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="624" x="339" y="112.1959">transfer(subject: "get", body: {"type": "hashed-password", "auth-id": $username})</text><path d="M898.8,133.875 L898.8,163.875 L1063.2,163.875 L1063.2,145.875 L1051.2,133.875 L898.8,133.875 " fill="#FBFB77" filter="url(#f1qbr6ythy67tc)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M1051.2,133.875 L1051.2,145.875 L1063.2,145.875 L1051.2,133.875 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="139.2" x="906" y="154.3553">lookup credentials</text><polygon fill="#A80036" points="343.8,195.3937,331.8,200.1938,343.8,204.9938,339,200.1938" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="336.6" x2="982.2" y1="200.1938" y2="200.1938"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="351" y="194.1146">transfer(status: "200", body: credentials)</text><path d="M70.8,215.7938 L70.8,263.7938 L573.6,263.7938 L573.6,227.7938 L561.6,215.7938 L70.8,215.7938 " fill="#FBFB77" filter="url(#f1qbr6ythy67tc)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M561.6,215.7938 L561.6,227.7938 L573.6,227.7938 L561.6,215.7938 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="349.2" x="78" y="236.274">1.) Apply (salted) hash-algorithm to password</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="477.6" x="78" y="254.4334">2.) Compare result with the hashed-password from credentials</text><polygon fill="#A80036" points="61.8,295.4719,49.8,300.2719,61.8,305.0719,57,300.2719" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="54.6" x2="323.4" y1="300.2719" y2="300.2719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="78" x="69" y="294.1928">CONNACK</text><!--
+@startuml
+scale 1.2
+
+Device -> "MQTT Adapter"++: CONNECT(username, password)
+
+"MQTT Adapter" -> "Credentials Service"++: transfer(subject: "get", body: {"type": "hashed-password", "auth-id": $username})
+note over "Credentials Service": lookup credentials
+"Credentials Service" -> "MQTT Adapter"- -: transfer(status: "200", body: credentials)
+
+note over "MQTT Adapter"
+1.) Apply (salted) hash-algorithm to password
+2.) Compare result with the hashed-password from credentials
+end note
+"MQTT Adapter" -> Device- -: CONNACK
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/credentials/preconditions.svg b/docs/1.2/api/credentials/preconditions.svg
new file mode 100644
index 0000000..b06ed88
--- /dev/null
+++ b/docs/1.2/api/credentials/preconditions.svg
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="327.6px" preserveAspectRatio="none" style="width:625px;height:327px;" version="1.1" viewBox="0 0 625 327" width="625.2px" zoomAndPan="magnify"><defs><filter height="300%" id="fxmll93e7nmsu" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#fxmll93e7nmsu)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="521.4" y="83.3156"/><rect fill="#FFFFFF" filter="url(#fxmll93e7nmsu)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="521.4" y="153.2344"/><rect fill="#FFFFFF" filter="url(#fxmll93e7nmsu)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="521.4" y="223.1531"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="43.2" x2="43.2" y1="45.9563" y2="279.7125"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="527.4" x2="527.4" y1="45.9563" y2="279.7125"/><rect fill="#FEFECE" filter="url(#fxmll93e7nmsu)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="27.5941">Client</text><rect fill="#FEFECE" filter="url(#fxmll93e7nmsu)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="278.5125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="302.5066">Client</text><rect fill="#FEFECE" filter="url(#fxmll93e7nmsu)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="175.2" x="437.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="158.4" x="445.8" y="27.5941">Credentials Service</text><rect fill="#FEFECE" filter="url(#fxmll93e7nmsu)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="175.2" x="437.4" y="278.5125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="158.4" x="445.8" y="302.5066">Credentials Service</text><rect fill="#FFFFFF" filter="url(#fxmll93e7nmsu)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="521.4" y="83.3156"/><rect fill="#FFFFFF" filter="url(#fxmll93e7nmsu)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="521.4" y="153.2344"/><rect fill="#FFFFFF" filter="url(#fxmll93e7nmsu)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="521.4" y="223.1531"/><polygon fill="#A80036" points="507,78.5156,519,83.3156,507,88.1156,511.8,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="514.2" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="52.2" y="77.2365">1.1 open</text><polygon fill="#A80036" points="57,113.475,45,118.275,57,123.075,52.2,118.275" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="526.2" y1="118.275" y2="118.275"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="64.2" y="112.1959">1.2 open</text><polygon fill="#A80036" points="507,148.4344,519,153.2344,507,158.0344,511.8,153.2344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="514.2" y1="153.2344" y2="153.2344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="354" x="52.2" y="147.1553">2.1 attach(sender, "credentials/${tenant_id}")</text><polygon fill="#A80036" points="57,183.3937,45,188.1938,57,192.9938,52.2,188.1938" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="526.2" y1="188.1938" y2="188.1938"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="362.4" x="64.2" y="182.1146">2.2 attach(receiver, "credentials/${tenant_id}")</text><polygon fill="#A80036" points="507,218.3531,519,223.1531,507,227.9531,511.8,223.1531" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="514.2" y1="223.1531" y2="223.1531"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="454.8" x="52.2" y="217.074">3.1 attach(receiver, "credentials/${tenant_id}/${reply-to}")</text><polygon fill="#A80036" points="57,253.3125,45,258.1125,57,262.9125,52.2,258.1125" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="526.2" y1="258.1125" y2="258.1125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="446.4" x="64.2" y="252.0334">3.2 attach(sender, "credentials/${tenant_id}/${reply-to}")</text><!--
+@startuml
+scale 1.2
+
+Client -> "Credentials Service"++: 1.1 open
+"Credentials Service" -> Client- -: 1.2 open
+Client -> "Credentials Service"++: 2.1 attach(sender, "credentials/${tenant_id}")
+"Credentials Service" -> Client- -: 2.2 attach(receiver, "credentials/${tenant_id}")
+Client -> "Credentials Service"++: 3.1 attach(receiver, "credentials/${tenant_id}/${reply-to}")
+"Credentials Service" -> Client- -: 3.2 attach(sender, "credentials/${tenant_id}/${reply-to}")
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/device-connection/get_cmd_handling_adapter_instances.svg b/docs/1.2/api/device-connection/get_cmd_handling_adapter_instances.svg
new file mode 100644
index 0000000..28cb767
--- /dev/null
+++ b/docs/1.2/api/device-connection/get_cmd_handling_adapter_instances.svg
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="354px" preserveAspectRatio="none" style="width:726px;height:354px;" version="1.1" viewBox="0 0 726 354" width="726px" zoomAndPan="magnify"><defs><filter height="300%" id="fo2kdhht50914" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#fo2kdhht50914)" height="81.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="495" y="101.475"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="43.2" x2="43.2" y1="45.9563" y2="306.4313"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="500.4" x2="500.4" y1="45.9563" y2="306.4313"/><rect fill="#FEFECE" filter="url(#fo2kdhht50914)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="27.5941">Client</text><rect fill="#FEFECE" filter="url(#fo2kdhht50914)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="305.2313"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="329.2254">Client</text><rect fill="#FEFECE" filter="url(#fo2kdhht50914)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="238.8" x="379.2" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="222" x="387.6" y="27.5941">Device Connection Service</text><rect fill="#FEFECE" filter="url(#fo2kdhht50914)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="238.8" x="379.2" y="305.2313"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="222" x="387.6" y="329.2254">Device Connection Service</text><rect fill="#FFFFFF" filter="url(#fo2kdhht50914)" height="81.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="495" y="101.475"/><polygon fill="#A80036" points="480.6,96.675,492.6,101.475,480.6,106.275,485.4,101.475" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="487.8" y1="101.475" y2="101.475"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="428.4" x="52.2" y="77.2365">transfer(subject: "get-cmd-handling-adapter-instances",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="410.4" x="57" y="95.3959">device_id: "device-1", payload: JSON with gateway ids)</text><path d="M285.6,117.075 L285.6,147.075 L711.6,147.075 L711.6,129.075 L699.6,117.075 L285.6,117.075 " fill="#FBFB77" filter="url(#fo2kdhht50914)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M699.6,117.075 L699.6,129.075 L711.6,129.075 L699.6,117.075 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="400.8" x="292.8" y="137.5553">get command-handling adapter instances for device</text><polygon fill="#A80036" points="57,178.5938,45,183.3937,57,188.1938,52.2,183.3937" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="499.8" y1="183.3937" y2="183.3937"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="330" x="64.2" y="177.3146">transfer(status: "200", body: JSON payload)</text><path d="M49.2,198.9938 L49.2,282.9938 L404.4,282.9938 L404.4,210.9938 L392.4,198.9938 L49.2,198.9938 " fill="#FBFB77" filter="url(#fo2kdhht50914)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M392.4,198.9938 L392.4,210.9938 L404.4,210.9938 L392.4,198.9938 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="330" x="56.4" y="219.474">JSON payload with 'adapter-instances' field;</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="254.4" x="56.4" y="237.6334">Value is array with objects having</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="79.2" x="56.4" y="255.7928">- device-id</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="160.8" x="56.4" y="273.9521">- adapter-instance-id</text><!--MD5=[98a10fd194b0919db0bb609d5e385514]
+@startuml
+scale 1.2
+
+Client -> "Device Connection Service": transfer(subject: "get-cmd-handling-adapter-instances",\n device_id: "device-1", payload: JSON with gateway ids)
+activate "Device Connection Service"
+note over "Device Connection Service"
+get command-handling adapter instances for device
+end note
+"Device Connection Service" -> Client: transfer(status: "200", body: JSON payload)
+deactivate "Device Connection Service"
+note right of Client
+JSON payload with 'adapter-instances' field;
+Value is array with objects having
+- device-id
+- adapter-instance-id
+end note
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.6+10-post-Ubuntu-1ubuntu118.04.1
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/device-connection/get_last_known_gateway_success.svg b/docs/1.2/api/device-connection/get_last_known_gateway_success.svg
new file mode 100644
index 0000000..d54ca6f
--- /dev/null
+++ b/docs/1.2/api/device-connection/get_last_known_gateway_success.svg
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="318px" preserveAspectRatio="none" style="width:626px;height:318px;" version="1.1" viewBox="0 0 626 318" width="626.4px" zoomAndPan="magnify"><defs><filter height="300%" id="fr586u9aoixsx" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#fr586u9aoixsx)" height="81.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="467.4" y="83.3156"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="43.2" x2="43.2" y1="45.9563" y2="270.1125"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="472.8" x2="472.8" y1="45.9563" y2="270.1125"/><rect fill="#FEFECE" filter="url(#fr586u9aoixsx)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="27.5941">Client</text><rect fill="#FEFECE" filter="url(#fr586u9aoixsx)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="268.9125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="292.9066">Client</text><rect fill="#FEFECE" filter="url(#fr586u9aoixsx)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="238.8" x="351.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="222" x="360" y="27.5941">Device Connection Service</text><rect fill="#FEFECE" filter="url(#fr586u9aoixsx)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="238.8" x="351.6" y="268.9125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="222" x="360" y="292.9066">Device Connection Service</text><rect fill="#FFFFFF" filter="url(#fr586u9aoixsx)" height="81.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="467.4" y="83.3156"/><polygon fill="#A80036" points="453,78.5156,465,83.3156,453,88.1156,457.8,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="460.2" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="400.8" x="52.2" y="77.2365">transfer(subject: "get-last-gw", device_id: "device-1")</text><path d="M328.8,98.9156 L328.8,128.9156 L612,128.9156 L612,110.9156 L600,98.9156 L328.8,98.9156 " fill="#FBFB77" filter="url(#fr586u9aoixsx)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M600,98.9156 L600,110.9156 L612,110.9156 L600,98.9156 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="258" x="336" y="119.3959">get last known gateway for device</text><polygon fill="#A80036" points="57,160.4344,45,165.2344,57,170.0344,52.2,165.2344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="472.2" y1="165.2344" y2="165.2344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="330" x="64.2" y="159.1553">transfer(status: "200", body: JSON payload)</text><path d="M49.2,180.8344 L49.2,246.8344 L260.4,246.8344 L260.4,192.8344 L248.4,180.8344 L49.2,180.8344 " fill="#FBFB77" filter="url(#fr586u9aoixsx)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M248.4,180.8344 L248.4,192.8344 L260.4,192.8344 L248.4,180.8344 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="56.4" y="201.3146">JSON payload contains</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="93.6" x="56.4" y="219.474">- gateway-id</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="186" x="56.4" y="237.6334">- last-updated (optional)</text><!--
+@startuml
+scale 1.2
+
+Client -> "Device Connection Service": transfer(subject: "get-last-gw", device_id: "device-1")
+activate "Device Connection Service"
+note over "Device Connection Service"
+get last known gateway for device
+end note
+"Device Connection Service" -> Client: transfer(status: "200", body: JSON payload)
+deactivate "Device Connection Service"
+note right of Client
+JSON payload contains
+- gateway-id
+- last-updated (optional)
+end note
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/device-connection/index.html b/docs/1.2/api/device-connection/index.html
new file mode 100644
index 0000000..f3cce5e
--- /dev/null
+++ b/docs/1.2/api/device-connection/index.html
@@ -0,0 +1,3251 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Device Connection API Specification :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Device Connection API Specification :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Device Connection API Specification :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/api/device-connection//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/api/device-connection/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item active">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/api/device-connection/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/device-connection/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/api/device-connection/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/api/device-connection/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/api/device-connection/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/api/device-connection/index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/api/'>API</a> > Device Connection API Specification
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#preconditions-for-invoking-the-device-connection-api">Preconditions for invoking the Device Connection API</a></li>
+<li><a href="#set-last-known-gateway-for-device">Set last known Gateway for Device</a></li>
+<li><a href="#get-last-known-gateway-for-device">Get last known Gateway for Device</a></li>
+<li><a href="#set-command-handling-protocol-adapter-instance-for-device">Set command-handling protocol adapter instance for device</a></li>
+<li><a href="#remove-command-handling-protocol-adapter-instance-for-device">Remove command-handling protocol adapter instance for device</a></li>
+<li><a href="#get-command-handling-protocol-adapter-instances-for-device">Get command-handling protocol adapter instances for device</a></li>
+<li><a href="#standard-message-properties">Standard Message Properties</a>
+<ul>
+<li><a href="#standard-request-properties">Standard Request Properties</a></li>
+<li><a href="#standard-response-properties">Standard Response Properties</a></li>
+</ul></li>
+<li><a href="#delivery-states">Delivery States</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Device Connection API Specification</h1>
+          
+
+        
+
+
+<p>The <em>Device Connection API</em> is used by <em>Protocol Adapters</em> to set and retrieve information about the connections from devices or gateways to the protocol adapters.</p>
+
+<p>The Device Connection API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using an AMQP 1.0 client in order to invoke operations of the API as described in the following sections.</p>
+
+<p><a name="preconditions"></a></p>
+
+<h2 id="preconditions-for-invoking-the-device-connection-api">Preconditions for invoking the Device Connection API</h2>
+
+<ol>
+<li>Client has established an AMQP connection with the Device Connection service.</li>
+<li>Client has established an AMQP link in role <em>sender</em> on the connection using target address <code>device_con/${tenant_id}</code>. This link is used by the client to send commands concerning device connections to Hono.</li>
+<li>Client has established an AMQP link in role <em>receiver</em> on the connection using source address <code>device_con/${tenant_id}/${reply-to}</code> where <em>reply-to</em> may be any arbitrary string chosen by the client. This link is used by the client to receive responses to the requests it has sent to the Device Connection service. This link&rsquo;s source address is also referred to as the <em>reply-to</em> address for the request messages.</li>
+</ol>
+
+<figure>
+    <img src="preconditions.svg"
+         alt="A client establishes an AMQP connection and the links required to invoke operations of the Device Connection service"/> <figcaption>
+            <h4>Client connecting to Device Connection service</h4>
+        </figcaption>
+</figure>
+
+
+<h2 id="set-last-known-gateway-for-device">Set last known Gateway for Device</h2>
+
+<p>Clients use this command to <em>set</em> the gateway that last acted on behalf of a given device.</p>
+
+<p>As this operation is invoked frequently by Hono&rsquo;s components, implementors may choose to keep this information in memory. This API doesn&rsquo;t mandate checks on the validity of the given device or gateway IDs in order not to introduce a dependency on the <em>Device Registration API</em>. However, implementations of this API may choose to perform such checks or impose a restriction on the overall amount of data that can be stored per tenant in order to protect against malicious requests.</p>
+
+<p><strong>Message Flow</strong></p>
+
+<figure>
+    <img src="set_last_known_gateway_success.svg"
+         alt="A client sends a request message for setting the last known gateway and receives a response containing a confirmation"/> <figcaption>
+            <h4>Client sets the last known gateway for a device</h4>
+        </figcaption>
+</figure>
+
+
+<p><strong>Request Message Format</strong></p>
+
+<p>The following table provides an overview of the properties a client needs to set on a message to set the last known gateway for a device in addition to the <a href="#standard-request-properties">Standard Request Properties</a>.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">AMQP Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>subject</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST be set to <code>set-last-gw</code>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>gateway_id</em></td>
+<td align="center">yes</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The identifier of the gateway that last acted on behalf of the device identified by the <em>device_id</em> property. If a device connects directly instead of through a gateway, the device&rsquo;s identifier MUST be specified here.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The body of the message SHOULD be empty and will be ignored if it is not.</p>
+
+<p><strong>Response Message Format</strong></p>
+
+<p>A response to a <em>set last known gateway for device</em> request contains the <a href="#standard-response-properties">Standard Response Properties</a>.</p>
+
+<p>The response message&rsquo;s <em>status</em> property may contain the following codes:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Code</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>204</em></td>
+<td align="left">OK, the last known gateway for the device has been updated.</td>
+</tr>
+
+<tr>
+<td align="left"><em>400</em></td>
+<td align="left">Bad Request, the last known gateway has not been updated due to invalid or missing data in the request.</td>
+</tr>
+</tbody>
+</table>
+
+<p>Implementors of this API may return a <em>404</em> status code in order to indicate that no device and/or gateway with the given identifier exists for the given tenant. However, performing such a check is optional.</p>
+
+<p>For status codes indicating an error (codes in the <code>400 - 499</code> range) the message body MAY contain a detailed description of the error that occurred.</p>
+
+<h2 id="get-last-known-gateway-for-device">Get last known Gateway for Device</h2>
+
+<p>Clients use this command to <em>retrieve</em> the gateway that last acted on behalf of a given device.</p>
+
+<p><strong>Message Flow</strong></p>
+
+<figure>
+    <img src="get_last_known_gateway_success.svg"
+         alt="A client sends a request message for retrieving the last known gateway and receives a response containing the information"/> <figcaption>
+            <h4>Client retrieving the last known gateway for a device</h4>
+        </figcaption>
+</figure>
+
+
+<p><strong>Request Message Format</strong></p>
+
+<p>The following table provides an overview of the properties a client needs to set on a message to retrieve the last known gateway for a device in addition to the <a href="#standard-request-properties">Standard Request Properties</a>.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">AMQP Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>subject</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST be set to <code>get-last-gw</code>.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The body of the message SHOULD be empty and will be ignored if it is not.</p>
+
+<p><strong>Response Message Format</strong></p>
+
+<p>A response to a <em>get last known gateway for device</em> request contains the <a href="#standard-response-properties">Standard Response Properties</a> as well as the properties shown in the following table:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">AMQP Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>content-type</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST be set to <code>application/json</code> if the invocation of the operation was successful and the body of the response message contains payload as described below.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The result of a successful invocation is carried in a single Data section of the response message as a UTF-8 encoded string representation of a single JSON object. It is an error to include payload that is not of this type.</p>
+
+<p>The response message JSON object has the following properties:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">JSON Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>gateway-id</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The ID of the last known gateway for the device.</td>
+</tr>
+
+<tr>
+<td align="left"><em>last-updated</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The date that the information about the last known gateway for the device was last updated. The value MUST be an <a href="https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations">ISO 8601 compliant <em>combined date and time representation in extended format</em></a>.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The response message&rsquo;s <em>status</em> property may contain the following codes:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Code</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>200</em></td>
+<td align="left">OK, the payload contains the gateway ID.</td>
+</tr>
+
+<tr>
+<td align="left"><em>400</em></td>
+<td align="left">Bad Request, the request message does not contain all required information/properties.</td>
+</tr>
+
+<tr>
+<td align="left"><em>404</em></td>
+<td align="left">Not Found, there is no last known gateway assigned to the device.</td>
+</tr>
+</tbody>
+</table>
+
+<p>Implementors of this API may return a <em>404</em> status code in order to indicate that no device with the given identifier exists for the given tenant. However, performing such a check is optional.</p>
+
+<p>For status codes indicating an error (codes in the <code>400 - 499</code> range) the message body MAY contain a detailed description of the error that occurred.</p>
+
+<h2 id="set-command-handling-protocol-adapter-instance-for-device">Set command-handling protocol adapter instance for device</h2>
+
+<p>Clients use this command to <em>set</em> the protocol adapter instance that currently handles command &amp; control messages for a given device.</p>
+
+<p>This API doesn&rsquo;t mandate checks on the validity of the given device in order not to introduce a dependency on the <em>Device Registration API</em>. However, implementations of this API may choose to perform such checks or impose a restriction on the overall amount of data that can be stored per tenant in order to protect against malicious requests.</p>
+
+<p><strong>Message Flow</strong></p>
+
+<figure>
+    <img src="set_cmd_handling_adapter_instance.svg"
+         alt="A client sends a request message for setting the adapter instance and receives a response containing a confirmation"/> <figcaption>
+            <h4>Client sets the command-handling protocol adapter instance for device</h4>
+        </figcaption>
+</figure>
+
+
+<p><strong>Request Message Format</strong></p>
+
+<p>The following table provides an overview of the properties a client needs to set on a message to set the command-handling protocol adapter instance for a device in addition to the <a href="#standard-request-properties">Standard Request Properties</a>.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">AMQP Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>subject</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST be set to <code>set-cmd-handling-adapter-instance</code>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>adapter_instance_id</em></td>
+<td align="center">yes</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The identifier of the protocol adapter instance that currently handles commands for the device or gateway identified by the <em>device_id</em> property.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The body of the message SHOULD be empty and will be ignored if it is not.</p>
+
+<p><strong>Response Message Format</strong></p>
+
+<p>A response to a <em>set command-handling adapter instance for device</em> request contains the <a href="#standard-response-properties">Standard Response Properties</a>.</p>
+
+<p>The response message&rsquo;s <em>status</em> property may contain the following codes:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Code</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>204</em></td>
+<td align="left">OK, the adapter instance for the device has been updated.</td>
+</tr>
+
+<tr>
+<td align="left"><em>400</em></td>
+<td align="left">Bad Request, the command-handling adapter instance has not been updated due to invalid or missing data in the request.</td>
+</tr>
+</tbody>
+</table>
+
+<p>Implementors of this API may return a <em>404</em> status code in order to indicate that no device with the given identifier exists for the given tenant. However, performing such a check is optional.</p>
+
+<p>For status codes indicating an error (codes in the <code>400 - 499</code> range) the message body MAY contain a detailed description of the error that occurred.</p>
+
+<h2 id="remove-command-handling-protocol-adapter-instance-for-device">Remove command-handling protocol adapter instance for device</h2>
+
+<p>Clients use this command to <em>remove</em> the information, which protocol adapter instance is currently handling command &amp; control messages for the given device. The mapping information is only removed, if the currently associated adapter instance matches the one given in the request.</p>
+
+<p>This API doesn&rsquo;t mandate checks on the validity of the given device in order not to introduce a dependency on the <em>Device Registration API</em>. However, implementations of this API may choose to perform such checks or impose a restriction on the overall amount of data that can be stored per tenant in order to protect against malicious requests.</p>
+
+<p><strong>Message Flow</strong></p>
+
+<figure>
+    <img src="remove_cmd_handling_adapter_instance.svg"
+         alt="A client sends a request message for removing the adapter instance mapping and receives a response containing a confirmation"/> <figcaption>
+            <h4>Client removes the command-handling protocol adapter instance information for device</h4>
+        </figcaption>
+</figure>
+
+
+<p><strong>Request Message Format</strong></p>
+
+<p>The following table provides an overview of the properties a client needs to set on a message to remove the mapping information regarding the command-handling protocol adapter instance for a device in addition to the <a href="#standard-request-properties">Standard Request Properties</a>.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">AMQP Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>subject</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST be set to <code>remove-cmd-handling-adapter-instance</code>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>adapter_instance_id</em></td>
+<td align="center">yes</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The identifier of the protocol adapter instance to remove the mapping information for. Only if this adapter instance is currently associated with the device or gateway identified by the <em>device_id</em> property, the mapping entry will be removed.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The body of the message SHOULD be empty and will be ignored if it is not.</p>
+
+<p><strong>Response Message Format</strong></p>
+
+<p>A response to a <em>remove command-handling adapter instance for device</em> request contains the <a href="#standard-response-properties">Standard Response Properties</a>.</p>
+
+<p>The response message&rsquo;s <em>status</em> property may contain the following codes:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Code</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>204</em></td>
+<td align="left">OK, the adapter instance mapping information for the device has been removed.</td>
+</tr>
+
+<tr>
+<td align="left"><em>400</em></td>
+<td align="left">Bad Request, the request message does not contain all required properties.</td>
+</tr>
+
+<tr>
+<td align="left"><em>404</em></td>
+<td align="left">Not Found, there is no matching command-handling adapter instance assigned to the device.</td>
+</tr>
+</tbody>
+</table>
+
+<p>Implementors of this API may return a <em>404</em> status code in order to indicate that no device with the given identifier exists for the given tenant. However, performing such a check is optional.
+In case the currently mapped adapter instance doesn&rsquo;t match the given adapter instance id, a <em>412</em> status code may also be returned instead of <em>404</em>.</p>
+
+<p>For status codes indicating an error (codes in the <code>400 - 499</code> range) the message body MAY contain a detailed description of the error that occurred.</p>
+
+<h2 id="get-command-handling-protocol-adapter-instances-for-device">Get command-handling protocol adapter instances for device</h2>
+
+<p>Clients use this command to <em>get</em> information about the adapter instances that can handle command &amp; control messages for the given device.</p>
+
+<p>As part of the request message, the client is supposed to provide the list of gateways that may act on behalf of the given device. The client may get this list via the Device Registration API&rsquo;s <a href="/hono/docs/1.2/api/device-registration/#assert-device-registration"><em>assert Device Registration</em></a> operation.</p>
+
+<p>This API doesn&rsquo;t mandate checks on the validity of the given device and the gateway list in order not to introduce a dependency on the <em>Device Registration API</em>.</p>
+
+<p>The command implementation MUST determine the adapter instances by applying the following rules (in the given order):</p>
+
+<ol>
+<li>If an adapter instance is associated with the given device, this adapter instance is returned as the <em>single</em> returned list entry.</li>
+<li>Otherwise, if there is an adapter instance registered for the last known gateway associated with the given device, this adapter instance is returned as the <em>single</em> returned list entry. The last known gateway has to be contained in the given list of gateways for this case.</li>
+<li>Otherwise, <em>all</em> adapter instances associated with any of the given gateway identifiers are returned.</li>
+</ol>
+
+<p>That means that for a device communicating via a gateway, the result is reduced to a <em>single element</em> list if an adapter instance for the device itself or its last known gateway is found. The adapter instance registered for the device itself is given precedence in order to ensure that a gateway having subscribed to commands for that <em>particular device</em> is chosen over a gateway that has subscribed to commands for <em>all</em> devices of a tenant.</p>
+
+<p><strong>Message Flow</strong></p>
+
+<figure>
+    <img src="get_cmd_handling_adapter_instances.svg"
+         alt="A client sends a request message for retrieving the list of command-handling adapter instances for a device and receives a response containing the information"/> <figcaption>
+            <h4>Client retrieving the list of command-handling adapter instances for a device</h4>
+        </figcaption>
+</figure>
+
+
+<p><strong>Request Message Format</strong></p>
+
+<p>The following table provides an overview of the properties a client needs to set on a message to retrieve the command-handling adapter instances for a device in addition to the <a href="#standard-request-properties">Standard Request Properties</a>.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">AMQP Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>content-type</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST be set to <code>application/json</code>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>subject</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST be set to <code>get-cmd-handling-adapter-instances</code>.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The body of the message MUST consist of a single AMQP <em>Data</em> section containing a UTF-8 encoded string representation of a single JSON object. The JSON object has the following properties:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">JSON Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>gateway-ids</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>array</em></td>
+<td align="left">The IDs of the gateways that may act on behalf of the given device. This list may be obtained via the Device Registration API&rsquo;s <a href="/hono/docs/1.2/api/device-registration/#assert-device-registration"><em>assert Device Registration</em></a> operation.</td>
+</tr>
+</tbody>
+</table>
+
+<p>Example of a request payload:</p>
+
+<pre><code class="language-json">{
+  &quot;gateway-ids&quot;: [&quot;gw-1&quot;, &quot;gw-2&quot;, &quot;gw-3&quot;]
+}
+</code></pre>
+
+<p><strong>Response Message Format</strong></p>
+
+<p>A response to a <em>get command-handling adapter instances for device</em> request contains the <a href="#standard-response-properties">Standard Response Properties</a> as well as the properties shown in the following table:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">AMQP Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>content-type</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST be set to <code>application/json</code> if the invocation of the operation was successful and the body of the response message contains payload as described below.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The result of a successful invocation is carried in a single Data section of the response message as a UTF-8 encoded string representation of a single JSON object. It is an error to include payload that is not of this type.</p>
+
+<p>The response message JSON object has the following properties:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">JSON Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>adapter-instances</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>array</em></td>
+<td align="left">A non-empty array of JSON objects that represent the command-handling adapter instances along with the device or gateway id.</td>
+</tr>
+</tbody>
+</table>
+
+<p>Each entry in the <em>adapter-instances</em> array has the following properties:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">JSON Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>adapter-instance-id</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The ID of the protocol adapter instance handling command &amp; control messages for the device given in the <em>device-id</em> property.</td>
+</tr>
+
+<tr>
+<td align="left"><em>device-id</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The ID of the gateway or device that the protocol adapter instance given by the <em>adapter-instance-id</em> is handling command &amp; control messages for. This ID is not necessarily the <em>device_id</em> given in the request message, it may be the ID of one of the gateways acting on behalf of the device.</td>
+</tr>
+</tbody>
+</table>
+
+<p>An example of a response message with a single adapter instance result, returned for example if an adapter instance is registered for the given device:</p>
+
+<pre><code class="language-json">{
+  &quot;adapter-instances&quot;: [
+    {
+      &quot;adapter-instance-id&quot;: &quot;adapter-1&quot;,
+      &quot;device-id&quot;: &quot;4711&quot;
+    }
+  ]
+}
+</code></pre>
+
+<p>An example of a response message with multiple contained adapter instances, returned for example if no adapter instance is registered for the given device or its last used gateway, and therefore a list of all adapter instances for the gateways of the device is returned:</p>
+
+<pre><code class="language-json">{
+  &quot;adapter-instances&quot;: [
+    {
+      &quot;adapter-instance-id&quot;: &quot;adapter-1&quot;,
+      &quot;device-id&quot;: &quot;gw-1&quot;
+    },
+    {
+      &quot;adapter-instance-id&quot;: &quot;adapter-1&quot;,
+      &quot;device-id&quot;: &quot;gw-2&quot;
+    }
+  ]
+}
+</code></pre>
+
+<p>The response message&rsquo;s <em>status</em> property may contain the following codes:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Code</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>200</em></td>
+<td align="left">OK, the payload contains the adapter instances.</td>
+</tr>
+
+<tr>
+<td align="left"><em>400</em></td>
+<td align="left">Bad Request, the request message does not contain all required information/properties.</td>
+</tr>
+
+<tr>
+<td align="left"><em>404</em></td>
+<td align="left">Not Found, there is no command-handling adapter instance assigned to the device.</td>
+</tr>
+</tbody>
+</table>
+
+<p>Implementors of this API may also return a <em>404</em> status code in order to indicate that no device with the given identifier exists for the given tenant. However, performing such a check is optional.</p>
+
+<p>For status codes indicating an error (codes in the <code>400 - 499</code> range) the message body MAY contain a detailed description of the error that occurred.</p>
+
+<h2 id="standard-message-properties">Standard Message Properties</h2>
+
+<p>Due to the nature of the request/response message pattern of the operations of the Device Connection API, there are some standard properties shared by all of the request and response messages exchanged as part of the operations.</p>
+
+<h3 id="standard-request-properties">Standard Request Properties</h3>
+
+<p>The following table provides an overview of the properties shared by all request messages regardless of the particular operation being invoked.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">AMQP Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>subject</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST be set to the value defined by the particular operation being invoked.</td>
+</tr>
+
+<tr>
+<td align="left"><em>correlation-id</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>message-id</em></td>
+<td align="left">MAY contain an ID used to correlate a response message to the original request. If set, it is used as the <em>correlation-id</em> property in the response, otherwise the value of the <em>message-id</em> property is used. Either this or the <em>message-id</em> property MUST be set.</td>
+</tr>
+
+<tr>
+<td align="left"><em>message-id</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MAY contain an identifier that uniquely identifies the message at the sender side. Either this or the <em>correlation-id</em> property MUST be set.</td>
+</tr>
+
+<tr>
+<td align="left"><em>reply-to</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST contain the source address that the client wants to received response messages from. This address MUST be the same as the source address used for establishing the client&rsquo;s receive link (see <a href="#preconditions-for-invoking-the-device-connection-api">Preconditions</a>).</td>
+</tr>
+
+<tr>
+<td align="left"><em>device_id</em></td>
+<td align="center">yes</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST contain the ID of the device that is subject to the operation.</td>
+</tr>
+</tbody>
+</table>
+
+<h3 id="standard-response-properties">Standard Response Properties</h3>
+
+<p>The following table provides an overview of the properties shared by all response messages regardless of the particular operation being invoked.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">AMQP Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>correlation-id</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>message-id</em></td>
+<td align="left">Contains the <em>message-id</em> (or the <em>correlation-id</em>, if specified) of the request message that this message is the response to.</td>
+</tr>
+
+<tr>
+<td align="left"><em>status</em></td>
+<td align="center">yes</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>int</em></td>
+<td align="left">Contains the status code indicating the outcome of the operation. Concrete values and their semantics are defined for each particular operation.</td>
+</tr>
+
+<tr>
+<td align="left"><em>cache_control</em></td>
+<td align="center">no</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">Contains an <a href="https://tools.ietf.org/html/rfc2616#section-14.9">RFC 2616</a> compliant <em>cache directive</em>. The directive contained in the property MUST be obeyed by clients that are caching responses.</td>
+</tr>
+</tbody>
+</table>
+
+<h2 id="delivery-states">Delivery States</h2>
+
+<p>Hono uses the following AMQP message delivery states when receiving request messages from clients:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Delivery State</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>ACCEPTED</em></td>
+<td align="left">Indicates that the request message has been received and accepted for processing.</td>
+</tr>
+
+<tr>
+<td align="left"><em>REJECTED</em></td>
+<td align="left">Indicates that Hono has received the request but was not able to process it. The <em>error</em> field contains information regarding the reason why. Clients should not try to re-send the request using the same message properties in this case.</td>
+</tr>
+</tbody>
+</table>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/api/device-connection/preconditions.svg b/docs/1.2/api/device-connection/preconditions.svg
new file mode 100644
index 0000000..dfb3ce3
--- /dev/null
+++ b/docs/1.2/api/device-connection/preconditions.svg
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="327.6px" preserveAspectRatio="none" style="width:720px;height:327px;" version="1.1" viewBox="0 0 720 327" width="720px" zoomAndPan="magnify"><defs><filter height="300%" id="f22jovr551vga" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f22jovr551vga)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="583.8" y="83.3156"/><rect fill="#FFFFFF" filter="url(#f22jovr551vga)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="583.8" y="153.2344"/><rect fill="#FFFFFF" filter="url(#f22jovr551vga)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="583.8" y="223.1531"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="43.2" x2="43.2" y1="45.9563" y2="279.7125"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="589.2" x2="589.2" y1="45.9563" y2="279.7125"/><rect fill="#FEFECE" filter="url(#f22jovr551vga)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="27.5941">Client</text><rect fill="#FEFECE" filter="url(#f22jovr551vga)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="278.5125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="302.5066">Client</text><rect fill="#FEFECE" filter="url(#f22jovr551vga)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="238.8" x="468" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="222" x="476.4" y="27.5941">Device Connection Service</text><rect fill="#FEFECE" filter="url(#f22jovr551vga)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="238.8" x="468" y="278.5125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="222" x="476.4" y="302.5066">Device Connection Service</text><rect fill="#FFFFFF" filter="url(#f22jovr551vga)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="583.8" y="83.3156"/><rect fill="#FFFFFF" filter="url(#f22jovr551vga)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="583.8" y="153.2344"/><rect fill="#FFFFFF" filter="url(#f22jovr551vga)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="583.8" y="223.1531"/><polygon fill="#A80036" points="569.4,78.5156,581.4,83.3156,569.4,88.1156,574.2,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="576.6" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="52.2" y="77.2365">1.1 open</text><polygon fill="#A80036" points="57,113.475,45,118.275,57,123.075,52.2,118.275" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="588.6" y1="118.275" y2="118.275"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="64.2" y="112.1959">1.2 open</text><polygon fill="#A80036" points="569.4,148.4344,581.4,153.2344,569.4,158.0344,574.2,153.2344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="576.6" y1="153.2344" y2="153.2344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="411.6" x="52.2" y="147.1553">2.1 attach(sender, target: "device_con/${tenant_id}")</text><polygon fill="#A80036" points="57,183.3937,45,188.1938,57,192.9938,52.2,188.1938" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="588.6" y1="188.1938" y2="188.1938"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="424.8" x="64.2" y="182.1146">2.2 attach(receiver, source: "device_con/${tenant_id}")</text><polygon fill="#A80036" points="569.4,218.3531,581.4,223.1531,569.4,227.9531,574.2,223.1531" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="576.6" y1="223.1531" y2="223.1531"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="517.2" x="52.2" y="217.074">3.1 attach(receiver, source: "device_con/${tenant_id}/${reply-to}")</text><polygon fill="#A80036" points="57,253.3125,45,258.1125,57,262.9125,52.2,258.1125" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="588.6" y1="258.1125" y2="258.1125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="504" x="64.2" y="252.0334">3.2 attach(sender, target: "device_con/${tenant_id}/${reply-to}")</text><!--
+@startuml
+scale 1.2
+
+Client -> "Device Connection Service"++: 1.1 open
+"Device Connection Service" -> Client- -: 1.2 open
+Client -> "Device Connection Service"++: 2.1 attach(sender, target: "device_con/${tenant_id}")
+"Device Connection Service" -> Client- -: 2.2 attach(receiver, source: "device_con/${tenant_id}")
+Client -> "Device Connection Service"++: 3.1 attach(receiver, source: "device_con/${tenant_id}/${reply-to}")
+"Device Connection Service" -> Client- -: 3.2 attach(sender, target: "device_con/${tenant_id}/${reply-to}")
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/device-connection/remove_cmd_handling_adapter_instance.svg b/docs/1.2/api/device-connection/remove_cmd_handling_adapter_instance.svg
new file mode 100644
index 0000000..cafb687
--- /dev/null
+++ b/docs/1.2/api/device-connection/remove_cmd_handling_adapter_instance.svg
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="253.2px" preserveAspectRatio="none" style="width:768px;height:253px;" version="1.1" viewBox="0 0 768 253" width="768px" zoomAndPan="magnify"><defs><filter height="300%" id="fpgm810u3x48e" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#fpgm810u3x48e)" height="81.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="525" y="101.475"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="43.2" x2="43.2" y1="45.9563" y2="204.9938"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="530.4" x2="530.4" y1="45.9563" y2="204.9938"/><rect fill="#FEFECE" filter="url(#fpgm810u3x48e)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="27.5941">Client</text><rect fill="#FEFECE" filter="url(#fpgm810u3x48e)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="203.7938"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="227.7879">Client</text><rect fill="#FEFECE" filter="url(#fpgm810u3x48e)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="238.8" x="409.2" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="222" x="417.6" y="27.5941">Device Connection Service</text><rect fill="#FEFECE" filter="url(#fpgm810u3x48e)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="238.8" x="409.2" y="203.7938"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="222" x="417.6" y="227.7879">Device Connection Service</text><rect fill="#FFFFFF" filter="url(#fpgm810u3x48e)" height="81.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="525" y="101.475"/><polygon fill="#A80036" points="510.6,96.675,522.6,101.475,510.6,106.275,515.4,101.475" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="517.8" y1="101.475" y2="101.475"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="453.6" x="52.2" y="77.2365">transfer(subject: "remove-cmd-handling-adapter-instance",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="427.2" x="57" y="95.3959">device_id: "device-1", adapter_instance_id: "adapter_1")</text><path d="M302.4,117.075 L302.4,147.075 L753.6,147.075 L753.6,129.075 L741.6,117.075 L302.4,117.075 " fill="#FBFB77" filter="url(#fpgm810u3x48e)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M741.6,117.075 L741.6,129.075 L753.6,129.075 L741.6,117.075 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="426" x="309.6" y="137.5553">remove command-handling adapter instance for device</text><polygon fill="#A80036" points="57,178.5938,45,183.3937,57,188.1938,52.2,183.3937" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="529.8" y1="183.3937" y2="183.3937"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="170.4" x="64.2" y="177.3146">transfer(status: "204")</text><!--MD5=[2e12a77d4e753bad2277d1c0a2ce9889]
+@startuml
+scale 1.2
+
+Client -> "Device Connection Service": transfer(subject: "remove-cmd-handling-adapter-instance", \n device_id: "device-1", adapter_instance_id: "adapter_1")
+activate "Device Connection Service"
+note over "Device Connection Service"
+remove command-handling adapter instance for device
+end note
+"Device Connection Service" -> Client: transfer(status: "204")
+deactivate "Device Connection Service"
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.6+10-post-Ubuntu-1ubuntu118.04.1
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/device-connection/set_cmd_handling_adapter_instance.svg b/docs/1.2/api/device-connection/set_cmd_handling_adapter_instance.svg
new file mode 100644
index 0000000..c4ddddb
--- /dev/null
+++ b/docs/1.2/api/device-connection/set_cmd_handling_adapter_instance.svg
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="253.2px" preserveAspectRatio="none" style="width:724px;height:253px;" version="1.1" viewBox="0 0 724 253" width="724.8px" zoomAndPan="magnify"><defs><filter height="300%" id="f1gt9jxm420dxu" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f1gt9jxm420dxu)" height="81.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="498.6" y="101.475"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="43.2" x2="43.2" y1="45.9563" y2="204.9938"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="504" x2="504" y1="45.9563" y2="204.9938"/><rect fill="#FEFECE" filter="url(#f1gt9jxm420dxu)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="27.5941">Client</text><rect fill="#FEFECE" filter="url(#f1gt9jxm420dxu)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="203.7938"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="227.7879">Client</text><rect fill="#FEFECE" filter="url(#f1gt9jxm420dxu)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="238.8" x="382.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="222" x="391.2" y="27.5941">Device Connection Service</text><rect fill="#FEFECE" filter="url(#f1gt9jxm420dxu)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="238.8" x="382.8" y="203.7938"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="222" x="391.2" y="227.7879">Device Connection Service</text><rect fill="#FFFFFF" filter="url(#f1gt9jxm420dxu)" height="81.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="498.6" y="101.475"/><polygon fill="#A80036" points="484.2,96.675,496.2,101.475,484.2,106.275,489,101.475" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="491.4" y1="101.475" y2="101.475"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="418.8" x="52.2" y="77.2365">transfer(subject: "set-cmd-handling-adapter-instance",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="427.2" x="57" y="95.3959">device_id: "device-1", adapter_instance_id: "adapter_1")</text><path d="M294,117.075 L294,147.075 L710.4,147.075 L710.4,129.075 L698.4,117.075 L294,117.075 " fill="#FBFB77" filter="url(#f1gt9jxm420dxu)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M698.4,117.075 L698.4,129.075 L710.4,129.075 L698.4,117.075 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="391.2" x="301.2" y="137.5553">set command-handling adapter instance for device</text><polygon fill="#A80036" points="57,178.5938,45,183.3937,57,188.1938,52.2,183.3937" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="503.4" y1="183.3937" y2="183.3937"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="170.4" x="64.2" y="177.3146">transfer(status: "204")</text><!--MD5=[1835b2c35a6af2f993db2cd294daab3a]
+@startuml
+scale 1.2
+
+Client -> "Device Connection Service": transfer(subject: "set-cmd-handling-adapter-instance", \n device_id: "device-1", adapter_instance_id: "adapter_1")
+activate "Device Connection Service"
+note over "Device Connection Service"
+set command-handling adapter instance for device
+end note
+"Device Connection Service" -> Client: transfer(status: "204")
+deactivate "Device Connection Service"
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.6+10-post-Ubuntu-1ubuntu118.04.1
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/device-connection/set_last_known_gateway_success.svg b/docs/1.2/api/device-connection/set_last_known_gateway_success.svg
new file mode 100644
index 0000000..a9f6855
--- /dev/null
+++ b/docs/1.2/api/device-connection/set_last_known_gateway_success.svg
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="234px" preserveAspectRatio="none" style="width:771px;height:234px;" version="1.1" viewBox="0 0 771 234" width="771.6px" zoomAndPan="magnify"><defs><filter height="300%" id="fqm2tm43gwn4n" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#fqm2tm43gwn4n)" height="81.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="612.6" y="83.3156"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="43.2" x2="43.2" y1="45.9563" y2="186.8344"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="618" x2="618" y1="45.9563" y2="186.8344"/><rect fill="#FEFECE" filter="url(#fqm2tm43gwn4n)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="27.5941">Client</text><rect fill="#FEFECE" filter="url(#fqm2tm43gwn4n)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="185.6344"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="209.6285">Client</text><rect fill="#FEFECE" filter="url(#fqm2tm43gwn4n)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="238.8" x="496.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="222" x="505.2" y="27.5941">Device Connection Service</text><rect fill="#FEFECE" filter="url(#fqm2tm43gwn4n)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="238.8" x="496.8" y="185.6344"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="222" x="505.2" y="209.6285">Device Connection Service</text><rect fill="#FFFFFF" filter="url(#fqm2tm43gwn4n)" height="81.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="612.6" y="83.3156"/><polygon fill="#A80036" points="598.2,78.5156,610.2,83.3156,598.2,88.1156,603,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="605.4" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="546" x="52.2" y="77.2365">transfer(subject: "set-last-gw", device_id: "device-1", gateway_id: "gw-1)</text><path d="M475.2,98.9156 L475.2,128.9156 L757.2,128.9156 L757.2,110.9156 L745.2,98.9156 L475.2,98.9156 " fill="#FBFB77" filter="url(#fqm2tm43gwn4n)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M745.2,98.9156 L745.2,110.9156 L757.2,110.9156 L745.2,98.9156 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="256.8" x="482.4" y="119.3959">set last known gateway for device</text><polygon fill="#A80036" points="57,160.4344,45,165.2344,57,170.0344,52.2,165.2344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="617.4" y1="165.2344" y2="165.2344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="170.4" x="64.2" y="159.1553">transfer(status: "204")</text><!--
+@startuml
+scale 1.2
+
+Client -> "Device Connection Service": transfer(subject: "set-last-gw", device_id: "device-1", gateway_id: "gw-1)
+activate "Device Connection Service"
+note over "Device Connection Service"
+set last known gateway for device
+end note
+"Device Connection Service" -> Client: transfer(status: "204")
+deactivate "Device Connection Service"
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/device-registration/assert_success.svg b/docs/1.2/api/device-registration/assert_success.svg
new file mode 100644
index 0000000..09c3b3c
--- /dev/null
+++ b/docs/1.2/api/device-registration/assert_success.svg
@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="390px" preserveAspectRatio="none" style="width:847px;height:390px;" version="1.1" viewBox="0 0 847 390" width="847.2px" zoomAndPan="magnify"><defs><filter height="300%" id="f5fhc5i4jav5v" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f5fhc5i4jav5v)" height="136.3969" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="688.2" y="83.3156"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="43.2" x2="43.2" y1="45.9563" y2="342.75"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="694.2" x2="694.2" y1="45.9563" y2="342.75"/><rect fill="#FEFECE" filter="url(#f5fhc5i4jav5v)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="27.5941">Client</text><rect fill="#FEFECE" filter="url(#f5fhc5i4jav5v)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="341.55"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="365.5441">Client</text><rect fill="#FEFECE" filter="url(#f5fhc5i4jav5v)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="242.4" x="570.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="579" y="27.5941">Device Registration Service</text><rect fill="#FEFECE" filter="url(#f5fhc5i4jav5v)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="242.4" x="570.6" y="341.55"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="579" y="365.5441">Device Registration Service</text><rect fill="#FFFFFF" filter="url(#f5fhc5i4jav5v)" height="136.3969" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="688.2" y="83.3156"/><polygon fill="#A80036" points="673.8,78.5156,685.8,83.3156,673.8,88.1156,678.6,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="681" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="367.2" x="52.2" y="77.2365">transfer(subject: "assert", device-id, gateway-id)</text><path d="M549.6,98.9156 L549.6,182.9156 L832.8,182.9156 L832.8,110.9156 L820.8,98.9156 L549.6,98.9156 " fill="#FBFB77" filter="url(#f5fhc5i4jav5v)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M820.8,98.9156 L820.8,110.9156 L832.8,110.9156 L820.8,98.9156 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="76.8" x="556.8" y="119.3959">verify that</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="202.8" x="556.8" y="137.5553">- device and gateway exist</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="258" x="556.8" y="155.7146">- device and gateway are enabled</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="256.8" x="556.8" y="173.874">- gateway is authorized for device</text><polygon fill="#A80036" points="57,214.9125,45,219.7125,57,224.5125,52.2,219.7125" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="693" y1="219.7125" y2="219.7125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="615.6" x="64.2" y="213.6334">transfer(status: "200", content-type: "application/json", body: registration status)</text><path d="M49.2,235.3125 L49.2,319.3125 L247.2,319.3125 L247.2,247.3125 L235.2,235.3125 L49.2,235.3125 " fill="#FBFB77" filter="url(#f5fhc5i4jav5v)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M235.2,235.3125 L235.2,247.3125 L247.2,247.3125 L235.2,235.3125 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="56.4" y="255.7928">JSON payload contains</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="79.2" x="56.4" y="273.9521">- device-id</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="110.4" x="56.4" y="292.1115">- via (optional)</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="150" x="56.4" y="310.2709">- defaults (optional)</text><!--
+@startuml
+scale 1.2
+
+Client -> "Device Registration Service": transfer(subject: "assert", device-id, gateway-id)
+activate "Device Registration Service"
+note over "Device Registration Service"
+verify that
+- device and gateway exist
+- device and gateway are enabled
+- gateway is authorized for device
+end note
+
+"Device Registration Service" -> Client: transfer(status: "200", content-type: "application/json", body: registration status)
+deactivate "Device Registration Service"
+
+note right of Client
+JSON payload contains
+- device-id
+- via (optional)
+- defaults (optional)
+end note
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/device-registration/index.html b/docs/1.2/api/device-registration/index.html
new file mode 100644
index 0000000..35728f1
--- /dev/null
+++ b/docs/1.2/api/device-registration/index.html
@@ -0,0 +1,2738 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Device Registration API Specification :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Device Registration API Specification :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Device Registration API Specification :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/api/device-registration//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/api/device-registration/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item active">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/api/device-registration/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/device-registration/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/api/device-registration/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/api/device-registration/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/api/device-registration/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/api/device-registration/index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/api/'>API</a> > Device Registration API Specification
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#preconditions-for-invoking-the-device-registration-api">Preconditions for invoking the Device Registration API</a></li>
+<li><a href="#assert-device-registration">Assert Device Registration</a></li>
+<li><a href="#delivery-states">Delivery States</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Device Registration API Specification</h1>
+          
+
+        
+
+
+<p>The <em>Device Registration API</em> is used by Hono&rsquo;s protocol adapters to get information about devices connecting to the adapters.</p>
+
+<p>The Device Registration API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using an AMQP 1.0 client in order to invoke operations of the API as described in the following sections.</p>
+
+<p><a name="preconditions"></a></p>
+
+<h2 id="preconditions-for-invoking-the-device-registration-api">Preconditions for invoking the Device Registration API</h2>
+
+<ol>
+<li>Client has established an AMQP connection with the Device Registration service.</li>
+<li>Client has established an AMQP link in role <em>sender</em> on the connection using target address <code>registration/${tenant_id}</code>. This link is used by the client to send request messages to the Device Registration service.</li>
+<li>Client has established an AMQP link in role <em>receiver</em> on the connection using source address <code>registration/${tenant_id}/${reply-to}</code> where <em>reply-to</em> may be any arbitrary string chosen by the client. This link is used by the client to receive responses to the requests it has sent to the Device Registration service. This link&rsquo;s source address is also referred to as the <em>reply-to</em> address for the request messages.</li>
+</ol>
+
+<figure>
+    <img src="preconditions.svg"
+         alt="A client establishes an AMQP connection and the links required to invoke operations of the Device Registration service"/> <figcaption>
+            <h4>Client connecting to Device Registration service</h4>
+        </figcaption>
+</figure>
+
+
+<h2 id="assert-device-registration">Assert Device Registration</h2>
+
+<p>Clients use this command to verify that a device is registered for a particular tenant and is enabled.</p>
+
+<p><strong>Message Flow</strong></p>
+
+<p>The following sequence diagram illustrates the flow of messages involved in a <em>Client</em> asserting a device&rsquo;s registration status.</p>
+
+<figure>
+    <img src="assert_success.svg"
+         alt="A client sends a request message for asserting a device&#39;s registration status and receives a response containing the registration status"/> <figcaption>
+            <h4>Client asserting a device&#39;s registration status</h4>
+        </figcaption>
+</figure>
+
+
+<p><strong>Request Message Format</strong></p>
+
+<p>The following table provides an overview of the properties a client needs to set on a message to assert a device&rsquo;s registration status:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">AMQP Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>correlation-id</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>message-id</em></td>
+<td align="left">MAY contain an ID used to correlate a response message to the original request. If set, it is used as the <em>correlation-id</em> property in the response, otherwise the value of the <em>message-id</em> property is used. Either this or the <em>message-id</em> property MUST be set.</td>
+</tr>
+
+<tr>
+<td align="left"><em>device_id</em></td>
+<td align="center">yes</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST contain the ID of the device that is subject to the operation.</td>
+</tr>
+
+<tr>
+<td align="left"><em>gateway_id</em></td>
+<td align="center">no</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The identifier of the gateway that wants to get an assertion <em>on behalf</em> of another device (given in the <em>device_id</em> property).<br>An implementation SHOULD verify that the gateway exists, is enabled and is authorized to get an assertion for, and thus send data on behalf of, the device.</td>
+</tr>
+
+<tr>
+<td align="left"><em>message-id</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MAY contain an identifier that uniquely identifies the message at the sender side. Either this or the <em>correlation-id</em> property MUST be set.</td>
+</tr>
+
+<tr>
+<td align="left"><em>reply-to</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST contain the source address that the client wants to received response messages from. This address MUST be the same as the source address used for establishing the client&rsquo;s receive link (see <a href="#preconditions-for-invoking-the-device-registration-api">Preconditions</a>).</td>
+</tr>
+
+<tr>
+<td align="left"><em>subject</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST be set to <code>assert</code>.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The body of the message SHOULD be empty and will be ignored if it is not.</p>
+
+<p><strong>Response Message Format</strong></p>
+
+<p>The following table provides an overview of the properties contained in a response message to an <em>assert</em> request:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">AMQP Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>correlation-id</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>message-id</em></td>
+<td align="left">Contains the <em>message-id</em> (or the <em>correlation-id</em>, if specified) of the request message that this message is the response to.</td>
+</tr>
+
+<tr>
+<td align="left"><em>content-type</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST be set to <code>application/json</code> if the invocation of the operation was successful and the body of the response message contains payload as described below.</td>
+</tr>
+
+<tr>
+<td align="left"><em>status</em></td>
+<td align="center">yes</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>int</em></td>
+<td align="left">Contains the status code indicating the outcome of the operation. Concrete values and their semantics are defined below.</td>
+</tr>
+
+<tr>
+<td align="left"><em>cache_control</em></td>
+<td align="center">no</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">Contains an <a href="https://tools.ietf.org/html/rfc2616#section-14.9">RFC 2616</a> compliant <em>cache directive</em>. The directive contained in the property MUST be obeyed by clients that are caching responses.</td>
+</tr>
+</tbody>
+</table>
+
+<p>In case of a successful invocation of the operation, the body of the response message consists of a single <em>Data</em> section containing a UTF-8 encoded string representation of a single JSON object having the following properties:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">JSON Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>device-id</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The ID of the device that is subject of the assertion.</td>
+</tr>
+
+<tr>
+<td align="left"><em>via</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>array</em></td>
+<td align="left">The IDs (JSON strings) of gateways which may act on behalf of the device. This property MUST be set if any gateways are registered for the device. If the assertion request contained a <em>gateway_id</em> property and the response&rsquo;s <em>status</em> property has value <code>200</code> (indicating a successful assertion) then the array MUST at least contain the gateway ID from the request.</td>
+</tr>
+
+<tr>
+<td align="left"><em>defaults</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>object</em></td>
+<td align="left">Default values to be used by protocol adapters for augmenting messages from devices with missing information like a <em>content type</em>. It is up to the discretion of a protocol adapter if and how to use the given default values when processing messages published by the device.</td>
+</tr>
+</tbody>
+</table>
+
+<p>Below is an example for a payload of a response to an <em>assert</em> request for device <code>4711</code> which also includes a default <em>content-type</em>:</p>
+
+<pre><code class="language-json">{
+  &quot;device-id&quot;: &quot;4711&quot;,
+  &quot;via&quot;: [&quot;4712&quot;],
+  &quot;defaults&quot;: {
+    &quot;content-type&quot;: &quot;application/vnd.acme+json&quot;
+  }
+}
+</code></pre>
+
+<p>The response message&rsquo;s <em>status</em> property may contain the following codes:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Code</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>200</em></td>
+<td align="left">OK, the device is registered for the given tenant and is enabled. The response message body contains the asserted device&rsquo;s registration status.</td>
+</tr>
+
+<tr>
+<td align="left"><em>400</em></td>
+<td align="left">Bad Request, the request message did not contain all mandatory properties.</td>
+</tr>
+
+<tr>
+<td align="left"><em>403</em></td>
+<td align="left">Forbidden, the gateway with the given <em>gateway id</em> either does not exist, is not enabled or is not authorized to get an assertion for the device with the given <em>device id</em>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>404</em></td>
+<td align="left">Not Found, there is no device registered with the given <em>device id</em> within the given <em>tenant id</em> or the device is not enabled.</td>
+</tr>
+</tbody>
+</table>
+
+<p>For status codes indicating an error (codes in the <code>400 - 499</code> range) the message body MAY contain a detailed description of the error that occurred. In this case, the response message&rsquo;s <em>content-type</em> property SHOULD be set accordingly.</p>
+
+<h2 id="delivery-states">Delivery States</h2>
+
+<p>The Device Registration service uses the following AMQP message delivery states when receiving request messages from clients:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Delivery State</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>ACCEPTED</em></td>
+<td align="left">Indicates that the request message has been received and accepted for processing.</td>
+</tr>
+
+<tr>
+<td align="left"><em>REJECTED</em></td>
+<td align="left">Indicates that the request message has been received but cannot be processed. The disposition frame&rsquo;s <em>error</em> field contains information regarding the reason why. Clients should not try to re-send the request using the same message properties in this case.</td>
+</tr>
+</tbody>
+</table>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/api/device-registration/preconditions.svg b/docs/1.2/api/device-registration/preconditions.svg
new file mode 100644
index 0000000..f5858c6
--- /dev/null
+++ b/docs/1.2/api/device-registration/preconditions.svg
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="327.6px" preserveAspectRatio="none" style="width:662px;height:327px;" version="1.1" viewBox="0 0 662 327" width="662.4px" zoomAndPan="magnify"><defs><filter height="300%" id="f1haa4yxqnzi8u" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f1haa4yxqnzi8u)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="525" y="83.3156"/><rect fill="#FFFFFF" filter="url(#f1haa4yxqnzi8u)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="525" y="153.2344"/><rect fill="#FFFFFF" filter="url(#f1haa4yxqnzi8u)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="525" y="223.1531"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="43.2" x2="43.2" y1="45.9563" y2="279.7125"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="531" x2="531" y1="45.9563" y2="279.7125"/><rect fill="#FEFECE" filter="url(#f1haa4yxqnzi8u)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="27.5941">Client</text><rect fill="#FEFECE" filter="url(#f1haa4yxqnzi8u)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="278.5125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="302.5066">Client</text><rect fill="#FEFECE" filter="url(#f1haa4yxqnzi8u)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="242.4" x="407.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="415.8" y="27.5941">Device Registration Service</text><rect fill="#FEFECE" filter="url(#f1haa4yxqnzi8u)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="242.4" x="407.4" y="278.5125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="415.8" y="302.5066">Device Registration Service</text><rect fill="#FFFFFF" filter="url(#f1haa4yxqnzi8u)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="525" y="83.3156"/><rect fill="#FFFFFF" filter="url(#f1haa4yxqnzi8u)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="525" y="153.2344"/><rect fill="#FFFFFF" filter="url(#f1haa4yxqnzi8u)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="525" y="223.1531"/><polygon fill="#A80036" points="510.6,78.5156,522.6,83.3156,510.6,88.1156,515.4,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="517.8" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="52.2" y="77.2365">1.1 open</text><polygon fill="#A80036" points="57,113.475,45,118.275,57,123.075,52.2,118.275" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="529.8" y1="118.275" y2="118.275"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="64.2" y="112.1959">1.2 open</text><polygon fill="#A80036" points="510.6,148.4344,522.6,153.2344,510.6,158.0344,515.4,153.2344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="517.8" y1="153.2344" y2="153.2344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="357.6" x="52.2" y="147.1553">2.1 attach(sender, "registration/${tenant_id}")</text><polygon fill="#A80036" points="57,183.3937,45,188.1938,57,192.9938,52.2,188.1938" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="529.8" y1="188.1938" y2="188.1938"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="366" x="64.2" y="182.1146">2.2 attach(receiver, "registration/${tenant_id}")</text><polygon fill="#A80036" points="510.6,218.3531,522.6,223.1531,510.6,227.9531,515.4,223.1531" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="517.8" y1="223.1531" y2="223.1531"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="458.4" x="52.2" y="217.074">3.1 attach(receiver, "registration/${tenant_id}/${reply-to}")</text><polygon fill="#A80036" points="57,253.3125,45,258.1125,57,262.9125,52.2,258.1125" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="529.8" y1="258.1125" y2="258.1125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="450" x="64.2" y="252.0334">3.2 attach(sender, "registration/${tenant_id}/${reply-to}")</text><!--
+@startuml
+scale 1.2
+
+Client -> "Device Registration Service"++: 1.1 open
+"Device Registration Service" -> Client- -: 1.2 open
+Client -> "Device Registration Service"++: 2.1 attach(sender, "registration/${tenant_id}")
+"Device Registration Service" -> Client- -: 2.2 attach(receiver, "registration/${tenant_id}")
+Client -> "Device Registration Service"++: 3.1 attach(receiver, "registration/${tenant_id}/${reply-to}")
+"Device Registration Service" -> Client- -: 3.2 attach(sender, "registration/${tenant_id}/${reply-to}")
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/event/consume.svg b/docs/1.2/api/event/consume.svg
new file mode 100644
index 0000000..541f10d
--- /dev/null
+++ b/docs/1.2/api/event/consume.svg
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="187.2px" preserveAspectRatio="none" style="width:589px;height:187px;" version="1.1" viewBox="0 0 589 187" width="589.2px" zoomAndPan="magnify"><defs><filter height="300%" id="f1j88j41ohd0n4" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f1j88j41ohd0n4)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="478.2" y="83.3156"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="144" x2="144" y1="45.9563" y2="139.875"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="483.6" x2="483.6" y1="45.9563" y2="139.875"/><rect fill="#FEFECE" filter="url(#f1j88j41ohd0n4)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="265.2" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="248.4" x="18" y="27.5941">AMQP 1.0 Messaging Network</text><rect fill="#FEFECE" filter="url(#f1j88j41ohd0n4)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="265.2" x="9.6" y="138.675"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="248.4" x="18" y="162.6691">AMQP 1.0 Messaging Network</text><rect fill="#FEFECE" filter="url(#f1j88j41ohd0n4)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="188.4" x="387.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="171.6" x="396" y="27.5941">Business Application</text><rect fill="#FEFECE" filter="url(#f1j88j41ohd0n4)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="188.4" x="387.6" y="138.675"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="171.6" x="396" y="162.6691">Business Application</text><rect fill="#FFFFFF" filter="url(#f1j88j41ohd0n4)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="478.2" y="83.3156"/><polygon fill="#A80036" points="463.8,78.5156,475.8,83.3156,463.8,88.1156,468.6,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="144.6" x2="471" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="153" y="77.2365">1.0 transfer(device_id: 4711, body: data)</text><polygon fill="#A80036" points="157.8,113.475,145.8,118.275,157.8,123.075,153,118.275" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="150.6" x2="483" y1="118.275" y2="118.275"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="254.4" x="165" y="112.1959">1.1 disposition(state: "accepted")</text><!--
+@startuml
+scale 1.2
+
+participant "AMQP 1.0 Messaging Network"
+participant "Business Application"
+
+"AMQP 1.0 Messaging Network" -> "Business Application"+: 1.0 transfer(device_id: 4711, body: data)
+"Business Application" -> "AMQP 1.0 Messaging Network"-: 1.1 disposition(state: "accepted")
+@enduml
+
+PlantUML version 1.2019.07(Mon Jun 24 19:59:20 UTC 2019)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/event/forward.svg b/docs/1.2/api/event/forward.svg
new file mode 100644
index 0000000..30a2076
--- /dev/null
+++ b/docs/1.2/api/event/forward.svg
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="258px" preserveAspectRatio="none" style="width:921px;height:258px;" version="1.1" viewBox="0 0 921 258" width="921.6px" zoomAndPan="magnify"><defs><filter height="300%" id="f92uui3yoh7h1" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f92uui3yoh7h1)" height="115.6781" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="414.6" y="83.3156"/><rect fill="#FFFFFF" filter="url(#f92uui3yoh7h1)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="772.2" y="118.275"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="48" x2="48" y1="45.9563" y2="209.7938"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="420" x2="420" y1="45.9563" y2="209.7938"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="777.6" x2="777.6" y1="45.9563" y2="209.7938"/><rect fill="#FEFECE" filter="url(#f92uui3yoh7h1)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="18" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#f92uui3yoh7h1)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="9.6" y="208.5938"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="18" y="232.5879">Device</text><rect fill="#FEFECE" filter="url(#f92uui3yoh7h1)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="135.6" x="350.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="358.8" y="27.5941">MQTT Adapter</text><rect fill="#FEFECE" filter="url(#f92uui3yoh7h1)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="135.6" x="350.4" y="208.5938"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="358.8" y="232.5879">MQTT Adapter</text><rect fill="#FEFECE" filter="url(#f92uui3yoh7h1)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="265.2" x="643.2" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="248.4" x="651.6" y="27.5941">AMQP 1.0 Messaging Network</text><rect fill="#FEFECE" filter="url(#f92uui3yoh7h1)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="265.2" x="643.2" y="208.5938"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="248.4" x="651.6" y="232.5879">AMQP 1.0 Messaging Network</text><rect fill="#FFFFFF" filter="url(#f92uui3yoh7h1)" height="115.6781" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="414.6" y="83.3156"/><rect fill="#FFFFFF" filter="url(#f92uui3yoh7h1)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="772.2" y="118.275"/><polygon fill="#A80036" points="400.2,78.5156,412.2,83.3156,400.2,88.1156,405,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="48.6" x2="407.4" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="343.2" x="57" y="77.2365">1.0 PUBLISH("e/TENANT/4711", qos=1, data)</text><polygon fill="#A80036" points="757.8,113.475,769.8,118.275,757.8,123.075,762.6,118.275" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="426.6" x2="765" y1="118.275" y2="118.275"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="322.8" x="435" y="112.1959">1.1 transfer(device_id: "4711", body: data)</text><polygon fill="#A80036" points="439.8,148.4344,427.8,153.2344,439.8,158.0344,435,153.2344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="432.6" x2="777" y1="153.2344" y2="153.2344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="254.4" x="447" y="147.1553">1.2 disposition(state: "accepted")</text><polygon fill="#A80036" points="61.8,183.3937,49.8,188.1938,61.8,192.9938,57,188.1938" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="54.6" x2="413.4" y1="188.1938" y2="188.1938"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="92.4" x="69" y="182.1146">1.3 PUBACK</text><!--
+@startuml
+scale 1.2
+
+participant Device
+participant "MQTT Adapter"
+participant "AMQP 1.0 Messaging Network"
+
+Device -> "MQTT Adapter"++: 1.0 PUBLISH("e/TENANT/4711", qos=1, data)
+"MQTT Adapter" -> "AMQP 1.0 Messaging Network"+: 1.1 transfer(device_id: "4711", body: data)
+"AMQP 1.0 Messaging Network" -> "MQTT Adapter"-: 1.2 disposition(state: "accepted")
+"MQTT Adapter" -> Device: 1.3 PUBACK
+@enduml
+
+PlantUML version 1.2019.07(Mon Jun 24 19:59:20 UTC 2019)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/event/index.html b/docs/1.2/api/event/index.html
new file mode 100644
index 0000000..035bdd4
--- /dev/null
+++ b/docs/1.2/api/event/index.html
@@ -0,0 +1,2713 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Event API Specification :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Event API Specification :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Event API Specification :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/api/event//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/api/event/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item active">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/api/event/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/event/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/api/event/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/api/event/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/api/event/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/api/event/index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/api/'>API</a> > Event API Specification
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#southbound-operations">Southbound Operations</a>
+<ul>
+<li><a href="#forward-event">Forward Event</a></li>
+</ul></li>
+<li><a href="#northbound-operations">Northbound Operations</a>
+<ul>
+<li><a href="#receive-events">Receive Events</a></li>
+</ul></li>
+<li><a href="#well-known-event-message-types">Well-known Event Message Types</a>
+<ul>
+<li><a href="#empty-notification">Empty Notification</a></li>
+<li><a href="#connection-event">Connection Event</a></li>
+</ul></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Event API Specification</h1>
+          
+
+        
+
+
+<p>The <em>Event</em> API is used by <em>Protocol Adapters</em> to send event messages downstream.
+<em>Business Applications</em> and other consumers use the API to receive messages published by devices belonging to a particular tenant.</p>
+
+<p>The Event API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using AMQP 1.0 in order to invoke operations of the API as described in the following sections. Throughout the remainder of this page we will simply use <em>AMQP</em> when referring to AMQP 1.0.</p>
+
+<h2 id="southbound-operations">Southbound Operations</h2>
+
+<p>The following operations can be used by <em>Protocol Adapters</em> to forward event messages received from devices to downstream consumers like <em>Business Applications</em>.</p>
+
+<h3 id="forward-event">Forward Event</h3>
+
+<p><strong>Preconditions</strong></p>
+
+<ol>
+<li>Adapter has established an AMQP connection with the AMQP Messaging Network.</li>
+<li>Adapter has established an AMQP link in role <em>sender</em> with the AMQP Messaging Network using target address <code>event/${tenant_id}</code> where <code>${tenant_id}</code> is the ID of the tenant that the client wants to upload event messages for.</li>
+<li>The device for which the adapter wants to send an event has been registered (see <a href="/hono/docs/1.2/api/device-registration/">Device Registration API</a>).</li>
+</ol>
+
+<p>Hono supports <em>AT LEAST ONCE</em> delivery of <em>Event</em> messages only. A client therefore MUST use <code>unsettled</code> for the <em>snd-settle-mode</em> and <code>first</code> for the <em>rcv-settle-mode</em> fields of its <em>attach</em> frame during link establishment. All other combinations are not supported by Hono and may result in the termination of the link or connection (depending on the configuration of the AMQP Messaging Network).</p>
+
+<p>The AMQP messages used to forward events to the AMQP Messaging Network MUST have their <em>durable</em> property set to <code>true</code>. The AMQP Messaging Network is expected to write such messages to a persistent store before settling the transfer with the <code>accepted</code> outcome.</p>
+
+<p><strong>Message Flow</strong></p>
+
+<p>The following sequence diagram illustrates the flow of messages involved in the <em>MQTT Adapter</em> forwarding an event to the downstream AMQP Messaging Network.</p>
+
+<figure>
+    <img src="forward.svg"/> <figcaption>
+            <h4>Forward event flow</h4>
+        </figcaption>
+</figure>
+
+
+<ol>
+<li><em>Device</em> <code>4711</code> publishes an event using MQTT QoS 1.
+
+<ol>
+<li><em>MQTT Adapter</em> transfers data to <em>AMQP 1.0 Messaging Network</em>.</li>
+<li><em>AMQP 1.0 Messaging Network</em> acknowledges reception of the message.</li>
+<li><em>MQTT Adapter</em> acknowledges the reception of the message to the <em>Device</em>.</li>
+</ol></li>
+</ol>
+
+<p>When the AMQP Messaging Network fails to settle the transfer of an event message or settles the transfer with any other outcome than <code>accepted</code>, the protocol adapter MUST NOT try to re-send such rejected messages but MUST indicate the failed transfer to the device if the transport protocol provides means to do so.</p>
+
+<p><strong>Message Format</strong></p>
+
+<p>See <a href="/hono/docs/1.2/api/telemetry/#forward-telemetry-data">Telemetry API</a> for definition of message format.</p>
+
+<h2 id="northbound-operations">Northbound Operations</h2>
+
+<h3 id="receive-events">Receive Events</h3>
+
+<p>Hono delivers messages containing events reported by a particular device in the same order that they have been received in (using the <a href="#forward-event">Forward Event</a> operation).</p>
+
+<p>Hono supports multiple non-competing <em>Business Application</em> consumers of event messages for a given tenant. Hono allows each <em>Business Application</em> to have multiple competing consumers for event messages for a given tenant to share the load of processing the messages.</p>
+
+<p><strong>Preconditions</strong></p>
+
+<ol>
+<li>Client has established an AMQP connection with Hono.</li>
+<li>Client has established an AMQP link in role <em>receiver</em> with Hono using source address <code>event/${tenant_id}</code> where <code>${tenant_id}</code> represents the ID of the tenant the client wants to retrieve event messages for.</li>
+</ol>
+
+<p>Hono supports <em>AT LEAST ONCE</em> delivery of <em>Event</em> messages only. A client therefore MUST use <code>unsettled</code> for the <em>snd-settle-mode</em> and <code>first</code> for the <em>rcv-settle-mode</em> fields of its <em>attach</em> frame during link establishment. All other combinations are not supported by Hono and result in the termination of the link.</p>
+
+<p><strong>Message Flow</strong></p>
+
+<p>The following sequence diagram illustrates the flow of messages involved in a <em>Business Application</em> receiving an event message from Hono.</p>
+
+<figure>
+    <img src="consume.svg"/> <figcaption>
+            <h4>Receive event data flow (success)</h4>
+        </figcaption>
+</figure>
+
+
+<ol>
+<li><em>AMQP 1.0 Messaging Network</em> delivers event message to <em>Business Application</em>.
+
+<ol>
+<li><em>Business Application</em> acknowledges reception of message.</li>
+</ol></li>
+</ol>
+
+<p><strong>Message Format</strong></p>
+
+<p>See <a href="/hono/docs/1.2/api/telemetry/#forward-telemetry-data">Telemetry API</a> for definition of message format.</p>
+
+<h2 id="well-known-event-message-types">Well-known Event Message Types</h2>
+
+<p>Hono defines several <em>well-known</em> event types which have specific semantics. Events of these types are identified by means of the AMQP message&rsquo;s <em>content-type</em>.</p>
+
+<h3 id="empty-notification">Empty Notification</h3>
+
+<p>An AMQP message containing this type of event does not have any payload so the body of the message MUST be empty.</p>
+
+<p>The AMQP 1.0 properties an event sender needs to set for an <em>empty notification</em> event are defined in the <a href="/hono/docs/1.2/api/telemetry/"><em>Telemetry API</em></a>.</p>
+
+<p>The relevant properties are listed again in the following table:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>content-type</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>symbol</em></td>
+<td align="left">MUST be set to <em>application/vnd.eclipse-hono-empty-notification</em></td>
+</tr>
+
+<tr>
+<td align="left"><em>ttd</em></td>
+<td align="center">no</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>int</em></td>
+<td align="left">The <em>time &lsquo;til disconnect</em> as described in the <a href="/hono/docs/1.2/api/telemetry/"><em>Telemetry API</em></a>.</td>
+</tr>
+</tbody>
+</table>
+
+<p><strong>NB</strong> An empty notification can be used to indicate to a <em>Business Application</em> that a device is currently ready to receive an upstream message by setting the <em>ttd</em> property. <em>Backend Applications</em> may use this information to determine the time window during which the device will be able to receive a command.</p>
+
+<h3 id="connection-event">Connection Event</h3>
+
+<p>Protocol Adapters may send this type of event to indicate that a connection with a device has
+been established or has ended. Note that such events can only be sent for authenticated devices,
+though, because an event is always scoped to a tenant and the tenant of a device is
+established as part of the authentication process.</p>
+
+<p>The AMQP message for a connection event MUST contain the following properties in addition to the standard event properties:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>content-type</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>symbol</em></td>
+<td align="left">Must be set to  <em>application/vnd.eclipse-hono-dc-notification+json</em></td>
+</tr>
+
+<tr>
+<td align="left"><em>device_id</em></td>
+<td align="center">yes</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The ID of the authenticated device</td>
+</tr>
+</tbody>
+</table>
+
+<p>Each connection event&rsquo;s payload MUST contain a UTF-8 encoded string representation of a single JSON object with the following fields:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>cause</em></td>
+<td align="center">yes</td>
+<td align="left"><em>string</em></td>
+<td align="left">The cause of the connection event. MUST be set to either <code>connected</code> or <code>disconnected</code>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>remote-id</em></td>
+<td align="center">yes</td>
+<td align="left"><em>string</em></td>
+<td align="left">An identifier of the device that is the subject of this event, e.g. an IP address:port, client id etc. The format and semantics of this identifier is specific to the protocol adapter and the transport protocol it supports.</td>
+</tr>
+
+<tr>
+<td align="left"><em>source</em></td>
+<td align="center">yes</td>
+<td align="left"><em>string</em></td>
+<td align="left">The type name of the protocol adapter reporting the event, e.g. <code>hono-mqtt</code>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>data</em></td>
+<td align="center">no</td>
+<td align="left"><em>object</em></td>
+<td align="left">An arbitrary JSON object which may contain additional information about the occurrence of the event.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The example below might be used by the MQTT adapter to indicate that a connection with a device using client identifier <code>mqtt-client-id-1</code> has been established:</p>
+
+<pre><code class="language-json">{
+  &quot;cause&quot;: &quot;connected&quot;,
+  &quot;remote-id&quot;: &quot;mqtt-client-id-1&quot;,
+  &quot;source&quot;: &quot;hono-mqtt&quot;,
+  &quot;data&quot;: {
+    &quot;foo&quot;: &quot;bar&quot;
+  }
+}
+</code></pre>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/api/index.html b/docs/1.2/api/index.html
new file mode 100644
index 0000000..94a41db
--- /dev/null
+++ b/docs/1.2/api/index.html
@@ -0,0 +1,2456 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>API :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="API :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="API :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/api//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/api/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        parent
+        active
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/api/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/api/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/api/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/api/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/api/_index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > API
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+              </div>
+            </div>
+            
+
+        
+          <div id="chapter">
+        
+        <div id="body-inner">
+          
+
+        
+
+
+
+
+<h1 id="api">API</h1>
+
+<p>Documentation of the APIs defined by Eclipse Hono&trade;.</p>
+
+<p>For an overview of the available APIs, see the <a href="/hono/docs/1.2/architecture/component-view/">architecture documentation</a>.</p>
+
+
+<footer class=" footline" >
+	
+</footer>
+
+        
+            </div> 
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
diff --git a/docs/1.2/api/index.xml b/docs/1.2/api/index.xml
new file mode 100644
index 0000000..fe538ca
--- /dev/null
+++ b/docs/1.2/api/index.xml
@@ -0,0 +1,114 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>API on Eclipse Hono&amp;trade; Vers.: 1.2</title>
+    <link>https://www.eclipse.org/hono/docs/1.2/api/</link>
+    <description>Recent content in API on Eclipse Hono&amp;trade; Vers.: 1.2</description>
+    <generator>Hugo -- gohugo.io</generator>
+    <language>en-us</language>
+    
+	<atom:link href="https://www.eclipse.org/hono/docs/1.2/api/index.xml" rel="self" type="application/rss+xml" />
+    
+    
+    <item>
+      <title>Telemetry API Specification</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/telemetry/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/telemetry/</guid>
+      <description>&lt;p&gt;The &lt;em&gt;Telemetry&lt;/em&gt; API is used by &lt;em&gt;Protocol Adapters&lt;/em&gt; to send telemetry data downstream.
+&lt;em&gt;Business Applications&lt;/em&gt; and other consumers use the API to receive data published by devices belonging to a particular tenant.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Event API Specification</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/event/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/event/</guid>
+      <description>&lt;p&gt;The &lt;em&gt;Event&lt;/em&gt; API is used by &lt;em&gt;Protocol Adapters&lt;/em&gt; to send event messages downstream.
+&lt;em&gt;Business Applications&lt;/em&gt; and other consumers use the API to receive messages published by devices belonging to a particular tenant.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Command &amp; Control API Specification</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/command-and-control/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/command-and-control/</guid>
+      <description>&lt;p&gt;The &lt;em&gt;Command &amp;amp; Control&lt;/em&gt; API of Eclipse Hono&amp;trade; is used by &lt;em&gt;Business Applications&lt;/em&gt; to send commands to connected devices.&lt;/p&gt;
+
+&lt;p&gt;Commands can be used to trigger actions on devices. Examples include updating a configuration property, installing a software component or switching the state of an actuator.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Tenant API Specification</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/tenant/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/tenant/</guid>
+      <description>&lt;p&gt;The &lt;em&gt;Tenant API&lt;/em&gt; is used by Hono&amp;rsquo;s protocol adapters to retrieve information that affects all devices belonging to a particular tenant.
+A tenant is a logical entity, which groups together a set of devices. The information registered for a tenant is used for example to
+determine if devices belonging to the tenant are allowed to connect to a certain protocol adapter or if devices are required to authenticate.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Device Connection API Specification</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/device-connection/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/device-connection/</guid>
+      <description>&lt;p&gt;The &lt;em&gt;Device Connection API&lt;/em&gt; is used by &lt;em&gt;Protocol Adapters&lt;/em&gt; to set and retrieve information about the connections from devices or gateways to the protocol adapters.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Device Registration API Specification</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/device-registration/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/device-registration/</guid>
+      <description>&lt;p&gt;The &lt;em&gt;Device Registration API&lt;/em&gt; is used by Hono&amp;rsquo;s protocol adapters to get information about devices connecting to the adapters.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Credentials API Specification</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/credentials/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/credentials/</guid>
+      <description>&lt;p&gt;The &lt;em&gt;Credentials API&lt;/em&gt; is used by &lt;em&gt;Protocol Adapters&lt;/em&gt; to retrieve credentials used to authenticate &lt;em&gt;Devices&lt;/em&gt; connecting to the adapter. In particular, the API supports to look up &lt;em&gt;shared secrets&lt;/em&gt; which are often used by IoT devices by means of &lt;em&gt;username/password&lt;/em&gt; based authentication schemes.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Authentication API Specification</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/authentication/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/authentication/</guid>
+      <description>&lt;p&gt;The &lt;em&gt;Authentication API&lt;/em&gt; is used to retrieve a &lt;em&gt;token&lt;/em&gt; asserting a subject&amp;rsquo;s identity and granted authorities. Other service implementations use such a token to make authorization decisions on a client&amp;rsquo;s request to read or write from/to a resource or to invoke a certain operation.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Device Registry Management API Specification</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/management/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/management/</guid>
+      <description>  window.onload = function() { const ui = SwaggerUIBundle({ url: &#34;device-registry-v1.yaml&#34;, dom_id: &#39;#swagger-ui&#39;, deepLinking: true, presets: [ SwaggerUIBundle.presets.apis, SwaggerUIStandalonePreset ], plugins: [ SwaggerUIBundle.plugins.DownloadUrl ], layout: &#34;StandaloneLayout&#34;, docExpansion: &#34;none&#34;, defaultModelRendering: &#34;model&#34;, defaultModelExpandDepth: 0, defaultModelsExpandDepth: -1, validatorUrl: null }) window.ui = ui }  </description>
+    </item>
+    
+    <item>
+      <title>Metrics</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/metrics/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/metrics/</guid>
+      <description>&lt;p&gt;Eclipse Hono&amp;trade;&amp;rsquo;s components report several metrics which may be used to gain some insight
+into the running system. For instance, the HTTP adapter reports the number of successfully
+processed telemetry messages. Some of these metrics are considered part of Hono&amp;rsquo;s external
+interface. This section describes the semantics and format of the metrics, how they can be retrieved
+and how to interpret actual values.&lt;/p&gt;</description>
+    </item>
+    
+  </channel>
+</rss>
\ No newline at end of file
diff --git a/docs/1.2/api/management/device-registry-v1.yaml b/docs/1.2/api/management/device-registry-v1.yaml
new file mode 100644
index 0000000..0b55f1d
--- /dev/null
+++ b/docs/1.2/api/management/device-registry-v1.yaml
@@ -0,0 +1,1111 @@
+openapi: 3.0.1
+info:
+   title: Eclipse Hono™ Device Registry API
+   description: |
+      This API defines how to manage *Tenants*, *Devices*, and *Credentials*.
+      It acts as a common basis which all Hono device registries should
+      implement.
+
+      ## Required APIs
+
+      All operations, except the `tenants` resource are required. The tenant
+      management might be outside of the scope of the device registry and
+      managed by a higher level system. In this case all calls should simply
+      return `404`. However, if the `tenants` resource is implemented, then all
+      operations of it must be implemented.
+
+      ## Security
+
+      This specification explicitly leaves out the part of authenticating and
+      authorizing users with the device registry. It is assumed that some form
+      of token exchange between the user agent and the backend service will
+      take place. Like for example HTTP basic authentication, or a bearer token.
+
+      ## Code generation
+
+      This model is not optimized for generating code from it. Code generators
+      try to understand the model and then translate this into the require
+      programming language. Even if the there would be no bugs in the code
+      generators, that process would be already only be an approximation. So
+      this model does focus in the description of the API, and doesn't tweak
+      the specification in a way to please code generators.
+
+   contact:
+      name: Contact details
+      url: https://www.eclipse.org/hono/community/get-in-touch/
+   license:
+      name: EPL-2.0
+      url: https://www.eclipse.org/legal/epl-2.0/
+   version: 1.1.0
+
+externalDocs:
+   description: Eclipse Hono™ web page
+   url: https://eclipse.org/hono
+
+tags:
+   - name: tenants
+     description: Tenant Management (optional)
+     externalDocs:
+        description: Hono Multi-Tenancy
+        url: https://www.eclipse.org/hono/docs/concepts/tenancy/
+   - name: devices
+     description: Device registration
+     externalDocs:
+        description: Hono device identity
+        url: https://www.eclipse.org/hono/docs/concepts/device-identity/
+   - name: credentials
+     description: Device credentials
+     externalDocs:
+        description: Hono device identity
+        url: https://www.eclipse.org/hono/docs/concepts/device-identity/
+
+servers:
+   - url: '{server}/v1'
+     variables:
+        server:
+           default: http://hono.eclipse.org:28080
+
+security:
+   - BearerAuth: []
+   - BasicAuth: []
+
+paths:
+
+# Tenant API
+
+   /tenants:
+
+      post:
+         tags:
+            - tenants
+         summary: Create new tenant with auto-generated ID
+         operationId: createTenant
+         requestBody:
+            description: New tenant information
+            content:
+               application/json:
+                  schema:
+                     $ref: '#/components/schemas/Tenant'
+            required: false
+         responses:
+            201:
+               $ref: '#/components/responses/Created'
+            400:
+               $ref: '#/components/responses/MalformedRequest'
+            401:
+               $ref: '#/components/responses/Unauthorized'
+            403:
+               $ref: '#/components/responses/NotAllowed'
+            409:
+               description: |
+                  Indicates that an existing tenant uses a certificate authority with the same Subject DN.
+                  If the client has no read access to the conflicting tenant then `403` should be returned instead.
+               content:
+                  application/json:
+                     schema:
+                        $ref: '#/components/schemas/Error'
+                     example:
+                        error: "Root Certificate Authority is already used by other tenant"
+                        subject-dn: "CN=devices,OU=iot,O=ACME"
+
+   /tenants/{tenantId}:
+
+      parameters:
+         - $ref: '#/components/parameters/tenantId'
+
+      post:
+         tags:
+            - tenants
+         summary: Create new tenant
+         operationId: createTenantWithId
+         requestBody:
+            description: New tenant registration
+            content:
+               application/json:
+                  schema:
+                     $ref: '#/components/schemas/Tenant'
+            required: false
+         responses:
+            201:
+               $ref: '#/components/responses/Created'
+            400:
+               $ref: '#/components/responses/MalformedRequest'
+            401:
+               $ref: '#/components/responses/Unauthorized'
+            403:
+               $ref: '#/components/responses/NotAllowed'
+            409:
+               description: |
+                  Indicates that tenant with the given identifier already exists or that an existing tenant uses
+                  a certificate authority with the same Subject DN.
+                  If the client has no read access to the conflicting tenant then `403` should be returned instead.
+               content:
+                  application/json:
+                     schema:
+                        $ref: '#/components/schemas/Error'
+                     example:
+                        error: "tenant with given identifier already exists"
+
+      get:
+         tags:
+            - tenants
+         summary: Get tenant information
+         operationId: getTenant
+         responses:
+            200:
+               description: operation successful
+               content:
+                  application/json:
+                     schema:
+                        $ref: '#/components/schemas/Tenant'
+               headers:
+                  ETag:
+                     description: Version of the resource
+                     schema:
+                        type: string
+            400:
+               $ref: '#/components/responses/MalformedRequest'
+            401:
+               $ref: '#/components/responses/Unauthorized'
+            404:
+               $ref: '#/components/responses/NotFound'
+
+      put:
+         tags:
+            - tenants
+         summary: Update tenant information
+         operationId: updateTenant
+         parameters:
+            - $ref: '#/components/parameters/resourceVersion'
+         requestBody:
+            description: Tenant information
+            content:
+               application/json:
+                  schema:
+                     $ref: '#/components/schemas/Tenant'
+            required: true
+         responses:
+            204:
+               $ref: '#/components/responses/Updated'
+            400:
+               $ref: '#/components/responses/MalformedRequest'
+            401:
+               $ref: '#/components/responses/Unauthorized'
+            403:
+               $ref: '#/components/responses/NotAllowed'
+            404:
+               $ref: '#/components/responses/NotFound'
+            409:
+               description: |
+                  Indicates that an existing tenant uses a certificate authority with the same Subject DN.
+                  If the client has no read access to the conflicting tenant then `403` should be returned instead.
+               content:
+                  application/json:
+                     schema:
+                        $ref: '#/components/schemas/Error'
+                     example:
+                        error: "Root Certificate Authority is already used by other tenant"
+                        subject-dn: "CN=devices,OU=iot,O=ACME"
+            412:
+               $ref: '#/components/responses/ResourceVersionMismatch'
+
+      delete:
+         tags:
+            - tenants
+         summary: Delete tenant
+         operationId: deleteTenant
+         parameters:
+            - $ref: '#/components/parameters/resourceVersion'
+         responses:
+            204:
+               $ref: '#/components/responses/Deleted'
+            401:
+               $ref: '#/components/responses/Unauthorized'
+            403:
+               $ref: '#/components/responses/NotAllowed'
+            404:
+               $ref: '#/components/responses/NotFound'
+            412:
+               $ref: '#/components/responses/ResourceVersionMismatch'
+
+# Device API
+
+   /devices/{tenantId}:
+
+      parameters:
+         - $ref: '#/components/parameters/tenantId'
+
+      post:
+         tags:
+            - devices
+         summary: Create new device registration with auto-generated ID
+         operationId: createDeviceRegistration
+         requestBody:
+            description: New device
+            content:
+               application/json:
+                  schema:
+                     $ref: '#/components/schemas/Device'
+            required: false
+         responses:
+            201:
+               $ref: '#/components/responses/Created'
+            400:
+               $ref: '#/components/responses/MalformedRequest'
+            401:
+               $ref: '#/components/responses/Unauthorized'
+            403:
+               $ref: '#/components/responses/NotAllowed'
+
+   /devices/{tenantId}/{deviceId}:
+
+      parameters:
+         - $ref: '#/components/parameters/tenantId'
+         - $ref: '#/components/parameters/deviceId'
+
+      post:
+         tags:
+            - devices
+         summary: Create new device registration
+         operationId: createDeviceRegistrationWithId
+         requestBody:
+            description: New device
+            content:
+               application/json:
+                  schema:
+                     $ref: '#/components/schemas/Device'
+            required: false
+         responses:
+            201:
+               $ref: '#/components/responses/Created'
+            400:
+               $ref: '#/components/responses/MalformedRequest'
+            401:
+               $ref: '#/components/responses/Unauthorized'
+            403:
+               $ref: '#/components/responses/NotAllowed'
+            409:
+               $ref: '#/components/responses/AlreadyExists'
+
+      get:
+         tags:
+            - devices
+         summary: Get device registration information
+         operationId: getRegistration
+         responses:
+            200:
+               description: operation successful
+               content:
+                  application/json:
+                     schema:
+                        $ref: '#/components/schemas/Device'
+               headers:
+                  ETag:
+                     description: Version of the resource
+                     schema:
+                        type: string
+            400:
+               $ref: '#/components/responses/MalformedRequest'
+            401:
+               $ref: '#/components/responses/Unauthorized'
+            404:
+               $ref: '#/components/responses/NotFound'
+
+      put:
+         tags:
+            - devices
+         summary: Update existing device registration
+         operationId: updateRegistration
+         parameters:
+            - $ref: '#/components/parameters/resourceVersion'
+         requestBody:
+            description: Updated device registration
+            content:
+               application/json:
+                  schema:
+                     $ref: '#/components/schemas/Device'
+            required: true
+         responses:
+            204:
+               $ref: '#/components/responses/Updated'
+            400:
+               $ref: '#/components/responses/MalformedRequest'
+            401:
+               $ref: '#/components/responses/Unauthorized'
+            403:
+               $ref: '#/components/responses/NotAllowed'
+            404:
+               $ref: '#/components/responses/NotFound'
+            412:
+               $ref: '#/components/responses/ResourceVersionMismatch'
+
+      delete:
+         tags:
+            - devices
+         summary: Delete device registration
+         operationId: deleteRegistration
+         parameters:
+            - $ref: '#/components/parameters/resourceVersion'
+         responses:
+            204:
+               $ref: '#/components/responses/Deleted'
+            401:
+               $ref: '#/components/responses/Unauthorized'
+            403:
+               $ref: '#/components/responses/NotAllowed'
+            404:
+               $ref: '#/components/responses/NotFound'
+            412:
+               $ref: '#/components/responses/ResourceVersionMismatch'
+
+   /credentials/{tenantId}/{deviceId}:
+
+      parameters:
+         - $ref: '#/components/parameters/tenantId'
+         - $ref: '#/components/parameters/deviceId'
+
+      get:
+         tags:
+            - credentials
+         summary: Get credentials set of a device.
+         description: |
+            Get the credentials set of a device. As long as the device is
+            registered and the user has read access to it, this call should
+            never return "not found".
+            Depending on its implementation (or configuration), the device registry
+            can either return all credentials information including full secret details or
+            secret metadata along with the generated identifier (an `id` property).
+            The identifier can be used for the follow-up `update` operation).
+         operationId: getAllCredentials
+         responses:
+            200:
+               description: Operation successful
+               content:
+                  application/json:
+                     schema:
+                        $ref: '#/components/schemas/CredentialsSet'
+                     examples:
+                        Credentials Metadata:
+                           $ref: '#/components/examples/MetaPasswordExample'
+               headers:
+                  ETag:
+                     description: Version of the resource
+                     schema:
+                        type: string
+            400:
+               $ref: '#/components/responses/MalformedRequest'
+            401:
+               $ref: '#/components/responses/Unauthorized'
+            404:
+               $ref: '#/components/responses/NotFound'
+
+      put:
+         tags:
+            - credentials
+         summary: Update credentials set for registered device
+         description: If the device registry is handling full secret details, the updated credential set
+                      will be an exact match of the provided content. If it is using secret metadata,
+                      data will be merged in based on the secret identities.
+         operationId: setAllCredentials
+         parameters:
+            - $ref: '#/components/parameters/resourceVersion'
+         requestBody:
+            content:
+               application/json:
+                  schema:
+                     $ref: '#/components/schemas/CredentialsSet'
+                  examples:
+                     Hashed Password:
+                        $ref: '#/components/examples/HashedPasswordExample'
+                     Plain Password:
+                        $ref: '#/components/examples/PlainPasswordExample'
+            required: true
+         responses:
+            204:
+               $ref: '#/components/responses/Updated'
+            400:
+               $ref: '#/components/responses/MalformedRequest'
+            401:
+               $ref: '#/components/responses/Unauthorized'
+            403:
+               $ref: '#/components/responses/NotAllowed'
+            404:
+               $ref: '#/components/responses/NotFound'
+            412:
+               $ref: '#/components/responses/ResourceVersionMismatch'
+
+components:
+
+   schemas:
+
+# Common schema
+
+      Error:
+         type: object
+         additionalProperties: true
+         required:
+            - error
+         properties:
+            "error":
+               type: string
+               description: A human readable error message of what went wrong.
+
+      DefaultProperties:
+         type: object
+         additionalProperties: true
+         description: Defaults for properties defined on the tenant and device level.
+
+      Extensions:
+         type: object
+         additionalProperties: true
+         description: Allows arbitrary properties as extension to the ones
+                      specified by the Hono API.
+
+# Tenant schema
+
+      Tenant:
+         type: object
+         additionalProperties: false
+         properties:
+            "enabled":
+               type: boolean
+               default: true
+            "ext":
+               $ref: '#/components/schemas/Extensions'
+            "adapters":
+               type: array
+               description: |
+                  A list of configuration options for certain types of protocol adapters.
+                  If set then the array must not be empty.
+                  Multiple entries for the same type are considered an error.
+                  If not set, then all adapters are enabled using their respective
+                  default configuration.
+               items:
+                  $ref: '#/components/schemas/Adapter'
+            "defaults":
+               $ref: '#/components/schemas/DefaultProperties'
+            "minimum-message-size":
+               type: integer
+               default: 0
+               description: |
+                  The minimum message size in bytes. If set, then reported size of
+                  telemetry, event and command messages is calculated as the minimum multiple
+                  of the configured value that is greater than or equal to the messages
+                  payload size.
+            "resource-limits":
+               $ref: '#/components/schemas/ResourceLimit'
+            "tracing":
+               $ref: '#/components/schemas/TracingConfig'
+            "trusted-ca":
+               type: array
+               description: |
+                  The set of root certificate authorities which are used for verifying the signature of
+                  client certificates that devices use for authentication.
+               items:
+                  $ref: '#/components/schemas/TrustedCA'
+
+      TrustedCA:
+         type: object
+         additionalProperties: false
+         properties:
+            "subject-dn":
+               type: string
+               description: |
+                  The subject DN of the trusted root certificate in
+                  the format defined by RFC 2253.
+                  CAs of the *same* tenant may share the same subject DN, e.g.
+                  allowing for the definition of overlapping validity periods.
+                  However, CAs of *different* tenants must not share the same
+                  subject DN in order to allow for the unique look up of a tenant by
+                  the subject DN of one of its trusted CAs.
+                  If the `cert` property is used to provide an X.509 certificate
+                  then the subject DN is determined from the certificate and this
+                  property is ignored.
+                  Otherwise, i.e. if the `public-key` property is
+                  used, this property is mandatory.
+            "public-key":
+               type: string
+               format: byte
+               description: |
+                  The Base64 encoded binary DER encoding of the
+                  trusted root certificate’s public key.
+                  If the `cert` property is used to provide an
+                  X.509 certificate then the public key is extracted
+                  from the certificate and this property is ignored.
+                  Either this property or `cert` must be set.
+            "algorithm":
+               type: string
+               description: |
+                  The algorithm used for the public key of the CA.
+                  If the `cert` property is used to provide an
+                  X.509 certificate then the algorithm is determined
+                  from the certificate and this property is ignored.
+                  Otherwise, i.e. if the `public-key` property is
+                  used, this property must be set to the algorithm
+                  used, if other than the default.
+               default: RSA
+               example: EC
+            "not-before":
+               type: string
+               format: date-time
+               description: |
+                  The point in time from which on the certificate authority
+                  may be used for authenticating devices.
+                  If the `cert` property is used to provide an
+                  X.509 certificate then the point in time is
+                  determined from the certificate and this property is ignored.
+                  Otherwise, i.e. if the `public-key` property is
+                  used, this property is mandatory.
+            "not-after":
+               type: string
+               format: date-time
+               description: |
+                  The point in time until which the certificate authority
+                  may be used for authenticating devices.
+                  If the `cert` property is used to provide an
+                  X.509 certificate then the point in time is
+                  determined from the certificate and this property is ignored.
+                  Otherwise, i.e. if the `public-key` property is
+                  used, this property is mandatory.
+            "cert":
+               type: string
+               format: byte
+               description: |
+                  The Base64 encoded binary DER encoding of the trusted X.509 root certificate.
+                  This property can be used as a convenient alternative to
+                  specifying the `public-key`, `not-before`, `not-after` and
+                  `algorithm` properties explicitly. Implementors of this
+                  API may choose to support this property only for uploading
+                  a certificate but then extract all relevant data and store
+                  it in the properties described above.
+                  Either this property or `public-key` must be set.
+            "auto-provisioning-enabled":
+               type: boolean
+               default: false
+               description: |
+                  Indicates whether this trusted certificate may be used for automatically provisioning devices.
+                  If it is *true* and the feature is supported by the device registry, the device registry
+                  automatically provisions unregistered devices that authenticate with a client certificate
+                  issued by this CA (i.e. creates registration and credentials).
+
+         example:
+            subject-dn: "CN=devices,OU=iot,O=ACME"
+            public-key: "Tk9UIEEgUFVCTElDIEtFWQ=="
+            algorithm: "EC"
+            auto-provisioning-enabled: false
+            not-before: "2019-10-03T13:45:16+02:00"
+            not-after: "2021-10-03T00:00:00Z"
+
+      Adapter:
+         type: object
+         additionalProperties: true
+         required:
+            - type
+         properties:
+            "type":
+               type: string
+            "enabled":
+               type: boolean
+               default: false
+            "device-authentication-required":
+               type: boolean
+               default: true
+            "ext":
+               $ref: '#/components/schemas/Extensions'
+
+      ResourceLimit:
+         type: object
+         additionalProperties: false
+         properties:
+            "max-connections":
+               type: integer
+               default: -1
+               description: |
+                  The maximum number of concurrent connections allowed from devices of this tenant.
+                  A value of `-1` (the default) indicates that no limit is set.
+            "max-ttl":
+               type: integer
+               default: -1
+               description: |
+                  The maximum time-to-live (in seconds) to use for events published by
+                  devices of this tenant. Any default TTL value specified
+                  at either the tenant or device level will be limited to
+                  the max value specified here.
+                  If this property is set to a value greater than -1 and no
+                  default TTL is specified for a device, the max value will
+                  be used for events published by the device.
+                  A value of `-1` (the default) indicates that no limit is set.
+                  Note that this property contains the TTL in seconds whereas
+                  the AMQP 1.0 specification defines a message's ttl header
+                  to use milliseconds.
+            "data-volume":
+               $ref: '#/components/schemas/DataVolume'
+            "connection-duration":
+               $ref: '#/components/schemas/ConnectionDuration'
+            "ext":
+               $ref: '#/components/schemas/Extensions'
+
+      TracingConfig:
+         type: object
+         additionalProperties: false
+         properties:
+            "sampling-mode":
+               type: string
+               description: |
+                  Defines if and how often OpenTracing spans are being
+                  sampled when processing messages for this tenant.
+                  The value `default` indicates that the underyling tracing
+                  system's default sampling mode should be used.
+                  The value `all` indicates that every span created for
+                  messages of the tenant will be sampled.
+                  The value `none` indicates that no spans should be sampled
+                  at all for the tenant.
+                  The mode defined here may be overridden for specific
+                  devices by means of the `sampling-mode-per-auth-id`
+                  property.
+               default: default
+               enum:
+                  - default
+                  - all
+                  - none
+            "sampling-mode-per-auth-id":
+               type: object
+               description: |
+                  Defines if and how often OpenTracing spans are being
+                  sampled when processing messages for specific devices
+                  of this tenant.
+                  This object contains a property for each device for which
+                  specific behavior should be defined, using the device's
+                  authentication identifier as the property name and
+                  the device specific sampling mode as its value.
+                  The value `default` indicates that the underyling tracing
+                  system's default sampling mode should be used.
+                  The value `all` indicates that every span created for
+                  messages of the tenant will be sampled.
+                  The value `none` indicates that no spans should be sampled
+                  at all for the tenant.
+                  The mode defined for a particular device has precedence
+                  over the value defined by the `sampling-mode` property.
+               additionalProperties:
+                  type: string
+                  description: |
+                    The property name is the device's 'authentication identifier.
+                  default: default
+                  enum:
+                     - default
+                     - all
+                     - none
+
+      DataVolume:
+         type: object
+         additionalProperties: false
+         required:
+            - effective-since
+         properties:
+            "effective-since":
+               type: string
+               format: date-time
+               description: The date-time on which the data volume limit came into effect.
+            "max-bytes":
+               type: integer
+               default: -1
+               description: The maximum number of bytes to be allowed for a tenant for the
+                            defined period.
+                            A value of -1 (the default) indicates that no limit is set.
+            "period":
+               $ref: '#/components/schemas/Period'
+
+      ConnectionDuration:
+         type: object
+         additionalProperties: false
+         required:
+            - effective-since
+         properties:
+            "effective-since":
+               type: string
+               format: date-time
+               description: The date-time on which the connection duration limit came into effect.
+            "max-minutes":
+               type: integer
+               default: -1
+               description: The maximum number of minutes to be allowed for a tenant for the
+                  defined period.
+                  A value of -1 (the default) indicates that no limit is set.
+            "period":
+               $ref: '#/components/schemas/Period'
+
+      Period:
+         type: object
+         additionalProperties: false
+         required:
+            - mode
+         properties:
+            "mode":
+               type: string
+               description: The mode of the data usage caluclation. The supported modes by
+                            the default resource limit checks implementation are "days"
+                            and "monthly".
+            "no-of-days":
+               type: integer
+               description: The number of days for which the data usage is to be calculated
+                            if mode is set to "days". Otherwise, this property is ignored.
+               
+# Devices schema
+
+      Device:
+         type: object
+         additionalProperties: false
+         properties:
+            "enabled":
+               type: boolean
+               default: true
+            "defaults":
+               $ref: '#/components/schemas/DefaultProperties'
+            "via":
+               type: array
+               items:
+                  type: string
+               description: The device IDs of the gateways that are registered to act on behalf of this device. Note that "via" and "memberOf" must not be set at the same time.
+            "viaGroups":
+               type: array
+               items:
+                  type: string
+               description: The IDs of the gateway groups that are registered to act on behalf of this device. Note that "viaGroups" and "memberOf" must not be set at the same time.
+            "memberOf":
+               type: array
+               items:
+                  type: string
+               description: The IDs of the gateway groups that this device is a member of. Note that "via" and "memberOf" must not be set at the same time. The same applies for "viaGroups" and "memberOf" which must be set at the same time too. The reason is that Eclipse Hono does not support groups of gateway groups.
+            "ext":
+               $ref: '#/components/schemas/Extensions'
+
+# Credentials
+
+      CredentialsSet:
+         type: array
+         description: A set of credentials. The entries in this list must be
+                      unique by the composite key of `auth-id` and `type`.
+         items:
+            $ref: '#/components/schemas/TypedCredentials'
+
+      TypedCredentials:
+         additionalProperties: false
+         oneOf:
+            - $ref: '#/components/schemas/PasswordCredentials'
+            - $ref: '#/components/schemas/PSKCredentials'
+            - $ref: '#/components/schemas/X509CertificateCredentials'
+         discriminator:
+            propertyName: type
+            mapping:
+               "hashed-password": '#/components/schemas/PasswordCredentials'
+               "psk": '#/components/schemas/PSKCredentials'
+               "x509-cert": '#/components/schemas/X509CertificateCredentials'
+
+      CommonCredentials:
+         type: object
+         additionalProperties: false
+         required:
+            - auth-id
+            - type
+         properties:
+            "type":
+               type: string
+            "auth-id":
+               type: string
+            "enabled":
+               type: boolean
+               default: true
+            "ext":
+               $ref: '#/components/schemas/Extensions'
+
+      PasswordCredentials:
+         additionalProperties: false
+         allOf:
+            - $ref: '#/components/schemas/CommonCredentials'
+            - type: object
+              additionalProperties: false
+              properties:
+                 "secrets":
+                    type: array
+                    items:
+                       $ref: '#/components/schemas/PasswordSecret'
+
+      PSKCredentials:
+         additionalProperties: false
+         allOf:
+            - $ref: '#/components/schemas/CommonCredentials'
+            - type: object
+              additionalProperties: false
+              properties:
+                 "secrets":
+                    type: array
+                    items:
+                       $ref: '#/components/schemas/PSKSecret'
+
+      X509CertificateCredentials:
+         additionalProperties: false
+         allOf:
+            - $ref: '#/components/schemas/CommonCredentials'
+            - type: object
+              additionalProperties: false
+              properties:
+                 "secrets":
+                    type: array
+                    items:
+                       $ref: '#/components/schemas/X509CertificateSecret'
+
+      CommonSecret:
+         type: object
+         additionalProperties: false
+         properties:
+            "id":
+               type: string
+               description: The device registry can assign an identity to the secret.
+                            This value can be used to update secrets based on their metadata.
+            "enabled":
+               type: boolean
+               default: true
+            "not-before":
+               type: string
+               format: date-time
+            "not-after":
+               type: string
+               format: date-time
+            "comment":
+               type: string
+
+      X509CertificateSecret:
+         additionalProperties: false
+         allOf:
+            - $ref: '#/components/schemas/CommonSecret'
+
+      PasswordSecret:
+         description: |
+                      Password based secret definition <br>
+                      __NOTE__: Defining password secrets with user provided password hash, function and salt is deprecated and will be removed
+                      in the upcoming versions. You should use `pwd-plain` property only going forward.
+         additionalProperties: false
+         allOf:
+            - $ref: '#/components/schemas/CommonSecret'
+            - type: object
+              additionalProperties: false
+              properties:
+                 "hash-function":
+                    type: string
+                    example: bcrypt
+                    description: The name of the hash function used to create the password hash (defined in `pwd-hash` property).
+                                 If the password is defined using a `pwd-plain` property, this value will be ignored by the device registry.
+                                 This property should be empty when returning passwords from the device registry using only secret metadata.
+                                 In this case the id field must be set instead.
+                 "pwd-hash":
+                    type: string
+                    format: byte
+                    description: The password hash created using the `hash-function` and optional `salt` values.
+                                 If the password is defined using a `pwd-plain` property, this value will be ignored by the device registry.
+                                 This property should be empty when returning passwords from the device registry using only secret metadata.
+                                 In this case the id field must be set instead.
+                 "salt":
+                    type: string
+                    format: byte
+                    description: The Base64 encoding of the salt used in the password hash (defined in the `pwd-hash` property).
+                                 If the password is defined using a `pwd-plain` property, this value will be ignored by the device registry.
+                                 This property should be empty when returning passwords from the device registry using only secret metadata.
+                                 In this case the id field must be set instead.
+                 "pwd-plain":
+                    type: string
+                    format: byte
+                    description: The clear text value of the password to be hashed by the device registry.
+                                 If this property is specified, the device registry will ignore user-provided hash properties (`hash-function`, `pwd-hash` and `salt`).
+                                 This property must never be stored by the device registry.
+                                 This property must be empty when returning passwords from the device registry.
+
+      PSKSecret:
+         additionalProperties: false
+         allOf:
+            - $ref: '#/components/schemas/CommonSecret'
+            - type: object
+              additionalProperties: false
+              required:
+                 - key
+              properties:
+                 "key":
+                    type: string
+                    format: byte
+
+   parameters:
+
+      resourceVersion:
+         name: If-Match
+         in: header
+         description: The expected resource version
+         required: false
+         schema:
+            type: string
+
+      tenantId:
+         name: tenantId
+         in: path
+         description: The ID of the tenant
+         required: true
+         schema:
+            type: string
+         example: DEFAULT_TENANT
+
+      deviceId:
+         name: deviceId
+         in: path
+         description: The ID of the device
+         required: true
+         schema:
+            type: string
+         example: 4711
+
+      authId:
+         name: authId
+         in: path
+         description: The authentication ID of the device
+         required: true
+         schema:
+            type: string
+         example: sensor1
+
+      type:
+         name: type
+         in: path
+         description: The credentials type
+         required: true
+         schema:
+            type: string
+         example: sha-256
+
+   responses:
+
+      Unauthorized:
+         description: Authentication credentials are required, but missing.
+         headers:
+            "WWW-Authenticate":
+               schema:
+                  type: string
+
+      Created:
+         description: Object created.
+         headers:
+            Location:
+               description: URL to the resource
+               schema:
+                  type: string
+                  format: uri
+            ETag:
+               description: The new version of the resource
+               schema:
+                  type: string
+         content:
+            application/json:
+               schema:
+                  type: object
+                  additionalProperties: false
+                  required:
+                     - id
+                  properties:
+                     id:
+                        type: string
+                        description: The ID of the created object
+
+      Updated:
+         description: Object updated.
+         headers:
+            ETag:
+               description: The new version of the resource
+               schema:
+                  type: string
+
+      Deleted:
+         description: Object deleted.
+
+      NotFound:
+         description: |
+            Object not found. This may also be returned for some operations
+            if the user misses read access for the object.
+         content:
+            application/json:
+               schema:
+                  $ref: '#/components/schemas/Error'
+
+      NotAllowed:
+         description: |
+            Operation not allowed. If the user does not have read access
+            for this object, then `404` will be returned instead.
+         content:
+            application/json:
+               schema:
+                  $ref: '#/components/schemas/Error'
+
+      MalformedRequest:
+         description: Malformed request
+         content:
+            application/json:
+               schema:
+                  $ref: '#/components/schemas/Error'
+
+      AlreadyExists:
+         description: |
+            Object already exists. If the user has no read access for
+            the existing object, then `403` should be returned instead.
+         content:
+            application/json:
+               schema:
+                  $ref: '#/components/schemas/Error'
+
+      ResourceVersionMismatch:
+         description: |
+            Expected resource version does not match current.
+            This can only happen when the request header `If-Match`
+            was set.
+         content:
+            application/json:
+               schema:
+                  $ref: '#/components/schemas/Error'
+
+   securitySchemes:
+
+      BearerAuth:
+         type: http
+         scheme: bearer
+
+      BasicAuth:
+         type: http
+         scheme: basic
+
+   examples:
+      HashedPasswordExample:
+         value:
+            [{
+                auth-id: sensor1,
+                type: hashed-password,
+                secrets: [{
+                             "not-after": "2027-12-24T19:00:00Z",
+                             "pwd-hash": "AQIDBAUGBwg=",
+                             "salt": "Mq7wFw==",
+                             "hash-function": "sha-512"
+                          }]
+             }]
+
+      PlainPasswordExample:
+         value:
+           [{
+               auth-id: sensor1,
+               type: hashed-password,
+               secrets: [{
+                  "id": "349556ea-4902-47c7-beb0-1009ab693fb4",
+                  "not-after": "2027-12-24T19:00:00Z",
+                  "pwd-plain": "hono-secret"
+               }]
+            }]
+      MetaPasswordExample:
+         value:
+            auth-id: sensor1
+            type: hashed-password
+            secrets: [{
+               "id": "349556ea-4902-47c7-beb0-1009ab693fb4",
+               "not-after": "2027-12-24T19:00:00Z",
+            }]
diff --git a/docs/1.2/api/management/index.html b/docs/1.2/api/management/index.html
new file mode 100644
index 0000000..31444c2
--- /dev/null
+++ b/docs/1.2/api/management/index.html
@@ -0,0 +1,2499 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Device Registry Management API Specification :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<script src='/hono/docs/js/swagger-ui-bundle-3.23.11.js'></script>
+<script src='/hono/docs/js/swagger-ui-standalone-preset-3.23.11.js'></script>
+<link rel="stylesheet" href='/hono/docs/css/swagger-ui-3.23.11.css'>
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Device Registry Management API Specification :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Device Registry Management API Specification :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/api/management//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/api/management/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item active">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/api/management/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/management/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/api/management/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/api/management/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/api/management/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/api/management/index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/api/'>API</a> > Device Registry Management API Specification
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Device Registry Management API Specification</h1>
+          
+
+        
+
+
+<div id="swagger-ui"></div>
+
+<script>
+window.onload = function() {
+  
+  const ui = SwaggerUIBundle({
+    url: "device-registry-v1.yaml",
+    dom_id: '#swagger-ui',
+    deepLinking: true,
+    presets: [
+      SwaggerUIBundle.presets.apis,
+      SwaggerUIStandalonePreset
+    ],
+    plugins: [
+      SwaggerUIBundle.plugins.DownloadUrl
+    ],
+    layout: "StandaloneLayout",
+    docExpansion: "none", 
+    defaultModelRendering: "model", 
+    defaultModelExpandDepth: 0, 
+    defaultModelsExpandDepth: -1, 
+    validatorUrl: null 
+  })
+  
+  window.ui = ui
+}
+</script>
+
+
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/api/metrics/index.html b/docs/1.2/api/metrics/index.html
new file mode 100644
index 0000000..354f705
--- /dev/null
+++ b/docs/1.2/api/metrics/index.html
@@ -0,0 +1,2729 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Metrics :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Metrics :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Metrics :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/api/metrics//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/api/metrics/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item active">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/api/metrics/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/metrics/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/api/metrics/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/api/metrics/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/api/metrics/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/api/Metrics.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/api/'>API</a> > Metrics
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#reported-metrics">Reported Metrics</a>
+<ul>
+<li><a href="#common-metrics">Common Metrics</a></li>
+<li><a href="#protocol-adapter-metrics">Protocol Adapter Metrics</a>
+<ul>
+<li><a href="#minimum-message-size">Minimum Message Size</a></li>
+</ul></li>
+<li><a href="#service-metrics">Service Metrics</a></li>
+</ul></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Metrics</h1>
+          
+
+        
+
+
+<p>Eclipse Hono&trade;&rsquo;s components report several metrics which may be used to gain some insight
+into the running system. For instance, the HTTP adapter reports the number of successfully
+processed telemetry messages. Some of these metrics are considered part of Hono&rsquo;s external
+interface. This section describes the semantics and format of the metrics, how they can be retrieved
+and how to interpret actual values.</p>
+
+<h2 id="reported-metrics">Reported Metrics</h2>
+
+<p>Hono uses <a href="https://micrometer.io/">Micrometer</a> in combination with Spring Boot
+to internally collect metrics. Those metrics can be exported to different
+back ends. Please refer to <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/#configuring-a-metrics-back-end">Configuring Metrics</a>
+for details.</p>
+
+<p>The example deployment by default uses <a href="https://prometheus.io/">Prometheus</a> as the metrics back end.</p>
+
+<p>When deploying to Kubernetes/OpenShift, the metrics reported by Hono may contain
+environment specific tags (like the <em>pod</em> name) which are added by the Prometheus
+scraper. However, those tags are not part of the Hono metrics definition.</p>
+
+<p>Hono applications may report other metrics in addition to the ones defined here.
+In particular, all components report metrics regarding the JVM&rsquo;s internal state, e.g.
+memory consumption and garbage collection status. Those metrics are not considered
+part of Hono&rsquo;s <em>official</em> metrics definition. However, all those metrics
+will still contain tags as described below.</p>
+
+<h3 id="common-metrics">Common Metrics</h3>
+
+<p>Tags for common metrics are:</p>
+
+<table>
+<thead>
+<tr>
+<th>Tag</th>
+<th>Value</th>
+<th>Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td><em>host</em></td>
+<td><em>string</em></td>
+<td>The name of the host that the component reporting the metric is running on</td>
+</tr>
+
+<tr>
+<td><em>component-type</em></td>
+<td><code>adapter</code>, <code>service</code></td>
+<td>The type of component reporting the metric</td>
+</tr>
+
+<tr>
+<td><em>component-name</em></td>
+<td><em>string</em></td>
+<td>The name of the component reporting the metric.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The names of Hono&rsquo;s standard components are as follows:</p>
+
+<table>
+<thead>
+<tr>
+<th>Component</th>
+<th><em>component-name</em></th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td>Auth Server</td>
+<td><code>hono-auth</code></td>
+</tr>
+
+<tr>
+<td>Device Registry</td>
+<td><code>hono-registry</code></td>
+</tr>
+
+<tr>
+<td>AMQP adapter</td>
+<td><code>hono-amqp</code></td>
+</tr>
+
+<tr>
+<td>CoAP adapter</td>
+<td><code>hono-coap</code></td>
+</tr>
+
+<tr>
+<td>HTTP adapter</td>
+<td><code>hono-http</code></td>
+</tr>
+
+<tr>
+<td>Kura adapter</td>
+<td><code>hono-kura-mqtt</code></td>
+</tr>
+
+<tr>
+<td>MQTT adapter</td>
+<td><code>hono-mqtt</code></td>
+</tr>
+
+<tr>
+<td>Lora adapter</td>
+<td><code>hono-lora</code></td>
+</tr>
+
+<tr>
+<td>Sigfox adapter</td>
+<td><code>hono-sigfox</code></td>
+</tr>
+</tbody>
+</table>
+
+<h3 id="protocol-adapter-metrics">Protocol Adapter Metrics</h3>
+
+<p>Additional tags for protocol adapters are:</p>
+
+<table>
+<thead>
+<tr>
+<th>Name</th>
+<th>Value</th>
+<th>Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td><em>direction</em></td>
+<td><code>one-way</code>, <code>request</code>, <code>response</code></td>
+<td>The direction in which a Command &amp; Control message is being sent:<br><code>one-way</code> indicates a command sent to a device for which the sending application doesn&rsquo;t expect to receive a response.<br><code>request</code> indicates a command request message sent to a device.<br><code>response</code> indicates a command response received from a device.</td>
+</tr>
+
+<tr>
+<td><em>qos</em></td>
+<td><code>0</code>, <code>1</code>, <code>unknown</code></td>
+<td>The quality of service used for a telemetry or event message.<br><code>0</code> indicates <em>at most once</em>,<br><code>1</code> indicates <em>at least once</em> and<br> <code>none</code> indicates unknown delivery semantics.</td>
+</tr>
+
+<tr>
+<td><em>status</em></td>
+<td><code>forwarded</code>, <code>unprocessable</code>, <code>undeliverable</code></td>
+<td>The processing status of a message.<br><code>forwarded</code> indicates that the message has been forwarded to a downstream consumer<br><code>unprocessable</code> indicates that the message has not been processed not forwarded, e.g. because the message was malformed<br><code>undeliverable</code> indicates that the message could not be forwarded, e.g. because there is no downstream consumer or due to an infrastructure problem</td>
+</tr>
+
+<tr>
+<td><em>tenant</em></td>
+<td><em>string</em></td>
+<td>The identifier of the tenant that the metric is being reported for</td>
+</tr>
+
+<tr>
+<td><em>ttd</em></td>
+<td><code>command</code>, <code>expired</code>, <code>none</code></td>
+<td>A status indicating the outcome of processing a TTD value contained in a message received from a device.<br><code>command</code> indicates that a command for the device has been included in the response to the device&rsquo;s request for uploading the message.<br><code>expired</code> indicates that a response without a command has been sent to the device.<br><code>none</code> indicates that either no TTD value has been specified by the device or that the protocol adapter does not support it.</td>
+</tr>
+
+<tr>
+<td><em>type</em></td>
+<td><code>telemetry</code>, <code>event</code></td>
+<td>The type of (downstream) message that the metric is being reported for.</td>
+</tr>
+</tbody>
+</table>
+
+<p>Metrics provided by the protocol adapters are:</p>
+
+<table>
+<thead>
+<tr>
+<th>Metric</th>
+<th>Type</th>
+<th>Tags</th>
+<th>Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td><em>hono.commands.received</em></td>
+<td>Timer</td>
+<td><em>host</em>, <em>component-type</em>, <em>component-name</em>, <em>tenant</em>, <em>type</em>, <em>status</em>, <em>direction</em></td>
+<td>The time it took to process a message conveying a command or a response to a command.</td>
+</tr>
+
+<tr>
+<td><em>hono.commands.payload</em></td>
+<td>DistributionSummary</td>
+<td><em>host</em>, <em>component-type</em>, <em>component-name</em>, <em>tenant</em>, <em>type</em>, <em>status</em>, <em>direction</em></td>
+<td>The number of bytes conveyed in the payload of a command message.</td>
+</tr>
+
+<tr>
+<td><em>hono.connections.authenticated</em></td>
+<td>Gauge</td>
+<td><em>host</em>, <em>component-type</em>, <em>component-name</em>, <em>tenant</em></td>
+<td>Current number of connected, authenticated devices. <br/> <strong>NB</strong> This metric is only supported by protocol adapters that maintain <em>connection state</em> with authenticated devices. In particular, the HTTP adapter does not support this metric.</td>
+</tr>
+
+<tr>
+<td><em>hono.connections.unauthenticated</em></td>
+<td>Gauge</td>
+<td><em>host</em>, <em>component-type</em>, <em>component-name</em></td>
+<td>Current number of connected, unauthenticated devices. <br/> <strong>NB</strong> This metric is only supported by protocol adapters that maintain <em>connection state</em> with authenticated devices. In particular, the HTTP adapter does not support this metric.</td>
+</tr>
+
+<tr>
+<td><em>hono.connections.authenticated.duration</em></td>
+<td>Timer</td>
+<td><em>host</em>, <em>component-type</em>, <em>component-name</em>, <em>tenant</em></td>
+<td>The overall amount of time that authenticated devices have been connected to protocol adapters. <br/> <strong>NB</strong> This metric is only supported by protocol adapters that maintain <em>connection state</em> with authenticated devices. In particular, the HTTP adapter does not support this metric.</td>
+</tr>
+
+<tr>
+<td><em>hono.messages.received</em></td>
+<td>Timer</td>
+<td><em>host</em>, <em>component-type</em>, <em>component-name</em>, <em>tenant</em>, <em>type</em>, <em>status</em>, <em>qos</em>, <em>ttd</em></td>
+<td>The time it took to process a message conveying telemetry data or an event.</td>
+</tr>
+
+<tr>
+<td><em>hono.messages.payload</em></td>
+<td>DistributionSummary</td>
+<td><em>host</em>, <em>component-type</em>, <em>component-name</em>, <em>tenant</em>, <em>type</em>, <em>status</em></td>
+<td>The number of bytes conveyed in the payload of a telemetry or event message.</td>
+</tr>
+</tbody>
+</table>
+
+<h4 id="minimum-message-size">Minimum Message Size</h4>
+
+<p>If a minimum message size is configured for a <a href="/hono/docs/1.2/api/tenant/#tenant-information-format">tenant</a>,
+then the payload size of the telemetry, event and command messages are calculated in accordance with the configured
+value and then reported to the metrics by the AMQP, HTTP and MQTT protocol adapters. If minimum message size is not
+configured for a tenant then the actual message payload size is reported.</p>
+
+<p>Assume that the minimum message size for a tenant is configured as 4096 bytes (4KB). The payload size of
+an incoming message with size 1KB is calculated as 4KB by the protocol adapters and reported to the metrics system.
+For an incoming message of size 10KB, it is reported as 12KB.</p>
+
+<h3 id="service-metrics">Service Metrics</h3>
+
+<p>Hono&rsquo;s service components do not report any metrics at the moment.</p>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/api/telemetry/consume.svg b/docs/1.2/api/telemetry/consume.svg
new file mode 100644
index 0000000..d543c4a
--- /dev/null
+++ b/docs/1.2/api/telemetry/consume.svg
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="187.2px" preserveAspectRatio="none" style="width:601px;height:187px;" version="1.1" viewBox="0 0 601 187" width="601.2px" zoomAndPan="magnify"><defs><filter height="300%" id="fk0kzz7ikwsfa" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#fk0kzz7ikwsfa)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="490.2" y="83.3156"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="144" x2="144" y1="45.9563" y2="139.875"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="495.6" x2="495.6" y1="45.9563" y2="139.875"/><rect fill="#FEFECE" filter="url(#fk0kzz7ikwsfa)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="265.2" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="248.4" x="18" y="27.5941">AMQP 1.0 Messaging Network</text><rect fill="#FEFECE" filter="url(#fk0kzz7ikwsfa)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="265.2" x="9.6" y="138.675"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="248.4" x="18" y="162.6691">AMQP 1.0 Messaging Network</text><rect fill="#FEFECE" filter="url(#fk0kzz7ikwsfa)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="188.4" x="399.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="171.6" x="408" y="27.5941">Business Application</text><rect fill="#FEFECE" filter="url(#fk0kzz7ikwsfa)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="188.4" x="399.6" y="138.675"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="171.6" x="408" y="162.6691">Business Application</text><rect fill="#FFFFFF" filter="url(#fk0kzz7ikwsfa)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="490.2" y="83.3156"/><polygon fill="#A80036" points="475.8,78.5156,487.8,83.3156,475.8,88.1156,480.6,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="144.6" x2="483" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="322.8" x="153" y="77.2365">1.0 transfer(device_id: "4711", body: data)</text><polygon fill="#A80036" points="157.8,113.475,145.8,118.275,157.8,123.075,153,118.275" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="150.6" x2="495" y1="118.275" y2="118.275"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="254.4" x="165" y="112.1959">1.1 disposition(state: "accepted")</text><!--
+@startuml
+scale 1.2
+
+participant "AMQP 1.0 Messaging Network"
+participant "Business Application"
+
+"AMQP 1.0 Messaging Network" -> "Business Application"+: 1.0 transfer(device_id: "4711", body: data)
+"Business Application" -> "AMQP 1.0 Messaging Network"-: 1.1 disposition(state: "accepted")
+@enduml
+
+PlantUML version 1.2019.07(Mon Jun 24 19:59:20 UTC 2019)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/telemetry/forward_qos0.svg b/docs/1.2/api/telemetry/forward_qos0.svg
new file mode 100644
index 0000000..4ac292d
--- /dev/null
+++ b/docs/1.2/api/telemetry/forward_qos0.svg
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="258px" preserveAspectRatio="none" style="width:889px;height:258px;" version="1.1" viewBox="0 0 889 258" width="889.2px" zoomAndPan="magnify"><defs><filter height="300%" id="fu25wuvvfg960" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#fu25wuvvfg960)" height="69.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="382.2" y="83.3156"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="48" x2="48" y1="45.9563" y2="209.7938"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="387.6" x2="387.6" y1="45.9563" y2="209.7938"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="745.2" x2="745.2" y1="45.9563" y2="209.7938"/><rect fill="#FEFECE" filter="url(#fu25wuvvfg960)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="18" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#fu25wuvvfg960)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="9.6" y="208.5938"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="18" y="232.5879">Device</text><rect fill="#FEFECE" filter="url(#fu25wuvvfg960)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="130.8" x="320.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="114" x="328.8" y="27.5941">HTTP Adapter</text><rect fill="#FEFECE" filter="url(#fu25wuvvfg960)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="130.8" x="320.4" y="208.5938"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="114" x="328.8" y="232.5879">HTTP Adapter</text><rect fill="#FEFECE" filter="url(#fu25wuvvfg960)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="265.2" x="610.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="248.4" x="619.2" y="27.5941">AMQP 1.0 Messaging Network</text><rect fill="#FEFECE" filter="url(#fu25wuvvfg960)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="265.2" x="610.8" y="208.5938"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="248.4" x="619.2" y="232.5879">AMQP 1.0 Messaging Network</text><rect fill="#FFFFFF" filter="url(#fu25wuvvfg960)" height="69.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="382.2" y="83.3156"/><polygon fill="#A80036" points="367.8,78.5156,379.8,83.3156,367.8,88.1156,372.6,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="48.6" x2="375" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="57" y="77.2365">1.0 PUT("telemetry/TENANT/4711", data)</text><polygon fill="#A80036" points="731.4,113.475,743.4,118.275,731.4,123.075,736.2,118.275" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="394.2" x2="738.6" y1="118.275" y2="118.275"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="322.8" x="402.6" y="112.1959">1.1 transfer(device_id: "4711", body: data)</text><polygon fill="#A80036" points="61.8,148.4344,49.8,153.2344,61.8,158.0344,57,153.2344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="54.6" x2="387" y1="153.2344" y2="153.2344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="146.4" x="69" y="147.1553">1.2 202 (Accepted)</text><polygon fill="#A80036" points="401.4,183.3937,389.4,188.1938,401.4,192.9938,396.6,188.1938" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="394.2" x2="744.6" y1="188.1938" y2="188.1938"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="254.4" x="408.6" y="182.1146">2.0 disposition(state: "accepted")</text><!--
+@startuml
+scale 1.2
+
+participant Device
+participant "HTTP Adapter"
+participant "AMQP 1.0 Messaging Network"
+
+Device -> "HTTP Adapter"+: 1.0 PUT("telemetry/TENANT/4711", data)
+"HTTP Adapter" -> "AMQP 1.0 Messaging Network": 1.1 transfer(device_id: "4711", body: data)
+"HTTP Adapter" -> Device-: 1.2 202 (Accepted)
+"AMQP 1.0 Messaging Network" -> "HTTP Adapter": 2.0 disposition(state: "accepted")
+@enduml
+
+PlantUML version 1.2019.07(Mon Jun 24 19:59:20 UTC 2019)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/telemetry/forward_qos1.svg b/docs/1.2/api/telemetry/forward_qos1.svg
new file mode 100644
index 0000000..3babcfc
--- /dev/null
+++ b/docs/1.2/api/telemetry/forward_qos1.svg
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="258px" preserveAspectRatio="none" style="width:1008px;height:258px;" version="1.1" viewBox="0 0 1008 258" width="1008px" zoomAndPan="magnify"><defs><filter height="300%" id="fb5qyniwb5b5d" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#fb5qyniwb5b5d)" height="104.8781" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="501" y="83.3156"/><rect fill="#FFFFFF" filter="url(#fb5qyniwb5b5d)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="858.6" y="118.275"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="48" x2="48" y1="45.9563" y2="209.7938"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="506.4" x2="506.4" y1="45.9563" y2="209.7938"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="864" x2="864" y1="45.9563" y2="209.7938"/><rect fill="#FEFECE" filter="url(#fb5qyniwb5b5d)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="18" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#fb5qyniwb5b5d)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="9.6" y="208.5938"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="18" y="232.5879">Device</text><rect fill="#FEFECE" filter="url(#fb5qyniwb5b5d)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="130.8" x="439.2" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="114" x="447.6" y="27.5941">HTTP Adapter</text><rect fill="#FEFECE" filter="url(#fb5qyniwb5b5d)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="130.8" x="439.2" y="208.5938"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="114" x="447.6" y="232.5879">HTTP Adapter</text><rect fill="#FEFECE" filter="url(#fb5qyniwb5b5d)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="265.2" x="729.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="248.4" x="738" y="27.5941">AMQP 1.0 Messaging Network</text><rect fill="#FEFECE" filter="url(#fb5qyniwb5b5d)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="265.2" x="729.6" y="208.5938"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="248.4" x="738" y="232.5879">AMQP 1.0 Messaging Network</text><rect fill="#FFFFFF" filter="url(#fb5qyniwb5b5d)" height="104.8781" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="501" y="83.3156"/><rect fill="#FFFFFF" filter="url(#fb5qyniwb5b5d)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="858.6" y="118.275"/><polygon fill="#A80036" points="486.6,78.5156,498.6,83.3156,486.6,88.1156,491.4,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="48.6" x2="493.8" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="429.6" x="57" y="77.2365">1.0 PUT("telemetry/TENANT/4711", "QoS-Level: 1", data)</text><polygon fill="#A80036" points="844.2,113.475,856.2,118.275,844.2,123.075,849,118.275" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="513" x2="851.4" y1="118.275" y2="118.275"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="322.8" x="521.4" y="112.1959">1.1 transfer(device_id: "4711", body: data)</text><polygon fill="#A80036" points="526.2,148.4344,514.2,153.2344,526.2,158.0344,521.4,153.2344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="519" x2="863.4" y1="153.2344" y2="153.2344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="254.4" x="533.4" y="147.1553">1.2 disposition(state: "accepted")</text><polygon fill="#A80036" points="61.8,183.3937,49.8,188.1938,61.8,192.9938,57,188.1938" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="54.6" x2="505.8" y1="188.1938" y2="188.1938"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="146.4" x="69" y="182.1146">1.3 202 (Accepted)</text><!--
+@startuml
+scale 1.2
+
+participant Device
+participant "HTTP Adapter"
+participant "AMQP 1.0 Messaging Network"
+
+Device -> "HTTP Adapter"+: 1.0 PUT("telemetry/TENANT/4711", "QoS-Level: 1", data)
+"HTTP Adapter" -> "AMQP 1.0 Messaging Network"+: 1.1 transfer(device_id: "4711", body: data)
+"AMQP 1.0 Messaging Network" -> "HTTP Adapter"-: 1.2 disposition(state: "accepted")
+"HTTP Adapter" -> Device-: 1.3 202 (Accepted)
+@enduml
+
+PlantUML version 1.2019.07(Mon Jun 24 19:59:20 UTC 2019)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/telemetry/index.html b/docs/1.2/api/telemetry/index.html
new file mode 100644
index 0000000..5ce4fe7
--- /dev/null
+++ b/docs/1.2/api/telemetry/index.html
@@ -0,0 +1,2682 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Telemetry API Specification :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Telemetry API Specification :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Telemetry API Specification :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/api/telemetry//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/api/telemetry/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item active">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/api/telemetry/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/telemetry/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/api/telemetry/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/api/telemetry/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/api/telemetry/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/api/telemetry/index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/api/'>API</a> > Telemetry API Specification
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#southbound-operations">Southbound Operations</a>
+<ul>
+<li><a href="#forward-telemetry-data">Forward Telemetry Data</a></li>
+</ul></li>
+<li><a href="#northbound-operations">Northbound Operations</a>
+<ul>
+<li><a href="#receive-telemetry-data">Receive Telemetry Data</a></li>
+</ul></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Telemetry API Specification</h1>
+          
+
+        
+
+
+<p>The <em>Telemetry</em> API is used by <em>Protocol Adapters</em> to send telemetry data downstream.
+<em>Business Applications</em> and other consumers use the API to receive data published by devices belonging to a particular tenant.</p>
+
+<p>The Telemetry API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using AMQP 1.0 in order to invoke operations of the API as described in the following sections. Throughout the remainder of this page we will simply use <em>AMQP</em> when referring to AMQP 1.0.</p>
+
+<h2 id="southbound-operations">Southbound Operations</h2>
+
+<p>The following operations can be used by <em>Protocol Adapters</em> to forward telemetry data received from devices to downstream consumers like <em>Business Applications</em>.</p>
+
+<h3 id="forward-telemetry-data">Forward Telemetry Data</h3>
+
+<p><strong>Preconditions</strong></p>
+
+<ol>
+<li>Adapter has established an AMQP connection with the AMQP Messaging Network.</li>
+<li>Adapter has established an AMQP link in role <em>sender</em> with the AMQP Messaging Network using target address <code>telemetry/${tenant_id}</code> where <code>${tenant_id}</code> is the ID of the tenant that the client wants to upload telemetry data for.</li>
+<li>The device for which the adapter wants to send telemetry data has been registered (see <a href="/hono/docs/1.2/api/device-registration/">Device Registration API</a>).</li>
+</ol>
+
+<p>The adapter indicates its preferred message delivery mode by means of the <em>snd-settle-mode</em> and <em>rcv-settle-mode</em> fields of its <em>attach</em> frame during link establishment.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">snd-settle-mode</th>
+<th align="left">rcv-settle-mode</th>
+<th align="left">Delivery semantics</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>unsettled</code>, <code>mixed</code></td>
+<td align="left"><code>first</code></td>
+<td align="left">Using <code>unsettled</code> for the <em>snd-settle-mode</em> allows for adapters to implement both <em>AT LEAST ONCE</em> or <em>AT MOST ONCE</em> delivery semantics, depending on whether the adapter waits for and considers the disposition frames it receives from the AMQP Messaging Network or not. This is the recommended mode for forwarding telemetry data.</td>
+</tr>
+
+<tr>
+<td align="left"><code>settled</code></td>
+<td align="left"><code>first</code></td>
+<td align="left">Using <code>settled</code> for the <em>snd-settle-mode</em> allows for adapters to implement <em>AT MOST ONCE</em> delivery semantics only. This is the fastest mode of delivery but has the drawback of less reliable end-to-end flow control and potential loss of messages without notice.</td>
+</tr>
+</tbody>
+</table>
+
+<p>All other combinations are not supported by Hono and may result in the termination of the link or connection (depending on the configuration of the AMQP Messaging Network).</p>
+
+<p><strong>Message Flow</strong></p>
+
+<p>As indicated above, it is up to the discretion of the protocol adapter whether it wants to use <em>AT LEAST ONCE</em> or <em>AT MOST ONCE</em> delivery semantics.</p>
+
+<p>Hono&rsquo;s HTTP adapter allows devices to indicate, which delivery semantics they want to use when uploading telemetry data.
+The HTTP adapter always forwards messages unsettled and either ignores the outcome of the message transfer (<em>AT MOST ONCE</em>) or waits for the downstream peer to accept the message (<em>AT LEAST ONCE</em>) before acknowledging the reception of the message to the device.</p>
+
+<p>The following sequence diagram illustrates the flow of messages involved in the <em>HTTP Adapter</em> forwarding an <em>unsettled</em> telemetry data message to the downstream AMQP Messaging Network implementing <em>AT MOST ONCE</em> delivery semantics.</p>
+
+<figure>
+    <img src="forward_qos0.svg"/> <figcaption>
+            <h4>Forward telemetry data flow (AT MOST ONCE)</h4>
+        </figcaption>
+</figure>
+
+
+<ol>
+<li><em>Device</em> <code>4711</code> PUTs telemetry data to the <em>HTTP Adapter</em>
+
+<ol>
+<li><em>HTTP Adapter</em> transfers telemetry data to <em>AMQP 1.0 Messaging Network</em>.</li>
+<li><em>HTTP Adapter</em> acknowledges the reception of the data to the <em>Device</em>.</li>
+</ol></li>
+<li><em>AMQP 1.0 Messaging Network</em> acknowledges reception of the message which is ignored by the <em>HTTP Adapter</em>.</li>
+</ol>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Note</h4>
+    <div>In the example above the HTTP adapter does not wait for the outcome of the transfer of the message to the AMQP Messaging Network before sending back the HTTP response to the device.
+If the messaging network had sent a disposition frame with the <em>rejected</em> instead of the <em>accepted</em> outcome, the HTTP adapter would still have signaled a 202 status code back to the device. In this case the data would have been lost without the device noticing.</div>
+</div>
+
+
+<p>The following sequence diagram illustrates the flow of messages involved in the <em>HTTP Adapter</em> forwarding an <em>unsettled</em> telemetry data message to the downstream AMQP Messaging Network implementing <em>AT LEAST ONCE</em> delivery semantics.</p>
+
+<figure>
+    <img src="forward_qos1.svg"/> <figcaption>
+            <h4>Forward telemetry data flow (AT LEAST ONCE)</h4>
+        </figcaption>
+</figure>
+
+
+<ol>
+<li><em>Device</em> <code>4711</code> PUTs telemetry data to the <em>HTTP Adapter</em>, indicating <em>QoS Level</em> 1.
+
+<ol>
+<li><em>HTTP Adapter</em> transfers telemetry data to <em>AMQP 1.0 Messaging Network</em>.</li>
+<li><em>AMQP 1.0 Messaging Network</em> acknowledges reception of the message.</li>
+<li><em>HTTP Adapter</em> acknowledges the reception of the data to the <em>Device</em>.</li>
+</ol></li>
+</ol>
+
+<p>When the AMQP Messaging Network fails to settle the transfer of a telemetry message or settles the transfer with any other outcome than <code>accepted</code>, the protocol adapter MUST NOT try to re-send such rejected messages but SHOULD indicate the failed transfer to the device if the transport protocol provides means to do so.</p>
+
+<p><strong>Message Format</strong></p>
+
+<p>The following table provides an overview of the properties a client needs to set on a <em>Forward Telemetry Data</em> message.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>content-type</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>symbol</em></td>
+<td align="left">A content type indicating the type and characteristics of the data contained in the payload, e.g. <code>text/plain; charset=&quot;utf-8&quot;</code> for a text message or <code>application/json</code> etc. The value may be set to <code>application/octet-stream</code> if the message payload is to be considered <em>opaque</em> binary data.</td>
+</tr>
+
+<tr>
+<td align="left"><em>creation-time</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>timestamp</em></td>
+<td align="left">The instant in time when the message has been created (see the <a href="http://docs.oasis-open.org/amqp/core/v1.0/amqp-core-messaging-v1.0.html">AMQP 1.0 specification</a> for details). This property is mandatory if <em>ttd</em> is set, otherwise it is optional.</td>
+</tr>
+
+<tr>
+<td align="left"><em>device_id</em></td>
+<td align="center">yes</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The identifier of the device that the data in the payload is originating from.</td>
+</tr>
+
+<tr>
+<td align="left"><em>ttd</em></td>
+<td align="center">no</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>int</em></td>
+<td align="left">The <em>time &lsquo;til disconnect</em> indicates the number of seconds that the device will remain connected to the protocol adapter. The value of this property must be interpreted relative to the message&rsquo;s <em>creation-time</em>. A value of <code>-1</code> is used to indicate that the device will remain connected until further notice, i.e. until another message indicates a <em>ttd</em> value of <code>0</code>. In absence of this property, the connection status of the device is to be considered indeterminate. <em>Backend Applications</em> might use this information to determine a time window during which the device will be able to receive a command.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The body of the message MUST consist of a single AMQP <em>Data</em> section containing the telemetry data. The format and encoding of the data MUST be indicated by the <em>content-type</em> and (optional) <em>content-encoding</em> properties of the message.</p>
+
+<p>Any additional properties set by the client in either the <em>properties</em> or <em>application-properties</em> sections are preserved by Hono, i.e. these properties will also be contained in the message delivered to consumers.</p>
+
+<h2 id="northbound-operations">Northbound Operations</h2>
+
+<h3 id="receive-telemetry-data">Receive Telemetry Data</h3>
+
+<p>Hono delivers messages containing telemetry data reported by a particular device in the same order that they have been received in (using the <a href="#forward-telemetry-data">Forward Telemetry Data</a> operation). Hono MAY drop telemetry messages that it cannot deliver to any consumers. Reasons for this include that there are no consumers connected to Hono or the existing consumers are not able to process the messages from Hono fast enough.</p>
+
+<p>Hono supports multiple non-competing <em>Business Application</em> consumers of telemetry data for a given tenant. Hono allows each <em>Business Application</em> to have multiple competing consumers for telemetry data for a given tenant to share the load of processing the messages.</p>
+
+<p><strong>Preconditions</strong></p>
+
+<ol>
+<li>Client has established an AMQP connection with Hono.</li>
+<li>Client has established an AMQP link in role <em>receiver</em> with Hono using source address <code>telemetry/${tenant_id}</code> where <code>${tenant_id}</code> represents the ID of the tenant the client wants to retrieve telemetry data for.</li>
+</ol>
+
+<p>Hono supports both <em>AT MOST ONCE</em> as well as <em>AT LEAST ONCE</em> delivery of telemetry messages. However, clients SHOULD use <em>AT LEAST ONCE</em> delivery in order to support end-to-end flow control and therefore SHOULD set the <em>snd-settle-mode</em> field to <code>unsettled</code> and the <em>rcv-settle-mode</em> field to <code>first</code> in their <em>attach</em> frame during link establishment.</p>
+
+<p>A client MAY indicate to Hono during link establishment that it wants to distribute the telemetry messages received for a given tenant among multiple consumers by including a link property <code>subscription-name</code> whose value is shared by all other consumers of the tenant. Hono ensures that messages from a given device are delivered to the same consumer. Note that this also means that telemetry messages MAY not be evenly distributed among consumers, e.g. when only a single device sends data. <strong>NB</strong> This feature is not supported yet.</p>
+
+<p>In addition a client MAY include a boolean link property <code>ordering-required</code> with value <code>false</code> during link establishment in order to indicate to Hono that it does not require messages being delivered strictly in order per device but instead allows for messages being distributed evenly among the consumers. <strong>NB</strong> This feature is not supported yet.</p>
+
+<p><strong>Message Flow</strong></p>
+
+<p>The following sequence diagram illustrates the flow of messages involved in a <em>Business Application</em> receiving a telemetry data message from Hono. The delivery mode used is <em>AT LEAST ONCE</em>.</p>
+
+<figure>
+    <img src="consume.svg"/> <figcaption>
+            <h4>Receive Telemetry Data</h4>
+        </figcaption>
+</figure>
+
+
+<ol>
+<li><em>AMQP 1.0 Messaging Network</em> delivers telemetry message to <em>Business Application</em>.
+
+<ol>
+<li><em>Business Application</em> acknowledges reception of message.</li>
+</ol></li>
+</ol>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Note</h4>
+    <div>The <em>Business Application</em> can only consume telemetry messages that have been uploaded to Hono <em>after</em> the <em>Business Application</em> has established the link with the <em>AMQP 1.0 Messaging Network</em>. This is because telemetry messages are not <em>durable</em>, i.e. they are not persisted in Hono in order to be forwarded at a later time.</div>
+</div>
+
+
+<p><strong>Message Format</strong></p>
+
+<p>The format of the messages containing the telemetry data is the same as for the <a href="#forward-telemetry-data">Forward Telemetry Data operation</a>.</p>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/api/tenant/get_tenant_success.svg b/docs/1.2/api/tenant/get_tenant_success.svg
new file mode 100644
index 0000000..e6a10d4
--- /dev/null
+++ b/docs/1.2/api/tenant/get_tenant_success.svg
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="234px" preserveAspectRatio="none" style="width:717px;height:234px;" version="1.1" viewBox="0 0 717 234" width="717.6px" zoomAndPan="magnify"><defs><filter height="300%" id="f6egohjifnt9s" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f6egohjifnt9s)" height="81.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="630.6" y="83.3156"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="43.2" x2="43.2" y1="45.9563" y2="186.8344"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="636" x2="636" y1="45.9563" y2="186.8344"/><rect fill="#FEFECE" filter="url(#f6egohjifnt9s)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="27.5941">Client</text><rect fill="#FEFECE" filter="url(#f6egohjifnt9s)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="185.6344"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="209.6285">Client</text><rect fill="#FEFECE" filter="url(#f6egohjifnt9s)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="140.4" x="564" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="123.6" x="572.4" y="27.5941">Tenant Service</text><rect fill="#FEFECE" filter="url(#f6egohjifnt9s)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="140.4" x="564" y="185.6344"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="123.6" x="572.4" y="209.6285">Tenant Service</text><rect fill="#FFFFFF" filter="url(#f6egohjifnt9s)" height="81.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="630.6" y="83.3156"/><polygon fill="#A80036" points="616.2,78.5156,628.2,83.3156,616.2,88.1156,621,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="623.4" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="339.6" x="52.2" y="77.2365">transfer(subject: "get", body: search criteria)</text><path d="M566.4,98.9156 L566.4,128.9156 L702,128.9156 L702,110.9156 L690,98.9156 L566.4,98.9156 " fill="#FBFB77" filter="url(#f6egohjifnt9s)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M690,98.9156 L690,110.9156 L702,110.9156 L690,98.9156 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="110.4" x="573.6" y="119.3959">look up tenant</text><polygon fill="#A80036" points="57,160.4344,45,165.2344,57,170.0344,52.2,165.2344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="635.4" y1="165.2344" y2="165.2344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="558" x="64.2" y="159.1553">transfer(status: "200", content-type: "application/json", body: tenant info)</text><!--
+@startuml
+scale 1.2
+
+Client -> "Tenant Service"++: transfer(subject: "get", body: search criteria)
+
+note over "Tenant Service"
+look up tenant
+end note
+
+"Tenant Service" -> Client- -: transfer(status: "200", content-type: "application/json", body: tenant info)
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/api/tenant/index.html b/docs/1.2/api/tenant/index.html
new file mode 100644
index 0000000..de8eae2
--- /dev/null
+++ b/docs/1.2/api/tenant/index.html
@@ -0,0 +1,3206 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Tenant API Specification :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Tenant API Specification :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Tenant API Specification :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/api/tenant//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/api/tenant/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item active">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/api/tenant/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/tenant/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/api/tenant/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/api/tenant/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/api/tenant/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/api/tenant/index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/api/'>API</a> > Tenant API Specification
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#preconditions-for-invoking-the-tenant-api">Preconditions for invoking the Tenant API</a></li>
+<li><a href="#get-tenant-information">Get Tenant Information</a></li>
+<li><a href="#tenant-information-format">Tenant Information Format</a>
+<ul>
+<li><a href="#tracing-format">Tracing Format</a></li>
+<li><a href="#trusted-ca-format">Trusted CA Format</a></li>
+<li><a href="#adapter-configuration-format">Adapter Configuration Format</a></li>
+<li><a href="#resource-limits-configuration-format">Resource Limits Configuration Format</a></li>
+<li><a href="#connection-duration-configuration-format">Connection Duration Configuration Format</a></li>
+<li><a href="#data-volume-configuration-format">Data Volume Configuration Format</a></li>
+<li><a href="#resource-limits-period-configuration-format">Resource Limits Period Configuration Format</a></li>
+</ul></li>
+<li><a href="#delivery-states-used-by-the-tenant-api">Delivery States used by the Tenant API</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Tenant API Specification</h1>
+          
+
+        
+
+
+<p>The <em>Tenant API</em> is used by Hono&rsquo;s protocol adapters to retrieve information that affects all devices belonging to a particular tenant.
+A tenant is a logical entity, which groups together a set of devices. The information registered for a tenant is used for example to
+determine if devices belonging to the tenant are allowed to connect to a certain protocol adapter or if devices are required to authenticate.</p>
+
+<p>This document <em>describes</em> the Tenant API&rsquo;s operations and the payload data format used by them.
+Please refer to <a href="/hono/docs/1.2/concepts/tenancy/">Multi Tenancy</a> for details regarding the way Hono supports multiple tenants.</p>
+
+<p>The Tenant API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using an AMQP 1.0 client in order to invoke operations of the API as described in the following sections.</p>
+
+<p><a name="preconditions"></a></p>
+
+<h2 id="preconditions-for-invoking-the-tenant-api">Preconditions for invoking the Tenant API</h2>
+
+<ol>
+<li>Client has established an AMQP connection with the Tenant service.</li>
+<li>Client has established an AMQP link in role <em>sender</em> on the connection using target address <code>tenant</code>. This link is used by the client to send request messages to the Tenant service.</li>
+<li>Client has established an AMQP link in role <em>receiver</em> on the connection using source address <code>tenant/${reply-to}</code> where <em>reply-to</em> may be any arbitrary string chosen by the client. This link is used by the client to receive responses to the requests it has sent to the Tenant service. This link&rsquo;s source address is also referred to as the <em>reply-to</em> address for the request messages.</li>
+</ol>
+
+<figure>
+    <img src="preconditions.svg"
+         alt="A client establishes an AMQP connection and the links required to invoke operations of the Tenant service"/> <figcaption>
+            <h4>Client connecting to Tenant service</h4>
+        </figcaption>
+</figure>
+
+
+<h2 id="get-tenant-information">Get Tenant Information</h2>
+
+<p>Clients use this operation to <em>retrieve</em> information about a tenant.</p>
+
+<p><strong>Message Flow</strong></p>
+
+<p>The following sequence diagram illustrates the flow of messages involved in a <em>Client</em> retrieving tenant information.</p>
+
+<figure>
+    <img src="get_tenant_success.svg"
+         alt="A client sends a request message for retrieving tenant information and receives a response containing the information"/> <figcaption>
+            <h4>Client retrieving tenant information</h4>
+        </figcaption>
+</figure>
+
+
+<p><strong>Request Message Format</strong></p>
+
+<p>The following table provides an overview of the properties a client needs to set on a message to get tenant information:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">AMQP Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>correlation-id</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>message-id</em></td>
+<td align="left">MAY contain an ID used to correlate a response message to the original request. If set, it is used as the <em>correlation-id</em> property in the response, otherwise the value of the <em>message-id</em> property is used. Either this or the <em>message-id</em> property MUST be set.</td>
+</tr>
+
+<tr>
+<td align="left"><em>message-id</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MAY contain an identifier that uniquely identifies the message at the sender side. Either this or the <em>correlation-id</em> property MUST be set.</td>
+</tr>
+
+<tr>
+<td align="left"><em>reply-to</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST contain the source address that the client wants to receive response messages from. This address MUST be the same as the source address used for establishing the client&rsquo;s receive link (see <a href="#preconditions-for-invoking-the-tenant-api">Preconditions</a>).</td>
+</tr>
+
+<tr>
+<td align="left"><em>subject</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST be set to <code>get</code>.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The body of the request message MUST consist of a single <em>Data</em> section containing a UTF-8 encoded string representation of a single JSON object.</p>
+
+<p>The JSON object MUST contain <em>exactly one</em> of the following search criteria properties:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">JSON Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>subject-dn</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The subject DN of the trusted certificate authority&rsquo;s public key in the format defined by <a href="https://www.ietf.org/rfc/rfc2253.txt">RFC 2253</a>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>tenant-id</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The identifier of the tenant to get.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The following request payload may be used to look up the tenant with identifier <code>ACME Corporation</code>:</p>
+
+<pre><code class="language-json">{
+  &quot;tenant-id&quot;: &quot;ACME Corporation&quot;
+}
+</code></pre>
+
+<p>The following request payload may be used to look up the tenant for which a trusted certificate authority with subject DN <code>O=ACME Corporation, CN=devices</code> has been configured:</p>
+
+<pre><code class="language-json">{
+  &quot;subject-dn&quot;: &quot;CN=devices,O=ACME Corporation&quot;
+}
+</code></pre>
+
+<p><strong>Response Message Format</strong></p>
+
+<p>The following table provides an overview of the properties contained in a response message to a <em>get tenant information</em> request:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">AMQP Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>correlation-id</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>message-id</em></td>
+<td align="left">Contains the <em>message-id</em> (or the <em>correlation-id</em>, if specified) of the request message that this message is the response to.</td>
+</tr>
+
+<tr>
+<td align="left"><em>content-type</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST be set to <code>application/json</code> if the invocation of the operation was successful and the body of the response message contains payload as described below.</td>
+</tr>
+
+<tr>
+<td align="left"><em>status</em></td>
+<td align="center">yes</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>int</em></td>
+<td align="left">Contains the status code indicating the outcome of the operation. Concrete values and their semantics are defined for each particular operation.</td>
+</tr>
+
+<tr>
+<td align="left"><em>cache_control</em></td>
+<td align="center">no</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">Contains an <a href="https://tools.ietf.org/html/rfc2616#section-14.9">RFC 2616</a> compliant <em>cache directive</em>. The directive contained in the property MUST be obeyed by clients that are caching responses.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The response message&rsquo;s <em>status</em> property may contain the following codes:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Code</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>200</em></td>
+<td align="left">OK, The response message body contains the requested tenant information.</td>
+</tr>
+
+<tr>
+<td align="left"><em>400</em></td>
+<td align="left">Bad Request, the request message did not contain all mandatory properties.</td>
+</tr>
+
+<tr>
+<td align="left"><em>403</em></td>
+<td align="left">Forbidden, the client is not authorized to retrieve information for the given tenant.</td>
+</tr>
+
+<tr>
+<td align="left"><em>404</em></td>
+<td align="left">Not Found, there is no tenant matching the given search criteria.</td>
+</tr>
+</tbody>
+</table>
+
+<p>For status codes indicating an error (codes in the <code>400 - 499</code> range) the message body MAY contain a detailed description of the error that occurred. In this case, the response message&rsquo;s <em>content-type</em> property SHOULD be set accordingly.</p>
+
+<p>Otherwise the response message contains the information for the requested tenant as described in the following sections.</p>
+
+<p><a name="payload-format"></a></p>
+
+<h2 id="tenant-information-format">Tenant Information Format</h2>
+
+<p>Tenant information is carried in a single <em>Data</em> section of the response message as a UTF-8 encoded string representation of a single JSON object.
+It is an error to include payload that is not of this type.</p>
+
+<p>The table below provides an overview of the standard members defined for the JSON response object:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">JSON Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>adapters</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>array</em></td>
+<td align="left">A list of configuration options valid for certain adapters only. The format of a configuration option is described here <a href="#adapter-configuration-format">Adapter Configuration Format</a>. <strong>NB</strong> If the element is provided then the list MUST NOT be empty. <strong>NB</strong> Only a single entry per <em>type</em> is allowed. If multiple entries for the same <em>type</em> are present it is handled as an error. <strong>NB</strong> If the element is omitted then all adapters are <em>enabled</em> in their default configuration.</td>
+</tr>
+
+<tr>
+<td align="left"><em>defaults</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>object</em></td>
+<td align="left">Arbitrary <em>default</em> properties for devices belonging to the tenant. The properties can be used by protocol adapters to augment downstream messages with missing information, e.g. setting a default content type or time-to-live.</td>
+</tr>
+
+<tr>
+<td align="left"><em>enabled</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>boolean</em></td>
+<td align="left">If set to <code>false</code> the tenant is currently disabled. Protocol adapters MUST NOT allow devices of a disabled tenant to connect and MUST NOT accept data published by such devices.</td>
+</tr>
+
+<tr>
+<td align="left"><em>minimum-message-size</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>number</em></td>
+<td align="left">The minimum message size in bytes. If it is set then the payload size of the telemetry, event and command messages are calculated in accordance with the configured value and then reported to the metrics. See <a href="/hono/docs/1.2/api/metrics/#minimum-message-size">Metrics</a> for more details.</td>
+</tr>
+
+<tr>
+<td align="left"><em>resource-limits</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>object</em></td>
+<td align="left">Any resource limits that should be enforced for the tenant, e.g. the maximum number of concurrent connections and the maximum data volume for a given period. Refer to <a href="#resource-limits-configuration-format">Resource Limits Configuration Format</a> for details.</td>
+</tr>
+
+<tr>
+<td align="left"><em>tenant-id</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The ID of the tenant.</td>
+</tr>
+
+<tr>
+<td align="left"><em>tracing</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>object</em></td>
+<td align="left">A set of options regarding the tracing of messages for the tenant. See <a href="#tracing-format">Tracing Format</a> for a definition of the content model of the object.</td>
+</tr>
+
+<tr>
+<td align="left"><em>trusted-ca</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>array</em></td>
+<td align="left">The list of trusted certificate authorities to use for validating certificates presented by devices of the tenant for authentication purposes. See <a href="#trusted-ca-format">Trusted Certificate Authority Format</a> for a definition of the content model of the objects contained in the array. <strong>NB</strong> If the element is provided then the list MUST NOT be empty.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The JSON object MAY contain an arbitrary number of additional members with arbitrary names which can be of a scalar or a complex type.
+This allows for future <em>well-known</em> additions and also allows to add further information which might be relevant to a <em>custom</em> adapter only.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>The JSON structure below contains example information for tenant <code>TEST_TENANT</code>. Note that the structure contains some custom properties at both the root level (<em>customer</em>) as well as the adapter configuration level (<em>deployment</em>) and also defines a default TTL for downstream messages.</p>
+
+<pre><code class="language-json">{
+  &quot;tenant-id&quot;: &quot;TEST_TENANT&quot;,
+  &quot;defaults&quot;: {
+    &quot;ttl&quot;: 30
+  },
+  &quot;enabled&quot;: true,
+  &quot;customer&quot;: &quot;ACME Inc.&quot;,
+  &quot;resource-limits&quot;: {
+    &quot;max-connections&quot;: 100000,
+    &quot;data-volume&quot;: {
+      &quot;max-bytes&quot;: 2147483648,
+      &quot;period&quot;: {
+        &quot;mode&quot;: &quot;days&quot;,
+        &quot;no-of-days&quot;: 30
+      },
+      &quot;effective-since&quot;: &quot;2019-07-27T14:30:00Z&quot;
+    }
+  },
+  &quot;adapters&quot;: [
+    {
+      &quot;type&quot;: &quot;hono-mqtt&quot;,
+      &quot;enabled&quot;: true,
+      &quot;device-authentication-required&quot;: true
+    }, {
+      &quot;type&quot;: &quot;hono-http&quot;,
+      &quot;enabled&quot;: true,
+      &quot;device-authentication-required&quot;: true,
+      &quot;deployment&quot;: {
+        &quot;maxInstances&quot;: 4
+      }
+    }
+  ]
+}
+</code></pre>
+
+<h3 id="tracing-format">Tracing Format</h3>
+
+<p>The table below provides an overview of the members defined for the <em>tracing</em> JSON object:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Type</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>sampling-mode</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>string</em></td>
+<td align="left"><code>default</code></td>
+<td align="left">Defines in how far OpenTracing spans created when processing messages for this tenant shall be recorded (sampled) by the tracing system. The value <code>default</code> lets the default sampling mechanism be used. The value <code>all</code> marks the spans related to this tenant so that they should all be sampled. The value <code>none</code> marks the spans as not to be sampled. The mode defined here may be overridden for a particular auth-id by means of the <code>sampling-mode-per-auth-id</code> property.</td>
+</tr>
+
+<tr>
+<td align="left"><em>sampling-mode-per-auth-id</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>object</em></td>
+<td align="left"></td>
+<td align="left">Defines in how far OpenTracing spans created when processing messages for this tenant and a particular auth-id shall be recorded (sampled) by the tracing system. The child properties have the auth-id as name. A child property value of <code>default</code> lets the default sampling mechanism be used. The child property value <code>all</code> marks the spans related to this tenant and the auth-id so that they should all be sampled. The child property value <code>none</code> marks the spans as not to be sampled. The mode defined for a particular auth-id has precedence over the value defined by the <code>sampling-mode</code> property.</td>
+</tr>
+</tbody>
+</table>
+
+<h3 id="trusted-ca-format">Trusted CA Format</h3>
+
+<p>The table below provides an overview of the members of a JSON object representing a trusted CA:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Type</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>subject-dn</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left"><code>-</code></td>
+<td align="left">The subject DN of the trusted root certificate in the format defined by <a href="https://www.ietf.org/rfc/rfc2253.txt">RFC 2253</a>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>public-key</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left"><code>-</code></td>
+<td align="left">The Base64 encoded binary DER encoding of the trusted root certificate&rsquo;s public key.</td>
+</tr>
+
+<tr>
+<td align="left"><em>algorithm</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>string</em></td>
+<td align="left"><code>RSA</code></td>
+<td align="left">The name of the public key algorithm. Supported values are <code>RSA</code> and <code>EC</code>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>auto-provisioning-enabled</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>boolean</em></td>
+<td align="left"><code>false</code></td>
+<td align="left">If set to <code>true</code>, protocol adapters MAY request auto-provisioning of devices that authenticate with a client certificate issued by this CA. Otherwise, protocol adapters MUST NOT request auto-provisioning.</td>
+</tr>
+</tbody>
+</table>
+
+<p><strong>NB</strong> CAs of the <em>same</em> tenant MAY share the same subject DN, e.g. allowing for the definition of overlapping validity periods.
+However, CAs of <em>different</em> tenants MUST NOT share the same subject DN in order to allow for the unique look-up of a tenant by
+the subject DN of one of its trusted CAs.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Below is an example payload for a response to a <em>get</em> request for tenant <code>TEST_TENANT</code>.
+The tenant is configured with two trusted certificate authorities, each using a different public key algorithm.
+Only one of them is configured to be used for auto-provisioning.</p>
+
+<pre><code class="language-json">{
+  &quot;tenant-id&quot; : &quot;TEST_TENANT&quot;,
+  &quot;enabled&quot; : true,
+  &quot;trusted-ca&quot;: [{
+    &quot;subject-dn&quot;: &quot;CN=ca,OU=Hono,O=Eclipse&quot;,
+    &quot;public-key&quot;: &quot;PublicKey==&quot;,
+    &quot;auto-provisioning-enabled&quot;: false,
+    &quot;algorithm&quot;:  &quot;RSA&quot;
+  }, {
+    &quot;subject-dn&quot;: &quot;CN=ca,OU=Hono,O=ACME Inc.&quot;,
+    &quot;public-key&quot;: &quot;ECKey==&quot;,
+    &quot;auto-provisioning-enabled&quot;: true,
+    &quot;algorithm&quot;:  &quot;EC&quot;
+  }]
+}
+</code></pre>
+
+<h3 id="adapter-configuration-format">Adapter Configuration Format</h3>
+
+<p>The table below contains the properties which are used to configure a <em>Hono protocol adapter</em>:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">JSON Type</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>type</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left"><code>-</code></td>
+<td align="left">The type of the adapter which this configuration belongs to.</td>
+</tr>
+
+<tr>
+<td align="left"><em>enabled</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>boolean</em></td>
+<td align="left"><code>false</code></td>
+<td align="left">If set to false the tenant is not allowed to receive / send data utilizing the given adapter.</td>
+</tr>
+
+<tr>
+<td align="left"><em>device-authentication-required</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>boolean</em></td>
+<td align="left"><code>true</code></td>
+<td align="left">If set to false, devices are not required to authenticate with the adapter before sending / receiving data.</td>
+</tr>
+</tbody>
+</table>
+
+<p>Protocol adapters SHOULD use the configuration properties set for a tenant when interacting with devices of that tenant, e.g. in order to make authorization decisions etc.</p>
+
+<p>The JSON object MAY contain an arbitrary number of additional members with arbitrary names of either scalar or complex type.
+This allows for future <em>well-known</em> additions and also allows to add further information which might be relevant to a <em>custom</em> adapter only.</p>
+
+<h3 id="resource-limits-configuration-format">Resource Limits Configuration Format</h3>
+
+<p>The table below contains the properties which are used to configure a tenant&rsquo;s resource limits:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">JSON Type</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>max-connections</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>number</em></td>
+<td align="left"><code>-1</code></td>
+<td align="left">The maximum number of concurrent connections allowed from devices of this tenant. The default value <code>-1</code> indicates that no limit is set.</td>
+</tr>
+
+<tr>
+<td align="left"><em>max-ttl</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>number</em></td>
+<td align="left"><code>-1</code></td>
+<td align="left">The maximum time-to-live (in seconds) to use for events published by devices of this tenant. Any default TTL value specified at either the tenant or device level will be limited to the max value specified here. If this property is set to a value greater than <code>-1</code> and no default TTL is specified for a device, the max value will be used for events published by the device. A value of <code>-1</code> (the default) indicates that no limit is set. <strong>Note</strong> that this property contains the TTL in <em>seconds</em> whereas the AMQP 1.0 specification defines a message&rsquo;s <em>ttl</em> header to use milliseconds.</td>
+</tr>
+
+<tr>
+<td align="left"><em>connection-duration</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>object</em></td>
+<td align="left"><code>-</code></td>
+<td align="left">The maximum connection duration allowed for the given tenant. Refer to  <a href="#connection-duration-configuration-format">Connection Duration Configuration Format</a> for details.</td>
+</tr>
+
+<tr>
+<td align="left"><em>data-volume</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>object</em></td>
+<td align="left"><code>-</code></td>
+<td align="left">The maximum data volume allowed for the given tenant. Refer to  <a href="#data-volume-configuration-format">Data Volume Configuration Format</a> for details.</td>
+</tr>
+</tbody>
+</table>
+
+<p>Protocol adapters SHOULD use the <em>max-connections</em> property to determine if a device&rsquo;s connection request should be accepted or rejected.</p>
+
+<p>Protocol adapters SHOULD use the <em>max-ttl</em> property to determine the <em>effective time-to-live</em> for events published by devices as follows:</p>
+
+<ol>
+<li>If a non-default <em>max-ttl</em> is set for the tenant, use that value as the <em>effective ttl</em>, otherwise set <em>effective ttl</em> to <code>-1</code>.</li>
+<li>If the event published by the device
+
+<ol>
+<li>contains a <em>ttl</em> header and <em>effective ttl</em> is not <code>-1</code> and the <em>ttl</em> value (in seconds) provided by the device is smaller than the
+<em>effective ttl</em>, use the device provided <em>ttl</em> value as the new <em>effective ttl</em>.</li>
+<li>does not contain a <em>ttl</em> header but a default <em>ttl</em> value is configured for the device (with the device level taking precedence
+over the tenant level) and <em>effective ttl</em> is not <code>-1</code> and the default value is smaller than the <em>effective ttl</em>,
+use the default <em>ttl</em> value as the new <em>effective ttl</em>.</li>
+</ol></li>
+<li>If <em>effective ttl</em> is not <code>-1</code>, set the downstream event message&rsquo;s <em>ttl</em> header to its value (in milliseconds).</li>
+</ol>
+
+<p>The JSON object MAY contain an arbitrary number of additional members with arbitrary names of either scalar or complex type.
+This allows for future <em>well-known</em> additions and also allows to add further information which might be relevant to a <em>custom</em> adapter only.</p>
+
+<h3 id="connection-duration-configuration-format">Connection Duration Configuration Format</h3>
+
+<p>The table below contains the properties which are used to configure a tenant&rsquo;s connection duration limit:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">JSON Type</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>effective-since</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left"><code>-</code></td>
+<td align="left">The point in time at which the current settings became effective, i.e. the start of the first accounting period based on these settings. The value MUST be an <a href="https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations">ISO 8601 compliant <em>combined date and time representation in extended format</em></a>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>max-minutes</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>number</em></td>
+<td align="left"><code>-1</code></td>
+<td align="left">The maximum connection duration in minutes allowed for the tenant for each accounting period. MUST be an integer. Minus one indicates that no limit is set.</td>
+</tr>
+
+<tr>
+<td align="left"><em>period</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>object</em></td>
+<td align="left"><code>-</code></td>
+<td align="left">The mode and length of an accounting period, i.e. the resource usage is calculated based on the defined number of days or on a monthly basis. For more information, please refer to the <a href="#resource-limits-period-configuration-format">resource limits period</a>.</td>
+</tr>
+</tbody>
+</table>
+
+<p>Protocol adapters that maintain <em>connection state</em> SHOULD use this information to determine if a connection request from a device should be accepted or not. For more information, please refer to the <a href="/hono/docs/1.2/concepts/resource-limits/#connection-duration-limit">connection duration limit concept</a>.</p>
+
+<h3 id="data-volume-configuration-format">Data Volume Configuration Format</h3>
+
+<p>The table below contains the properties which are used to configure a tenant&rsquo;s data volume limit:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">JSON Type</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>effective-since</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left"><code>-</code></td>
+<td align="left">The point in time at which the current settings became effective, i.e. the start of the first accounting period based on these settings. The value MUST be an <a href="https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations">ISO 8601 compliant <em>combined date and time representation in extended format</em></a>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>max-bytes</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>number</em></td>
+<td align="left"><code>-1</code></td>
+<td align="left">The maximum number of bytes allowed for the tenant for each accounting period. MUST be an integer. A negative value indicates that no limit is set.</td>
+</tr>
+
+<tr>
+<td align="left"><em>period</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>object</em></td>
+<td align="left"><code>-</code></td>
+<td align="left">The mode and length of an accounting period, i.e. the data usage can limited based on the defined number of days or on a monthly basis. For more information, please refer to the <a href="#resource-limits-period-configuration-format">resource limits period</a>.</td>
+</tr>
+</tbody>
+</table>
+
+<p>Protocol adapters SHOULD use this information to determine if a message originating from or destined to a device should be accepted for processing.</p>
+
+<h3 id="resource-limits-period-configuration-format">Resource Limits Period Configuration Format</h3>
+
+<p>The table below contains the properties that are used to configure a tenant&rsquo;s resource limits period:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">JSON Type</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>mode</em></td>
+<td align="center"><em>yes</em></td>
+<td align="left"><em>string</em></td>
+<td align="left"><code>-</code></td>
+<td align="left">The mode of the resource usage calculation. The default implementation supports two modes namely <code>days</code> and <code>monthly</code>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>no-of-days</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>number</em></td>
+<td align="left"><code>-</code></td>
+<td align="left">When the mode is set as <code>days</code>, then this value represents the length of an accounting period , i.e. the number of days over which the resource usage is to be limited. MUST be a positive integer.</td>
+</tr>
+</tbody>
+</table>
+
+<h2 id="delivery-states-used-by-the-tenant-api">Delivery States used by the Tenant API</h2>
+
+<p>A Tenant service implementation uses the following AMQP message delivery states when receiving request messages from clients:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Delivery State</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>ACCEPTED</em></td>
+<td align="left">Indicates that the request message has been received and accepted for processing.</td>
+</tr>
+
+<tr>
+<td align="left"><em>REJECTED</em></td>
+<td align="left">Indicates that the request message has been received but cannot be processed. The disposition frame&rsquo;s <em>error</em> field contains information regarding the reason why. Clients should not try to re-send the request using the same message properties and payload in this case.</td>
+</tr>
+</tbody>
+</table>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/api/tenant/preconditions.svg b/docs/1.2/api/tenant/preconditions.svg
new file mode 100644
index 0000000..fc6d204
--- /dev/null
+++ b/docs/1.2/api/tenant/preconditions.svg
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="327.6px" preserveAspectRatio="none" style="width:469px;height:327px;" version="1.1" viewBox="0 0 469 327" width="469.2px" zoomAndPan="magnify"><defs><filter height="300%" id="f1cquhxl7jrac4" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f1cquhxl7jrac4)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="382.2" y="83.3156"/><rect fill="#FFFFFF" filter="url(#f1cquhxl7jrac4)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="382.2" y="153.2344"/><rect fill="#FFFFFF" filter="url(#f1cquhxl7jrac4)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="382.2" y="223.1531"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="43.2" x2="43.2" y1="45.9563" y2="279.7125"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="387.6" x2="387.6" y1="45.9563" y2="279.7125"/><rect fill="#FEFECE" filter="url(#f1cquhxl7jrac4)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="27.5941">Client</text><rect fill="#FEFECE" filter="url(#f1cquhxl7jrac4)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="278.5125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="302.5066">Client</text><rect fill="#FEFECE" filter="url(#f1cquhxl7jrac4)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="140.4" x="315.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="123.6" x="324" y="27.5941">Tenant Service</text><rect fill="#FEFECE" filter="url(#f1cquhxl7jrac4)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="140.4" x="315.6" y="278.5125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="123.6" x="324" y="302.5066">Tenant Service</text><rect fill="#FFFFFF" filter="url(#f1cquhxl7jrac4)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="382.2" y="83.3156"/><rect fill="#FFFFFF" filter="url(#f1cquhxl7jrac4)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="382.2" y="153.2344"/><rect fill="#FFFFFF" filter="url(#f1cquhxl7jrac4)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="382.2" y="223.1531"/><polygon fill="#A80036" points="367.8,78.5156,379.8,83.3156,367.8,88.1156,372.6,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="375" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="52.2" y="77.2365">1.1 open</text><polygon fill="#A80036" points="57,113.475,45,118.275,57,123.075,52.2,118.275" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="387" y1="118.275" y2="118.275"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="64.2" y="112.1959">1.2 open</text><polygon fill="#A80036" points="367.8,148.4344,379.8,153.2344,367.8,158.0344,372.6,153.2344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="375" y1="153.2344" y2="153.2344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="214.8" x="52.2" y="147.1553">2.1 attach(sender, "tenant")</text><polygon fill="#A80036" points="57,183.3937,45,188.1938,57,192.9938,52.2,188.1938" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="387" y1="188.1938" y2="188.1938"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="223.2" x="64.2" y="182.1146">2.2 attach(receiver, "tenant")</text><polygon fill="#A80036" points="367.8,218.3531,379.8,223.1531,367.8,227.9531,372.6,223.1531" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="375" y1="223.1531" y2="223.1531"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="315.6" x="52.2" y="217.074">3.1 attach(receiver, "tenant/${reply-to}")</text><polygon fill="#A80036" points="57,253.3125,45,258.1125,57,262.9125,52.2,258.1125" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="387" y1="258.1125" y2="258.1125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="307.2" x="64.2" y="252.0334">3.2 attach(sender, "tenant/${reply-to}")</text><!--
+@startuml
+scale 1.2
+
+Client -> "Tenant Service"++: 1.1 open
+"Tenant Service"-> Client- -: 1.2 open
+
+Client -> "Tenant Service"++: 2.1 attach(sender, "tenant")
+"Tenant Service" -> Client- -: 2.2 attach(receiver, "tenant")
+
+Client -> "Tenant Service"++: 3.1 attach(receiver, "tenant/${reply-to}")
+"Tenant Service" -> Client- -: 3.2 attach(sender, "tenant/${reply-to}")
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/architecture/auth/Hono-Auth-Overview-Today.jpg b/docs/1.2/architecture/auth/Hono-Auth-Overview-Today.jpg
new file mode 100644
index 0000000..e6dd75f
--- /dev/null
+++ b/docs/1.2/architecture/auth/Hono-Auth-Overview-Today.jpg
Binary files differ
diff --git a/docs/1.2/architecture/auth/MQTT-Adapter-authentication-today.png b/docs/1.2/architecture/auth/MQTT-Adapter-authentication-today.png
new file mode 100644
index 0000000..f8225e1
--- /dev/null
+++ b/docs/1.2/architecture/auth/MQTT-Adapter-authentication-today.png
Binary files differ
diff --git a/docs/1.2/architecture/auth/index.html b/docs/1.2/architecture/auth/index.html
new file mode 100644
index 0000000..1652328
--- /dev/null
+++ b/docs/1.2/architecture/auth/index.html
@@ -0,0 +1,2533 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Authentication/Authorization :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Authentication/Authorization :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Authentication/Authorization :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/architecture/auth//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/architecture/auth/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item active">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/architecture/auth/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/architecture/auth/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/architecture/auth/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/architecture/auth/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/architecture/auth/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/architecture/auth/index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/architecture/'>Architecture</a> > Authentication/Authorization
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#requirements">Requirements</a></li>
+<li><a href="#how-it-works-today">How it works today</a>
+<ul>
+<li><a href="#device-auth">Device Auth</a></li>
+<li><a href="#system-component-auth">System Component Auth</a></li>
+<li><a href="#application-auth">Application Auth</a></li>
+<li><a href="#management-of-identities-and-authorities">Management of Identities and Authorities</a></li>
+</ul></li>
+<li><a href="#future-approach">Future Approach</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Authentication/Authorization</h1>
+          
+
+        
+
+
+<p>This page describes how authentication and authorization of devices, consumers (back end applications) and system components works in Hono.</p>
+
+<h2 id="requirements">Requirements</h2>
+
+<ol>
+<li>Devices are authenticated and authorized when they connect to a protocol adapter.</li>
+<li>Consumers are authenticated and authorized when they connect to a <em>Dispatch Router</em> instance.</li>
+<li>System components are authenticated and authorized when they connect to each other.</li>
+<li>Credentials and authorization rules can be managed centrally, i.e. credentials and rules do not need to be configured manually on each component.</li>
+</ol>
+
+<h2 id="how-it-works-today">How it works today</h2>
+
+<p>The following diagram provides an overview of the components involved in use cases requiring authentication and authorization.</p>
+
+<figure>
+    <img src="Hono-Auth-Overview-Today.jpg"/> 
+</figure>
+
+
+<h3 id="device-auth">Device Auth</h3>
+
+<p>Both the HTTP adapter as well as the MQTT adapter require devices to authenticate during connection establishment by default. Both rely on the <a href="/hono/docs/1.2/api/credentials/">Credentials API</a> to help in verifying credentials provided by a device. Please refer to <a href="/hono/docs/1.2/concepts/device-identity/">Device Authentication</a> for a general overview of Hono&rsquo;s approach to authenticating devices and to the <a href="/hono/docs/1.2/user-guide/">protocol adapter user guides</a> for specifics regarding how devices can authenticate to the corresponding protocol adapters.</p>
+
+<h3 id="system-component-auth">System Component Auth</h3>
+
+<p>Client components opening an AMQP connection to a server component are authenticated using SASL PLAIN as specified in <a href="https://tools.ietf.org/html/rfc4422">RFC 4422</a>. The server component takes the authentication information provided by the client component and opens a connection to the <em>Auth Server</em>, using the credentials provided by the client in its SASL PLAIN exchange with the server component. On successful authentication the <em>Auth Server</em> issues a JSON Web Token (JWT) asserting the client&rsquo;s identity and its granted authorities to the server component. The server component then <em>attaches</em> this token to its AMQP connection with the client and from then on uses it to make authorization decisions regarding the client&rsquo;s requests. See <a href="/hono/docs/1.2/api/authentication/">Authentication API</a> for details regarding the authentication process and the format of the tokens issued by the <em>Auth Server</em>.</p>
+
+<p>Based on the components shown above, the following sequence diagram shows how the <em>MQTT Adapter</em> connects to the <em>Device Registry</em> and gets authenticated transparently using the <em>Auth Server</em>.</p>
+
+<figure>
+    <img src="MQTT-Adapter-authentication-today.png" width="80%"/> 
+</figure>
+
+
+<p>Client components are authorized whenever they open a new AMQP link on an existing connection to the server. When a client tries to open a receiver link, the server checks if the client is authorized to <em>read</em> from the source address the client has specified in its AMQP <em>attach</em> frame. Analogously, when a client tries to open a sender link, the server checks if the client is authorized to <em>write</em> to the target address from the client&rsquo;s <em>attach</em> frame.</p>
+
+<p>Service implementations may additionally authorize individual (request) messages received from the client, e.g. based on the message&rsquo;s <em>subject</em> property which is used by Hono&rsquo;s AMQP 1.0 based APIs to indicate the operation to invoke. In such a case the server checks if the client is authorized to <em>execute</em> the operation indicated by the message <em>subject</em> on the link&rsquo;s target address.</p>
+
+<h3 id="application-auth">Application Auth</h3>
+
+<p><em>Business Applications</em> connect to the AMQP 1.0 Messaging Network in order to consume telemetry data and events and send commands to devices. It is therefore the responsibility of the AMQP Network to properly authenticate and authorize the application.</p>
+
+<p>The Apache Qpid Dispatch Router which is used in Hono&rsquo;s example deployment can be configured to authenticate consumers using arbitrary SASL mechanisms. Access to addresses for receiving messages can be restricted to certain identities. The Dispatch Router instance which is used in the example deployment is configured to delegate authentication of clients to the <em>Auth Server</em> by means of its <em>Auth Service Plugin</em> mechanism. This mechanism works in a very similar way as described above for the authentication of system components. The main difference is that the clients&rsquo; authorities are not transferred by means of a JSON Web Token but instead are carried in a property of the Auth Server&rsquo;s AMQP <em>open</em> frame.</p>
+
+<h3 id="management-of-identities-and-authorities">Management of Identities and Authorities</h3>
+
+<p>The identities and corresponding authorities that the <em>Auth Server</em> uses for verifying credentials and issuing tokens are defined in a configuration file (<code>services/auth/src/main/resources/permissions.json</code>) read in during start-up of the <em>Auth Server</em>. These authorities are used for authenticating and authorizing system components as well as <em>Business Applications</em>.</p>
+
+<p>Please refer to the <a href="http://qpid.apache.org/components/dispatch-router/index.html">Dispatch Router documentation</a> for details regarding configuration of <em>Dispatch Router</em> security.</p>
+
+<h2 id="future-approach">Future Approach</h2>
+
+<p>In the long run Hono will still use tokens for authenticating clients but will use a policy based approach for authorizing requests, i.e. authorization decisions will be made by a central <em>policy enforcement</em> component. Hono services will pass in the client&rsquo;s token, the resource being accessed and the intended action along with potentially other attributes to the policy enforcement component which will then make the authorization decision based on the configured rules (policy) and return the outcome to the component.</p>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/architecture/component-view/device-registry.png b/docs/1.2/architecture/component-view/device-registry.png
new file mode 100644
index 0000000..5b0550b
--- /dev/null
+++ b/docs/1.2/architecture/component-view/device-registry.png
Binary files differ
diff --git a/docs/1.2/architecture/component-view/device-registry.xml b/docs/1.2/architecture/component-view/device-registry.xml
new file mode 100644
index 0000000..9ca9ae1
--- /dev/null
+++ b/docs/1.2/architecture/component-view/device-registry.xml
@@ -0,0 +1 @@
+<mxfile host="www.draw.io" modified="2019-10-16T11:12:33.889Z" agent="Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:69.0) Gecko/20100101 Firefox/69.0" version="12.1.1" etag="SCVMVU0YPNX_xoPjp2d9" type="device" pages="1"><diagram id="335c56a3-2b2a-8ff2-00d6-b683b72057d3" name="Page-1">7Vxbc5s4FP41fkyHO+YxdpK2M9uZTLMz2z7tYKPY2mJEBE7s/vqVQDISkm1iCztJnRfDEQh0vu9cdCQycMeL1Wcc5/NvKAHpwLGS1cC9GTiOHXgB+aGSNZNYXlhLZhgmTNYIHuBvwC9k0iVMQCFdWCKUljCXhVOUZWBaSrIYY/QiX/aIUvmpeTwDiuBhGqeq9B+YlHMmtYOoafgC4GzOHj102Pgm8fTXDKNlxp43cNzH6q9uXsS8LzbQYh4n6EUQubcDd4wRKuujxWoMUqpcrrb6vrstrZv3xiAru9zg1Dc8x+kS8Deu3qtcc11UowH0envgjl7msAQPeTylrS8EfiKbl4uUNecAwwUoAaaXwGxGxC4RFyVGv8AYpQhXnbpW9UdaZmlcULDocYynjAo+OVOHwkb3DHAJVoKIDe0zQOTReE0uYa0u5xPnIVf7SwNqGDLZXMDTHzJhzIg02/TdKJMcMH3qdesqur0Bz5AozrG+gxkseHeissnASlmjsuoylJErR48wTVuiOIWzjJxOiboAkY+omiCh9DVrWMAkoY/RQtiATIF4RFnJkHAsM1AEjidD4XoKFLbnqFA4BpDwbUXRICEGz04RLudohrI4vW2kLZUIiIAVLH8Ixz/pJZ8oZYl68PoHu6M6adqKMsalQG+QJdfUUzUIEskdpGNgt3O/aFML+g+U5ZoJ4mWJiKh57b8QyiW6cKdly2Da3i4wC7TEU6YeBg555xlgV7nMxVHN7UQcgzQu4bPsSo+Bz3uNk7L2OynR52z3TAZI70Sy/yGdK6T3NO7Hdk2Qfr/WBA4icl2L5jIdGektifROm9m2o1JXpWRNq3s1VuzU+17iCVr1dU6dyTrzkz3hHkHyJttBtZ1PvtxJbUnsPjH6trvy2l25ckdMUe2OKug3A+/EhuBYNmjx9xWeaNycyIV3B65nCtp2R+agDXuBNlSxfe9YhqExQw2HfaFpvyolf0vRzg1lJQVDNdpFGrg9A8GuS45A52V593FuZpfxhPdg7R5/i2+hZraho3voGxi/vX/8asa5NdobDukbD1MHDOZjbC3tOJJvxYkc6jF8iQttjpvzFxzoncinKcyLbXM/gQVxkdfllEe4ov5lJE/+D3UlG+vs7EtaE3dPtSRXg7mJtFkzbe/L/zIrPEpfTEG+38nVmJhMu6qCxhgk5OVhnBaKrt5GRUMEofOE+BV0bYW+rhM9I3h4qr0fX9xQXfXZChhb8RELFpyVUsXC7RhKjFcsXHXy/TfIYubsL+bhqu6qN/NQZ768DBukVPUTLCESPC1p8b1Sw1VR6eGaXGB7+apSBm8nRzP6y0q5hD8oM9TlhSTSdOIEJOGT80uBuLO/DTX+NjqXv+XLi6ZjYCgGwS3lrfOAtItJhwM4PBuAwxMAaH94C+T+8QwZj64KWUdDOrpO8XC4JR4+wEWe0mVTzfqp9QAwiTH8WeQ168dtiaQ9VM7EqNss98ugDs2ESM9phUhe+5UWUXsqMfH5ZN8x8p1Z4VBjheebdwwVK9yWn9YGcpsleV2Eard8MNPZ7Ela86xRzS4320NE0wlMpJfBxXQ0phNpTMc5m+lEiunwKbvVWMmHtgndtLw/m4hOYxMfJ+HjgV2yl65LruYzdkuxl6YMfAk0zdJFcMpAoy4DEvrSjHkUF0SljiViVOXOVUL9oRAYBq3FI83iiBaB0AQCzj4ENlHlz9C+6262R+21AAOzFE9dnWrpX06I/xAU7OiENuCrNnC9LOfU7UwPrZNfiuQ1vVtF8lATXfoqkvuvWhnv8LHATqtJwmhiNS1S9tS2IxBMpy19R4b0vf8Dgs1eBVHfkQl9d9jTVMzjnB5i8LSEmH4yM0rI77SyMkpwTF9TVPohOzo6QKBxZVH1tDJm72IPTX1K0MJEs06k2xxixAQ6bKrmkKSI7rqhkwAJEpLRnxeSHhDw1OCiQ8A2gYC6nHuP0TNMqth+ff/1ncUFQ186RX4LEc2kg5PXuFGopf8xyorl4gLJHjfVGyS33pfvi7vkJwrs5eRpMvn6L7y60uCkINPjRvFWiUKj3bPt8Wxt3PXMfdHh9fdFhx5jdQHg4N0uSso9rvdDVwn8u7LoJvnW7PLuQMMtO1Q8+3TJtxbt4PjvGrUFS01hs9unQOTsZiU03awHQuFV2FfI67CbJfnmtuqM3zdHGP4mSMbCPvWdJdquvkYureptSbM+US9zn6C8qsfbPQveOyrou7A7M1R6DTrnxI+/pu6TcNG5vuEFp6McaLs27utyor6qUjv4ICHyjaixqRbq8XmzRcOj4GkXDX0/7Fq6jV5fuiWnzf+5qPOf5r+JuLf/Aw==</diagram></mxfile>
\ No newline at end of file
diff --git a/docs/1.2/architecture/component-view/hono-messaging.png b/docs/1.2/architecture/component-view/hono-messaging.png
new file mode 100644
index 0000000..3ab763a
--- /dev/null
+++ b/docs/1.2/architecture/component-view/hono-messaging.png
Binary files differ
diff --git a/docs/1.2/architecture/component-view/hono-messaging.xml b/docs/1.2/architecture/component-view/hono-messaging.xml
new file mode 100644
index 0000000..5bbfdf6
--- /dev/null
+++ b/docs/1.2/architecture/component-view/hono-messaging.xml
@@ -0,0 +1 @@
+<mxfile userAgent="Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.79 Safari/537.36" version="9.0.5" editor="www.draw.io" type="device"><diagram id="1f35b589-4441-dfbc-3690-1f3fc3e36dca" name="Page-1">7Vpdc6M2FP01fmyGb5vHxJttO9N0nKYz3T4qoIAagVghx3Z/fa9AGITkmp3gzTZdHmK4Evo459yrK5GFvy72P3JU5XcsxXThOel+4X9YeJ7rexH8SMtBWUI3bi0ZJ6my9YYH8jdWRkdZtyTFtVZRMEYFqXRjwsoSJ0KzIc7ZTq/2xKjea4UybBgeEkRN6x8kFbmyulHcF/yESZarrlfesi14RMlzxtm2VP0tPP+pudriAnVtqYnWOUrZbmDybxf+mjMm2rtiv8ZUgtvB1r738UTpcdwcl2LKC177wguiW9yNuBmXOHRYNLPBsr678G92ORH4oUKJLN0B/WDLRUFVcYU5KbDAXFYhZQZmH8y14OwZrxllvGnUd5oLSjKKakmWvEc8UVII4UmNDHOB9ydn5x4xAzFiBl3zA1RRL/idnjoddrDvelLDQNnyAZ9BrIxICSk7tt2DCTcKTzu2voHt9d39BizuFbTu3OG6RpnEyHN+xWLH+LOBPUxd6ADrSJashJo3T4TSkQlRkpXwmABUGOw3EkgCCr9WBQVJU9mNldGec8nLEyuFIsZz5mEmCD2dmchkxgsjkxlvBmICA2ecgvurR8ZFzjJWInrbW0eIDAjBeyI+De7/lFWupIABCn74pN5oHvqyWiAuBmLHZXot41ZPIFg+EjkF9XoXJV3pT39hIQ7KgLaCgakf9i+MVZpauhDm6ly6wZFLOX+NyZpteaJMoQrAiGe4YyGeTDjHFAnyojf/GvbCLwlZzvmQNYxAp+PUDJr3Yj0aQeOG5m3ByPVn0Hx0HrWBBhnUG8lcl6MSvaOJ3hsr2/VM6ZqSbIW1MVcO54v0OYGIYdi3AN3ZJktW9bBhBDrueY5GPPu+3kQ7ePXWcHEeNxScaUghN26o0cJx2pPksXytPKyCCA3hWOLeUBz/RbZHJEUrZya2o/BSbK8uwvbSpPsd0Lt0rvzBFWocBY619NXUx6tLUW/J+NesKBBsWGRqFaFCLo/tX7CsIV3gjBry+DYS0+HSbU9sXrVgu8sRLZbtg23BniNH7XYP8yapKiQrl3XfMhGdEAs6rWqZpzeZxdkzz27jMPCd2xesXPK7d4Th1/MOcxPwO6ZYtRNRif4j10iJPm/loUqDxA91A8W13IsH1b4vhLtMHOH53zMaf8V4F10i3r3fTXm3Ax/Gxm578CaxMbbklK0jytlNcsWVzRXvKyJTkw+krpBIcrj9jW2lJ6nWYWBtByc89wJnAUMv7w94dRpXM52TeeMtoBlkXZtPRjP4pG85wUykau7uwXoN0ypI/c4Aj4LoPODehQAPXIsTnYR3wnH8v8KbLuNHx7EHpDHgOEqSEeDxTAo/f0R//Cw0xHuOE/rA3AwZeNc5quQtx5+3hMuPUjcp/IIfsLJZGLgc5hB0naFpCp9AgUXzcdObQGos7mqmk8rRAdYxLxhw4l8oDwjMmHOSEsooJZVcVzVKYJl8W0ouwEBgRiEbA+4cDJi59YazFyLxg6i/+dng49tOjmf6lhiHI0ZMn3C7HdDsTmGe3q9ZWW+L75ScCVNzUQKP/Uf59tit/9cH//Yf</diagram></mxfile>
\ No newline at end of file
diff --git a/docs/1.2/architecture/component-view/index.html b/docs/1.2/architecture/component-view/index.html
new file mode 100644
index 0000000..f65fedf
--- /dev/null
+++ b/docs/1.2/architecture/component-view/index.html
@@ -0,0 +1,2532 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Component View :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Component View :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Component View :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/architecture/component-view//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/architecture/component-view/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item active">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/architecture/component-view/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/architecture/component-view/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/architecture/component-view/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/architecture/component-view/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/architecture/component-view/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/architecture/component-view/index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/architecture/'>Architecture</a> > Component View
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#top-level">Top Level</a></li>
+<li><a href="#device-registry">Device Registry</a></li>
+<li><a href="#amqp-1-0-messaging-network">AMQP 1.0 Messaging Network</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Component View</h1>
+          
+
+        
+
+
+<p>This page describes the high level components constituting an Eclipse Hono&trade; instance and their relations to each other.</p>
+
+<h2 id="top-level">Top Level</h2>
+
+<p>The diagram below provides an overview of the top level <em>logical</em> components.</p>
+
+<figure>
+    <img src="top-level.png"/> 
+</figure>
+
+
+<p>The <em>MQTT</em> and <em>HTTP Adapters</em> use the <em>Device Registry</em> to authenticate <em>Devices</em> connecting to the adapters and asserting their
+registration status. The adapters then forward the telemetry data and events received from the devices to the <em>AMQP 1.0 Messaging Network</em>
+for delivery to <em>Business Applications</em>. Business applications also use the messaging network to send commands to connected devices.</p>
+
+<p>The <em>Device Registry</em> uses the <em>Auth Server</em> to authenticate the protocol adapters during connection establishment.</p>
+
+<p>All interactions between the components are based on AMQP 1.0 message exchanges as defined by the</p>
+
+<ul>
+<li><a href="/hono/docs/1.2/api/credentials/">Credentials API</a>,</li>
+<li><a href="/hono/docs/1.2/api/tenant/">Tenant API</a>,</li>
+<li><a href="/hono/docs/1.2/api/device-registration/">Device Registration API</a>,</li>
+<li><a href="/hono/docs/1.2/api/device-connection/">Device Connection API</a>,</li>
+<li><a href="/hono/docs/1.2/api/command-and-control/">Command &amp; Control API</a>,</li>
+<li><a href="/hono/docs/1.2/api/telemetry/">Telemetry API</a> and</li>
+<li><a href="/hono/docs/1.2/api/event/">Event API</a>.</li>
+</ul>
+
+<h2 id="device-registry">Device Registry</h2>
+
+<p>The diagram below provides an overview of the <em>Device Registry</em> component&rsquo;s internal structure.</p>
+
+<figure>
+    <img src="device-registry.png" width="100%"/> 
+</figure>
+
+
+<p>The <em>Device Registry</em> component implements the <a href="/hono/docs/1.2/api/credentials/">Credentials API</a>, <a href="/hono/docs/1.2/api/tenant/">Tenant API</a>,
+<a href="/hono/docs/1.2/api/device-registration/">Device Registration API</a> and <a href="/hono/docs/1.2/api/device-connection/">Device Connection API</a>.
+Clients opening a connection to <em>SimpleDeviceRegistryServer</em> are authenticated by means of an external service accessed via the <em>Auth</em> port.
+The <em>FileBasedCredentialsService</em>, <em>FileBasedTenantService</em> and <em>FileBasedRegistrationService</em> store all data in the local file system.
+The <em>MapBasedDeviceConnectionService</em> keeps all data in memory.
+The <em>Device Registry</em> is therefore not recommended to be used in production environments because the component cannot easily scale out horizontally.
+It is mainly intended to be used for demonstration purposes and PoCs. In real world scenarios, a more sophisticated implementation should
+be used that is designed to scale out, e.g. using a persistent store for keeping device registration information that can be shared by multiple instances.</p>
+
+<h2 id="amqp-1-0-messaging-network">AMQP 1.0 Messaging Network</h2>
+
+<p>The <em>AMQP 1.0 Messaging Network</em> is not <em>per se</em> a component being developed as part of Hono. Instead, Hono comes with a default implementation of the messaging network relying on artifacts provided by other open source projects. The default implementation currently consists of a single <a href="https://qpid.apache.org">Apache Qpid Dispatch Router</a> instance connected to a single <a href="https://activemq.apache.org/artemis/">Apache Artemis</a> broker instance. Note that this setup is useful for development purposes but will probably not meet requirements regarding e.g. scalability of real world use cases.</p>
+
+<p>The diagram below provides an overview of the default implementation of the Messaging Network component used with Hono.</p>
+
+<figure>
+    <img src="hono-messaging.png"/> 
+</figure>
+
+
+<p>Scaling out messaging infrastructure is a not a trivial task. Hono <strong>does not</strong> provide an out-of-the-box solution to this problem but instead integrates with the <a href="http://enmasse.io">EnMasse</a> project which aims at providing <em>Messaging as a Service</em> infrastructure.</p>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/architecture/component-view/top-level.png b/docs/1.2/architecture/component-view/top-level.png
new file mode 100644
index 0000000..b333695
--- /dev/null
+++ b/docs/1.2/architecture/component-view/top-level.png
Binary files differ
diff --git a/docs/1.2/architecture/component-view/top-level.xml b/docs/1.2/architecture/component-view/top-level.xml
new file mode 100644
index 0000000..7a29236
--- /dev/null
+++ b/docs/1.2/architecture/component-view/top-level.xml
@@ -0,0 +1 @@
+<mxfile host="www.draw.io" modified="2019-10-16T10:33:43.722Z" agent="Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:69.0) Gecko/20100101 Firefox/69.0" version="12.1.1" etag="gHkZKoHFO34990e9U8qM" type="device" pages="1"><diagram id="335c56a3-2b2a-8ff2-00d6-b683b72057d3" name="Page-1">7Z1bd6M4EoB/jR8nB0lcH51L9+w5yZ70JmdnZt+IUdtMY+TFOHH2168EEgZJxGADTmz8kBiZa31SqaokFRN0s9x+T/zV4oEEOJpAI9hO0O0EQmCbNv3HSt55iWE6eck8CQNetit4Cv+HxY68dBMGeF3ZMSUkSsNVtXBG4hjP0kqZnyTkrbrbTxJVr7ry51gpeJr5kVr6RxikC/Fglrn74Xcczhfi0sD28l9e/NmveUI2Mb/gBKKf2Sf/eemLk/EnXS/8gLyVitDdBN0khKT5t+X2BkdMukJu+XHfan4tbjzBcdroAITyQ179aMOf/nqzDmO8Xk/YsRQl2k4n6Hq6WkXhzE9DEvNbT9+FvOhTrNjXGVmuSJxd+tqPwnlMyyL8k22uV/4sjOf32dYtsmlRJibMbgTQrXnkrxk2g+2cJuQXviERSbILIBe+IJsd8zOMolJ5YGE3MFk5iVNej6BFt1U5cNG84iTF21IRl8t3TJY4Td7pLuJXiDgkXo1NUT3fdnUC2rxsUaoORaHP6+G8OPkOBf3CadSRMRUytYJP8H83YcKazHVA/88ySug2Jgm70etFuoy4mFsI3cg+qtB5hVaFnp9BtBh2/hVOQvrkOHnK8fPiLugAy6nSMYFCx9PAQW4XbOyRTQs2FhySjTOyacHG1mi1/th4zdlEJIrCFVlJbNZk0wUbVeZNaXUBwfCkBmI4V5aCQde32FYHGExjxKDF4NmDYgAKhunDj0daAq7KptcDNcb8OVMD0PgnTt9I8qv062VYYy6QjDEDqsaY6/RljJlQQfX78/Pj5AZOphUrOfBXVG2fFE/r/qeLpiQcIOHyaXoVoGtIAHaCx/r6Ci0hqc/vxehJv5lw0G7GUqnc4tdwhpVm8y88D9fZ6S+s3SBUbTcDqzVHNQSmtBnQ5ylc/QLIE05eL1GzSf2Orboy0OhLsUHDVqSMgzl+4pvMTyFzEvvR3a60JFGjqtDwNkz/LH3/i+1yxX0QP0mnLHY2Yf5PjEXZt5DdHedBt7l4gcfOEQfSIbSkdADdErsjuvk3TtN3XuBvUkKLdg9wT5hKzm5No0ObcmXC+ZBqgiNasV+rgT4dIn7oIwnpJYraYEvVwTWlU1ARzXHKjyoH3qQTIehdAXv3cUzpvMaVi3YfSR3TziqZYeUqFIb/XtptxXZY1z+NZeqfpu6m9+xPv+R3sKvbheSbVXdg9V/dHSurmfSm/sy2LdMVBfkOnolEwaPww8stYGwl+1rJnsrtwUMqt3IVYFigzXlrmuYB9RQ4amz24cfz8+gO1LgDLhzUHRCxqjNxB37zOnIIXGlEo7A+B/EGDIXBEbp91MSNNDHVkVXkhcnf2mBBe05Uo7YPUa9Ce/RuBnytWlQ2WgCUjBbq6vOC221xI2zrvbwlGzRNKyY08noi2rLXm90AjdLHqlQ5KJzjtpaC5YKPT1TTCNra07bhaK/TlX0MTHW0fuzYWMfmnrBjM1sM1F8SFGDAU1I53yH6fmDJytZVI5G9jQub5ztm34u6s0/JqoVzNbKCLjglqwbzLVRztuJm7TVKuXVNbdKKfe2ZNt9ubHPm5pxUzfZ6SCU5Who5irIjTVMXSRhRM/dHPZF9mEN2iLlowa+E/5OQ9qQQP7S8LqKV8ml75d7ATRi57wuVdAT+4BDMQeRbWL2X5Isg85SRzxbW7UVBkcaFhoUyjhFooViOe0IoLeYHj74FtJAUbxQGX3mYTcxQKMMyjQ5giVowwmo41QtKsNSpeEUssXNPUExbGmE1ggU993SwivlkR/RNHcH6XH0T7Yuuqm64bQ3XO0GjRRu6KCwOOimWBlGOS8RCLTkZi2AwCJYWY5U1PU5HBvaX6HEs05FoOZqpxgD2ZM1B4/jlxpeEC5lQwaWZ4wZRXyZCixUvIy56u7IuHBjX8SGgs+yjXFSdmTOs4XB8COg8oTinNbOPXyR+lliAAU/YWMDx0Z5L6nA8adDHNdTupnAoOzfmwPHRnkuC5SrWgR5XX9YBaOHBjrh2pttpYKlDrFkqgCxbVsTW67wk9NucfePLnetYbpbRdJYyYV+zpw9nfnTvv+DokaxDLrQXkqZkSXeI2A/XRXoxHSRxjilfPpRm/eJXztAhjdoCzTIiU9PhAaMTJXoGyWrKzQ+4XRkiQhACC9KmFdA0wE4sEXgZ406d4bKrg4RAM0iosxo7UZZQNUSyhZLQ9pesscQv61X2lKPm7FVzFiv/BtGcokGOmnOP5nTNYTXn8SH5S9acrj2k5lSDU7nmlHjRR0knmsmbQrp8cmdZ4LxIrDKfUQHhsiYVWnAZBkG2tPJtEaaYyZtd8y3xVxXqhkS9xDBbL9lFu5EW1rmmSkKnzjrJwYJUe0NJkiP1XpdJCTrVTsfSpGTtj5JqaeRu2chG14KANhVYf3RUi+AmwQFrQ360HiFxMbnyoCKywKCY1EHgZxz7bF76SCiTvJxBw4KD8qnNqKfwuclz4+vStR9Piiem+bycbCBHdKE3pMmgxghHdddA3dmeMWhzUkflR3VXUXfQOjEh1QuqU3g8h+hwFnmSP+snxmfB6gIbRyyqHQSdGj6/IculHwc6OjwemP+lR9Hui+KIxobIyUkZbBBUh/57I6lJF3/3ikctWYz1S2vDh4Wj+r3POML8RCOg3Pl1zRMS0vi+oyLsSBE6wByQpBo/HxXhB4pwWDi62MWoCD9WhMMSUqMXoyI8GCWQhnhNOKhnpsmvNurCj/hYYkbaIHR0kY1RGe4hJPJwDUKoweKD6si6TmAlQh8OvAeO99J0QgS2Z7OeJA7lFDuqwJF2WkoXbzuBTbKhDTP94aBpKRmF0jyH7malICk3laPB0lc7sNTgQi2UTzhXqLOmITMw1b5cxwB0wkD1UGsZnNVb5QCUEgfrZhjrsjN2skpDk6btMSGvIRMYNKaP/7jQftlUlmOYKpXi7WLdayTN4B2J15vliEVeQzsoFtWkvdtSocU+2+2j15NfBh7k2pIqUwd7tG8q64ZOA3OWzb9eHWfDQGOWz2vwX8RZjQ/Fory/zVUjv8XrIzvPZ+ZcRNYlPcJdlWg+XllNugRUh1n3KsRO8mM5LUygT2iGNnuDaBskA8xH//v+2+rHHwvnP3fb+wfr0f/3DKDfiqudCYnyqkeNOlOUXn3jMKUxLI1R1Nfq7xpSx6eM+QLarTuAIgBY5JRT9Vtv2RprCKo2VbPpNZ1bWINMpjkOnzSZBg4YLayhd775SzrVlEOmPashdXzk8Yst8D8OIKhqykEzoekJat6UfbYzr49iZ0MlMVp/sw7pZkJIWvrtO33kxQMJMNvj/w==</diagram></mxfile>
\ No newline at end of file
diff --git a/docs/1.2/architecture/index.html b/docs/1.2/architecture/index.html
new file mode 100644
index 0000000..ea5c0bf
--- /dev/null
+++ b/docs/1.2/architecture/index.html
@@ -0,0 +1,2454 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Architecture :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Architecture :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Architecture :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/architecture//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/architecture/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        parent
+        active
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/architecture/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/architecture/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/architecture/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/architecture/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/architecture/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/architecture/_index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > Architecture
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+              </div>
+            </div>
+            
+
+        
+          <div id="chapter">
+        
+        <div id="body-inner">
+          
+
+        
+
+
+
+
+<h1 id="architecture">Architecture</h1>
+
+<p>Get an overview of the architecture of Eclipse Hono&trade;.</p>
+
+
+<footer class=" footline" >
+	
+</footer>
+
+        
+            </div> 
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
diff --git a/docs/1.2/architecture/index.xml b/docs/1.2/architecture/index.xml
new file mode 100644
index 0000000..05d26ad
--- /dev/null
+++ b/docs/1.2/architecture/index.xml
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>Architecture on Eclipse Hono&amp;trade; Vers.: 1.2</title>
+    <link>https://www.eclipse.org/hono/docs/1.2/architecture/</link>
+    <description>Recent content in Architecture on Eclipse Hono&amp;trade; Vers.: 1.2</description>
+    <generator>Hugo -- gohugo.io</generator>
+    <language>en-us</language>
+    
+	<atom:link href="https://www.eclipse.org/hono/docs/1.2/architecture/index.xml" rel="self" type="application/rss+xml" />
+    
+    
+    <item>
+      <title>Component View</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/architecture/component-view/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/architecture/component-view/</guid>
+      <description>&lt;p&gt;This page describes the high level components constituting an Eclipse Hono&amp;trade; instance and their relations to each other.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Authentication/Authorization</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/architecture/auth/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/architecture/auth/</guid>
+      <description>&lt;p&gt;This page describes how authentication and authorization of devices, consumers (back end applications) and system components works in Hono.&lt;/p&gt;</description>
+    </item>
+    
+  </channel>
+</rss>
\ No newline at end of file
diff --git a/docs/1.2/categories/index.html b/docs/1.2/categories/index.html
new file mode 100644
index 0000000..6cdd4d6
--- /dev/null
+++ b/docs/1.2/categories/index.html
@@ -0,0 +1,2435 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Categories :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Categories :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Categories :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/categories//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/categories/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/categories/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/categories/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/categories/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/categories/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/categories/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            Categories
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Categories</h1>
+          
+
+        
+
+
+
+
+<footer class=" footline" >
+	
+</footer>
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
diff --git a/docs/1.2/categories/index.xml b/docs/1.2/categories/index.xml
new file mode 100644
index 0000000..7e19603
--- /dev/null
+++ b/docs/1.2/categories/index.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>Categories on Eclipse Hono&amp;trade; Vers.: 1.2</title>
+    <link>https://www.eclipse.org/hono/docs/1.2/categories/</link>
+    <description>Recent content in Categories on Eclipse Hono&amp;trade; Vers.: 1.2</description>
+    <generator>Hugo -- gohugo.io</generator>
+    <language>en-us</language>
+    
+	<atom:link href="https://www.eclipse.org/hono/docs/1.2/categories/index.xml" rel="self" type="application/rss+xml" />
+    
+    
+  </channel>
+</rss>
\ No newline at end of file
diff --git a/docs/1.2/concepts/Tenants_Devices_Credentials.odg b/docs/1.2/concepts/Tenants_Devices_Credentials.odg
new file mode 100644
index 0000000..af32a4c
--- /dev/null
+++ b/docs/1.2/concepts/Tenants_Devices_Credentials.odg
Binary files differ
diff --git a/docs/1.2/concepts/Tenants_Devices_Credentials.png b/docs/1.2/concepts/Tenants_Devices_Credentials.png
new file mode 100644
index 0000000..35e01da
--- /dev/null
+++ b/docs/1.2/concepts/Tenants_Devices_Credentials.png
Binary files differ
diff --git a/docs/1.2/concepts/command-and-control/index.html b/docs/1.2/concepts/command-and-control/index.html
new file mode 100644
index 0000000..2170e73
--- /dev/null
+++ b/docs/1.2/concepts/command-and-control/index.html
@@ -0,0 +1,2599 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Command & Control :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Command &amp; Control :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Command &amp; Control :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/concepts/command-and-control//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/concepts/command-and-control/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item active">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/command-and-control/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/concepts/command-and-control/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/concepts/command-and-control/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/concepts/command-and-control.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/concepts/'>Concepts</a> > Command & Control
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#general-concept">General concept</a>
+<ul>
+<li>
+<ul>
+<li><a href="#command-control-involving-a-gateway">Command &amp; Control involving a gateway</a></li>
+<li><a href="#command-consumer-links-in-the-protocol-adapter">Command consumer links in the protocol adapter</a></li>
+<li><a href="#example-with-multiple-adapters-involved">Example with multiple adapters involved</a></li>
+</ul></li>
+</ul></li>
+<li><a href="#gateway-subscriptions">Gateway subscriptions</a>
+<ul>
+<li><a href="#gateway-subscribing-for-commands-for-a-particular-device">Gateway subscribing for commands for a particular device</a></li>
+<li><a href="#gateway-subscribing-for-commands-for-all-its-devices">Gateway subscribing for commands for all its devices</a></li>
+</ul></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Command &amp; Control</h1>
+          
+
+        
+
+
+<p><em>Business applications</em> can send commands to devices following the <a href="/hono/docs/1.2/api/command-and-control/">Command &amp; Control API</a>. This concept page describes how this API is used by applications to send commands and describes how Hono&rsquo;s protocol adapters process the commands so that they reach their target device.</p>
+
+<p>Commands can be sent following a <em>request/response</em> or a <em>one-way</em> pattern. For <em>Request/Response</em> commands, there is always a response expected from the device.</p>
+
+<h2 id="general-concept">General concept</h2>
+
+<p>The following sequence diagram gives an overview of a device indicating its availability for receiving commands, of a business application sending a command to the device and of the device sending back a command response.</p>
+
+<p>The application and the adapter connect to the AMQP Network, which forwards the transfer - for clarity this is not shown in the diagram below.</p>
+
+<figure>
+    <img src="../command_control_concept.svg"/> <figcaption>
+            <h4>Request/Response Command overview</h4>
+        </figcaption>
+</figure>
+
+
+<p>In (1) the device subscribes for commands (if connecting to the AMQP or MQTT adapter) or indicates that it will stay connected for a given amount of time to receive a command (if connecting to the HTTP adapter), using the <code>ttd</code> (&ldquo;time till disconnect&rdquo;) parameter.</p>
+
+<p>The protocol adapter will then create the necessary AMQP consumer link with the AMQP messaging network if it doesn&rsquo;t exist already (for more details see <a href="#command-consumer-links-in-the-protocol-adapter">below</a>) and will send a <a href="/hono/docs/1.2/concepts/device-notifications/">notification</a> to the application that the device is ready to receive commands (2).</p>
+
+<p>After having created a sender link on the <code>command/TENANT</code> address, the application can then send commands, with the target device given in the AMQP message <code>to</code> address <code>command/TENANT/4711</code> (3). If a command response is expected, the command response address <code>command_response/TENANT/${replyId}</code> (with <code>replyId</code> being an arbitrary identifier chosen by the application) is to be set as <code>reply-to</code> property in the command message and a corresponding receiver link is to be opened by the application. For one-way commands, both is to be omitted.</p>
+
+<p>After receiving the command, the protocol adapter instance will forward the command to the device (4) and send a disposition update back to the application (5).</p>
+
+<p>In case of a Request/Response command, the device can then send a command response (6) that will be forwarded by the protocol adapter back to the application (7).</p>
+
+<h4 id="command-control-involving-a-gateway">Command &amp; Control involving a gateway</h4>
+
+<p>Hono has special support for sending commands to devices that are connected via a gateway to Hono.
+Such devices are configured in the Hono device registration service in such a way, that certain gateways may act on behalf of the device.</p>
+
+<p>When sending commands, the northbound applications do not have to know to which gateway the command target device is connected to.
+The application sends the command with the device address and Hono will direct the command to a gateway that has subscribed for such commands and that is configured to act on behalf of the command target device. If there are multiple matching gateways, the one that the command target device was last connected to is chosen.
+The information about which gateways are subscribed and which gateway a device has last communicated by is managed via the <a href="/hono/docs/1.2/api/device-connection/">device connection service</a>.</p>
+
+<h4 id="command-consumer-links-in-the-protocol-adapter">Command consumer links in the protocol adapter</h4>
+
+<p>The protocol adapter opens 2 kinds of consumer links to receive commands.</p>
+
+<ol>
+<li><p><strong>A tenant-scoped link on the address <code>command/${tenant}</code></strong>.<br />
+This is the link address used by applications to send commands. Upon receiving a command message on this link, the protocol adapter checks whether the command target device id needs to be mapped to a gateway. Furthermore it is checked to which particular protocol adapter instance the target device (or mapped gateway) is actually connected. Since this kind of link is opened from all protocol adapter instances receiving commands for the tenant, a command message is first received by any one of these protocol adapter instances. Therefore, if necessary, the command will be delegated to the adapter instance that is connected to the target device or to the gateway receiving commands for the device.
+That is done by forwarding the command to the AMQP messaging network on a link with the address <code>command_internal/${adapterInstanceId}</code> (see below).</p></li>
+
+<li><p><strong>A link per protocol adapter instance on the address <code>command_internal/${adapterInstanceId}</code></strong>.<br />
+On this link, commands will be received that have been forwarded from another protocol adapter instance. This link address is only used for communication between protocol adapter instances, so attaching to this link address should not be enabled for applications.</p></li>
+</ol>
+
+<h4 id="example-with-multiple-adapters-involved">Example with multiple adapters involved</h4>
+
+<p>The following diagrams show the message flow if the command message is first received on a protocol adapter instance that the target device is <em>not</em> connected to.</p>
+
+<figure>
+    <img src="../command_control_concept_delegate_1.svg"/> <figcaption>
+            <h4>Command subscription</h4>
+        </figcaption>
+</figure>
+
+
+<p>In the scenario here there is a protocol adapter instance #2 through which a command subscription for the example tenant was already made (0).</p>
+
+<p>The device subscribes for commands (1) and the protocol adapter creates the receiver link (2) on the tenant-scoped link. The protocol adapter then updates the <a href="/hono/docs/1.2/api/device-connection/#set-command-handling-protocol-adapter-instance-for-device">command-handling protocol adapter instance for device</a> information (3), assigning the device 4711 to adapter instance id #1. Following that, the notification about the device subscription is sent to the application via the AMQP messaging network (4).</p>
+
+<figure>
+    <img src="../command_control_concept_delegate_2.svg"/> <figcaption>
+            <h4>Command handling</h4>
+        </figcaption>
+</figure>
+
+
+<p>Upon receiving the notification, the application prepares sender and command response receiver links (1,2) and sends the command message to the AMQP messaging network. Here it is received by protocol adapter instance #2. The protocol adapter then queries the <a href="/hono/docs/1.2/api/device-connection/#get-command-handling-protocol-adapter-instances-for-device">command-handling protocol adapter instances</a> information for the device id of the command message (4). In this case here, the protocol adapter instance #1 is returned (5). The command then gets forwarded to the AMQP messaging network on the address for adapter instance #1 (6). The protocol adapter instance #1 will receive the message (7) and forward it to the device (8). As the last step, an &ldquo;accepted&rdquo; disposition will be sent back to the application (9).</p>
+
+<figure>
+    <img src="../command_control_concept_delegate_3.svg"/> <figcaption>
+            <h4>Command response handling</h4>
+        </figcaption>
+</figure>
+
+
+<p>The command response message is sent back to the application from the protocol adapter via the AMQP messaging network.</p>
+
+<h2 id="gateway-subscriptions">Gateway subscriptions</h2>
+
+<h3 id="gateway-subscribing-for-commands-for-a-particular-device">Gateway subscribing for commands for a particular device</h3>
+
+<p>The following sequence diagrams show the different steps involved in having a gateway subscribe for commands of a particular device.</p>
+
+<figure>
+    <img src="../command_control_concept_gateway_1.svg"/> <figcaption>
+            <h4>Command subscription</h4>
+        </figcaption>
+</figure>
+
+
+<p>The gateway &ldquo;gw-1&rdquo; is connected to a protocol adapter and subscribes to commands for a device 4711 (1). This device has to be configured so that the gateway may act on its behalf (see <a href="/hono/docs/1.2/admin-guide/device-registry-config/#configuring-gateway-devices">Configuring Gateway Devices</a> for details).</p>
+
+<p>The protocol adapter creates the tenant-scoped consumer link on the <code>command/TENANT</code> address (if it doesn&rsquo;t already exist) (2) and then updates the <a href="/hono/docs/1.2/api/device-connection/#set-command-handling-protocol-adapter-instance-for-device">command-handling protocol adapter instance for device</a> information (3), assigning the device 4711 to adapter instance id #1.</p>
+
+<p>Just like it is done when a protocol adapter handles any kind of message from a gateway acting on behalf of a device, the protocol adapter updates the <a href="/hono/docs/1.2/api/device-connection/#set-last-known-gateway-for-device">last-known gateway</a> information here, sending a request to the device connection service (4). The notification event is then sent containing the device id 4711 (5)</p>
+
+<figure>
+    <img src="../command_control_concept_gateway_2.svg"/> <figcaption>
+            <h4>Command handling</h4>
+        </figcaption>
+</figure>
+
+
+<p>After the application has prepared the sender and consumer links (1,2), it sends the command message on the <code>command/TENANT</code> link with the AMQP message <code>to</code> property set to <code>command/TENANT/4711</code> and <code>reply-to</code> set to the address of the command response consumer link (<code>command_response/TENANT/${replyId}</code> with <code>replyId</code> being an arbitrary identifier chosen by the application) (3). After receiving the command message, the protocol adapter determines the <a href="/hono/docs/1.2/api/device-connection/#get-command-handling-protocol-adapter-instances-for-device">command-handling protocol adapter instances</a> information for the device id of the command message (4). In this case here, the protocol adapter instance #1 is returned (5), meaning that the command is already at the right adapter instance. As the subscription for commands to device 4711 was done by gateway &ldquo;gw-1&rdquo;, the command gets forwarded to that gateway (6). It is then the responsibility of the gateway to forward the command to the device <code>4711</code>. After the gateway has acknowledged the command message, an &ldquo;accepted&rdquo; disposition will be sent back to the application (7).</p>
+
+<figure>
+    <img src="../command_control_concept_gateway_3.svg"/> <figcaption>
+            <h4>Command response handling</h4>
+        </figcaption>
+</figure>
+
+
+<p>When the device sends a command response via the gateway (1), the protocol adapter forwards the command message on the <code>command_response/TENANT/${replyId}</code> link to the application (2).</p>
+
+<h3 id="gateway-subscribing-for-commands-for-all-its-devices">Gateway subscribing for commands for all its devices</h3>
+
+<p>A gateway may also subscribe for commands sent to all the different devices that the gateway acts on behalf of. Such a scenario is shown in the following sequence diagram.</p>
+
+<figure>
+    <img src="../command_control_concept_gateway_all_devices_1.svg"/> <figcaption>
+            <h4>Command subscription</h4>
+        </figcaption>
+</figure>
+
+
+<p>The gateway subscribes for commands just like a normal device would, only using its id <code>gw-1</code> (1). The protocol adapter creates the tenant-scoped consumer link on the <code>command/TENANT</code> address (if it doesn&rsquo;t already exist) (2) and then updates the <a href="/hono/docs/1.2/api/device-connection/#set-command-handling-protocol-adapter-instance-for-device">command-handling protocol adapter instance for device</a> information (3), assigning the device &lsquo;gw-1&rsquo; to adapter instance id #1.
+The subscription notification sent to the application contains the gateway id <code>gw-1</code>. That means that either the application has to know about the gateway, or that it just assumes that the devices it sends commands to (and that are connected to the gateway) are always available for receiving commands. This may especially be the case for long-lasting command subscriptions (with the MQTT or AMQP adapter).</p>
+
+<figure>
+    <img src="../command_control_concept_gateway_all_devices_2.svg"/> <figcaption>
+            <h4>Command handling</h4>
+        </figcaption>
+</figure>
+
+
+<p>After the application has prepared the sender and consumer links (1,2), it sends the command message on the <code>command/TENANT</code> link with the AMQP message <code>to</code> property set to <code>command/TENANT/4711</code> and <code>reply-to</code> set to the address of the command response consumer link (<code>command_response/TENANT/${replyId}</code> with <code>replyId</code> being an arbitrary identifier chosen by the application) (3). After receiving the command message, the protocol adapter determines the <a href="/hono/docs/1.2/api/device-connection/#get-command-handling-protocol-adapter-instances-for-device">command-handling protocol adapter instances</a> information for the device id of the command message (4).</p>
+
+<p>In the example above, there is no adapter instance associated with the device <code>4711</code>. Therefore it is checked whether there are adapter instances handling commands for the gateways, configured to possibly act on behalf of the device.
+If there is an adapter instance associated with the last known gateway of the device, that instance is returned as the result. Otherwise, and in the example above, the command handling adapter instance for any of these gateways is returned (the choice being random if there are multiple instances). In the above example that is the instance #1 associated with gateway <code>gw-1</code> (5).</p>
+
+<p>Then the command gets forwarded to that gateway (6). It is the responsibility of the gateway to forward the command to the device <code>4711</code>. After the gateway has acknowledged the command message, an &ldquo;accepted&rdquo; disposition will be sent back to the application (7).</p>
+
+<p>Handling of the command response is done in the same way as shown in the chapter above for a gateway subscribing for a particular device and is therefore omitted here.</p>
+
+<p>If a gateway has already subscribed for commands for all its device, it may still subscribe for commands for a particular device (and the other way around).
+The particular device subscription has precedence then in choosing over which subscription protocol/channel to send the command to the gateway.</p>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/concepts/command_control_concept.svg b/docs/1.2/concepts/command_control_concept.svg
new file mode 100644
index 0000000..6c4041d
--- /dev/null
+++ b/docs/1.2/concepts/command_control_concept.svg
@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="669.6px" preserveAspectRatio="none" style="width:1050px;height:669px;" version="1.1" viewBox="0 0 1050 669" width="1050px" zoomAndPan="magnify"><defs><filter height="300%" id="fngzrirs0jsbq" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="414.7125" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="472.2" y="177.3937"/><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="332.7938" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="912.6" y="259.3125"/><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="137.4375" style="stroke: #000000; stroke-width: 2.4;" width="888" x="98.4" y="131.475"/><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="208.7156" style="stroke: #000000; stroke-width: 2.4;" width="938.4" x="98.4" y="285.7125"/><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="90.4781" style="stroke: #000000; stroke-width: 2.4;" width="888" x="98.4" y="511.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="148.8" x2="148.8" y1="45.9563" y2="622.1062"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="478.2" x2="478.2" y1="45.9563" y2="622.1062"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="918" x2="918" y1="45.9563" y2="622.1062"/><rect fill="#FEFECE" filter="url(#fngzrirs0jsbq)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#fngzrirs0jsbq)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="620.9063"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="644.9004">Device</text><rect fill="#FEFECE" filter="url(#fngzrirs0jsbq)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="373.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="382.2" y="27.5941">Hono Protocol Adapter</text><rect fill="#FEFECE" filter="url(#fngzrirs0jsbq)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="373.8" y="620.9063"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="382.2" y="644.9004">Hono Protocol Adapter</text><rect fill="#FEFECE" filter="url(#fngzrirs0jsbq)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="862.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="871.2" y="27.5941">Application</text><rect fill="#FEFECE" filter="url(#fngzrirs0jsbq)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="862.8" y="620.9063"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="871.2" y="644.9004">Application</text><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="414.7125" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="472.2" y="177.3937"/><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="332.7938" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="912.6" y="259.3125"/><path d="M9.6,63.9563 L9.6,111.9563 L285.6,111.9563 L285.6,75.9563 L273.6,63.9563 L9.6,63.9563 " fill="#FBFB77" filter="url(#fngzrirs0jsbq)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M273.6,63.9563 L273.6,75.9563 L285.6,75.9563 L273.6,63.9563 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="217.2" x="16.8" y="84.4365">The device is connected and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="250.8" x="16.8" y="102.5959">authenticated with TENANT/4711</text><path d="M98.4,131.475 L357.6,131.475 L357.6,139.875 L345.6,151.875 L98.4,151.875 L98.4,131.475 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="137.4375" style="stroke: #000000; stroke-width: 2.4;" width="888" x="98.4" y="131.475"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="116.4" y="147.1553">Command subscription</text><polygon fill="#A80036" points="457.8,172.5938,469.8,177.3937,457.8,182.1938,462.6,177.3937" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="465" y1="177.3937" y2="177.3937"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="157.8" y="171.3146">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="284.4" x="173.4" y="171.3146">Command subscription / TTD request</text><path d="M273.6,192.9938 L273.6,222.9938 L678,222.9938 L678,204.9938 L666,192.9938 L273.6,192.9938 " fill="#FBFB77" filter="url(#fngzrirs0jsbq)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M666,192.9938 L666,204.9938 L678,204.9938 L666,192.9938 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="379.2" x="280.8" y="213.474">Ensure Command consumer link for tenant exists</text><polygon fill="#A80036" points="898.2,254.5125,910.2,259.3125,898.2,264.1125,903,259.3125" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="484.2" x2="905.4" y1="259.3125" y2="259.3125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="492.6" y="253.2334">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="350.4" x="508.2" y="253.2334">transfer("event/TENANT","4711","ttd=${ttd}")</text><path d="M98.4,285.7125 L325.2,285.7125 L325.2,294.1125 L313.2,306.1125 L98.4,306.1125 L98.4,285.7125 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="208.7156" style="stroke: #000000; stroke-width: 2.4;" width="938.4" x="98.4" y="285.7125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="116.4" y="301.3928">Command handling</text><path d="M812.4,312.2719 L812.4,360.2719 L1020,360.2719 L1020,324.2719 L1008,312.2719 L812.4,312.2719 " fill="#FBFB77" filter="url(#fngzrirs0jsbq)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M1008,312.2719 L1008,324.2719 L1020,324.2719 L1008,312.2719 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="819.6" y="332.7521">Create sender link and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="182.4" x="819.6" y="350.9115">response consumer link</text><polygon fill="#A80036" points="497.4,410.1094,485.4,414.9094,497.4,419.7094,492.6,414.9094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="490.2" x2="911.4" y1="414.9094" y2="414.9094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="504.6" y="399.7506">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="226.8" x="520.2" y="390.6709">transfer("command/TENANT",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="525" y="408.8303">"command/TENANT/4711","${payload}")</text><polygon fill="#A80036" points="162.6,445.0687,150.6,449.8688,162.6,454.6688,157.8,449.8688" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="155.4" x2="471" y1="449.8688" y2="449.8688"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="169.8" y="443.7896">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="249.6" x="185.4" y="443.7896">Command is published to device</text><polygon fill="#A80036" points="898.2,480.0281,910.2,484.8281,898.2,489.6281,903,484.8281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="484.2" x2="905.4" y1="484.8281" y2="484.8281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="492.6" y="478.749">5</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="508.2" y="478.749">disposition("accepted")</text><path d="M98.4,511.2281 L412.8,511.2281 L412.8,519.6281 L400.8,531.6281 L98.4,531.6281 L98.4,511.2281 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="90.4781" style="stroke: #000000; stroke-width: 2.4;" width="888" x="98.4" y="511.2281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="260.4" x="116.4" y="526.9084">Command response handling</text><polygon fill="#A80036" points="457.8,552.3469,469.8,557.1469,457.8,561.9469,462.6,557.1469" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="465" y1="557.1469" y2="557.1469"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="157.8" y="551.0678">6</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="260.4" x="173.4" y="551.0678">Device sends command response</text><polygon fill="#A80036" points="904.2,587.3063,916.2,592.1062,904.2,596.9063,909,592.1062" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="478.2" x2="911.4" y1="592.1062" y2="592.1062"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="486.6" y="586.0271">7</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="384" x="502.2" y="586.0271">transfer("${reply-to}","status=200","${payload}")</text><!--MD5=[e0e07f50b6ca463e3c049d624b0d9900]
+@startuml
+scale 1.2
+
+participant Device order 10
+participant "Hono Protocol Adapter" order 20
+participant Application order 40
+
+autonumber
+
+note over Device
+The device is connected and
+authenticated with TENANT/4711
+end note
+group Command subscription
+    Device -> "Hono Protocol Adapter": Command subscription / TTD request
+    activate "Hono Protocol Adapter"
+    note over "Hono Protocol Adapter"
+    Ensure Command consumer link for tenant exists
+    end note
+    "Hono Protocol Adapter" -> Application: transfer("event/TENANT","4711","ttd=${ttd}")
+    activate Application
+end
+group Command handling
+    note over Application
+    Create sender link and
+    response consumer link
+    end note
+    Application -> "Hono Protocol Adapter": transfer("command/TENANT",\n "command/TENANT/4711","${payload}")
+    "Hono Protocol Adapter" -> Device: Command is published to device
+    "Hono Protocol Adapter" -> Application: disposition("accepted")
+end
+group Command response handling
+    Device -> "Hono Protocol Adapter": Device sends command response
+    "Hono Protocol Adapter" -> Application: transfer("${reply-to}","status=200","${payload}")
+    deactivate "Hono Protocol Adapter"
+    deactivate Application
+end
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.4+11-post-Ubuntu-1ubuntu218.04.3
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/concepts/command_control_concept_amqp.svg b/docs/1.2/concepts/command_control_concept_amqp.svg
new file mode 100644
index 0000000..0fb1ce7
--- /dev/null
+++ b/docs/1.2/concepts/command_control_concept_amqp.svg
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="663.6px" preserveAspectRatio="none" style="width:1086px;height:663px;" version="1.1" viewBox="0 0 1086 663" width="1086px" zoomAndPan="magnify"><defs><filter height="300%" id="f1dgeg840p9dw" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f1dgeg840p9dw)" height="376.3125" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1015.8" y="218.3531"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="148.8" x2="148.8" y1="45.9563" y2="616.2656"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="582" x2="582" y1="45.9563" y2="616.2656"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1021.2" x2="1021.2" y1="45.9563" y2="616.2656"/><rect fill="#FEFECE" filter="url(#f1dgeg840p9dw)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#f1dgeg840p9dw)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="615.0656"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="639.0598">Device</text><rect fill="#FEFECE" filter="url(#f1dgeg840p9dw)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="135.6" x="512.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="520.8" y="27.5941">AMQP Adapter</text><rect fill="#FEFECE" filter="url(#f1dgeg840p9dw)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="135.6" x="512.4" y="615.0656"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="520.8" y="639.0598">AMQP Adapter</text><rect fill="#FEFECE" filter="url(#f1dgeg840p9dw)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="966" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="974.4" y="27.5941">Application</text><rect fill="#FEFECE" filter="url(#f1dgeg840p9dw)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="966" y="615.0656"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="974.4" y="639.0598">Application</text><rect fill="#FFFFFF" filter="url(#f1dgeg840p9dw)" height="376.3125" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1015.8" y="218.3531"/><path d="M9.6,63.9563 L9.6,111.9563 L285.6,111.9563 L285.6,75.9563 L273.6,63.9563 L9.6,63.9563 " fill="#FBFB77" filter="url(#f1dgeg840p9dw)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M273.6,63.9563 L273.6,75.9563 L285.6,75.9563 L273.6,63.9563 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="217.2" x="16.8" y="84.4365">The device is connected and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="250.8" x="16.8" y="102.5959">authenticated with TENANT/4711</text><polygon fill="#A80036" points="568.2,143.6344,580.2,148.4344,568.2,153.2344,573,148.4344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="575.4" y1="148.4344" y2="148.4344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="253.2" x="157.8" y="142.3553">1. attach("receiver", "command")</text><polygon fill="#A80036" points="162.6,178.5938,150.6,183.3937,162.6,188.1938,157.8,183.3937" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="155.4" x2="581.4" y1="183.3937" y2="183.3937"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="244.8" x="169.8" y="177.3146">2. attach("sender", "command")</text><polygon fill="#A80036" points="1001.4,213.5531,1013.4,218.3531,1001.4,223.1531,1006.2,218.3531" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="582.6" x2="1008.6" y1="218.3531" y2="218.3531"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="334.8" x="591" y="212.274">3. transfer("event/TENANT","4711","ttd=-1")</text><polygon fill="#A80036" points="595.8,248.5125,583.8,253.3125,595.8,258.1125,591,253.3125" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="588.6" x2="1014.6" y1="253.3125" y2="253.3125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="380.4" x="603" y="247.2334">4. transfer("command/TENANT/4711","light","ON")</text><path d="M386.4,268.9125 L386.4,334.9125 L774,334.9125 L774,280.9125 L762,268.9125 L386.4,268.9125 " fill="#FBFB77" filter="url(#f1dgeg840p9dw)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M762,268.9125 L762,280.9125 L774,280.9125 L762,268.9125 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="291.6" x="393.6" y="289.3928">The command message is sent to the</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="303.6" x="393.6" y="307.5521">device with the 'reply-to' property set to</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="362.4" x="393.6" y="325.7115">"command_response/TENANT/4711/${replyId}"</text><polygon fill="#A80036" points="162.6,366.75,150.6,371.55,162.6,376.35,157.8,371.55" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="155.4" x2="581.4" y1="371.55" y2="371.55"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="380.4" x="169.8" y="365.4709">5. transfer("command/TENANT/4711","light","ON")</text><path d="M28.8,387.15 L28.8,453.15 L265.2,453.15 L265.2,399.15 L253.2,387.15 L28.8,387.15 " fill="#FBFB77" filter="url(#f1dgeg840p9dw)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M253.2,387.15 L253.2,399.15 L265.2,399.15 L253.2,387.15 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="192" x="36" y="407.6303">In order to send back the</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="211.2" x="36" y="425.7896">response, the device opens</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="201.6" x="36" y="443.949">an anonymous sender link</text><polygon fill="#A80036" points="568.2,484.9875,580.2,489.7875,568.2,494.5875,573,489.7875" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="575.4" y1="489.7875" y2="489.7875"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="181.2" x="157.8" y="483.7084">6. attach("sender", null)</text><polygon fill="#A80036" points="162.6,519.9469,150.6,524.7469,162.6,529.5469,157.8,524.7469" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="155.4" x2="581.4" y1="524.7469" y2="524.7469"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="189.6" x="169.8" y="518.6678">7. attach("receiver", null)</text><polygon fill="#A80036" points="568.2,554.9063,580.2,559.7063,568.2,564.5063,573,559.7063" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="575.4" y1="559.7063" y2="559.7063"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="404.4" x="157.8" y="553.6271">8. transfer("${reply-to}","status=200","lumen=100")</text><polygon fill="#A80036" points="1007.4,589.8656,1019.4,594.6656,1007.4,599.4656,1012.2,594.6656" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="582.6" x2="1014.6" y1="594.6656" y2="594.6656"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="404.4" x="591" y="588.5865">9. transfer("${reply-to}","status=200","lumen=100")</text><!--
+@startuml
+scale 1.2
+
+participant Device
+participant "AMQP Adapter"
+participant Application
+
+note over Device
+The device is connected and
+authenticated with TENANT/4711
+end note
+Device -> "AMQP Adapter": 1. attach("receiver", "command")
+"AMQP Adapter" -> Device: 2. attach("sender", "command")
+"AMQP Adapter" -> Application: 3. transfer("event/TENANT","4711","ttd=-1")
+activate Application
+Application -> "AMQP Adapter": 4. transfer("command/TENANT/4711","light","ON")
+note over "AMQP Adapter"
+The command message is sent to the
+device with the 'reply-to' property set to
+"command_response/TENANT/4711/${replyId}"
+end note
+"AMQP Adapter" -> Device: 5. transfer("command/TENANT/4711","light","ON")
+note over Device
+In order to send back the
+response, the device opens
+an anonymous sender link
+end note
+Device -> "AMQP Adapter": 6. attach("sender", null)
+"AMQP Adapter" -> Device: 7. attach("receiver", null)
+Device -> "AMQP Adapter": 8. transfer("${reply-to}","status=200","lumen=100")
+"AMQP Adapter" -> Application: 9. transfer("${reply-to}","status=200","lumen=100")
+deactivate Application
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/concepts/command_control_concept_delegate_1.svg b/docs/1.2/concepts/command_control_concept_delegate_1.svg
new file mode 100644
index 0000000..a191e61
--- /dev/null
+++ b/docs/1.2/concepts/command_control_concept_delegate_1.svg
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="495.6px" preserveAspectRatio="none" style="width:1159px;height:495px;" version="1.1" viewBox="0 0 1159 495" width="1159.2px" zoomAndPan="magnify"><defs><filter height="300%" id="f14y3nnq0zl06i" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="469.7438" style="stroke: #A80036; stroke-width: 1.2;" width="544.8" x="286.8" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="536.4" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="142.2375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="365.4" y="328.7063"/><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1072.2" y="451.7438"/><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="196.7156" style="stroke: #000000; stroke-width: 2.4;" width="1047.6" x="98.4" y="264.6281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="148.8" x2="148.8" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="370.8" x2="370.8" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="542.4" x2="542.4" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="736.8" x2="736.8" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="924" x2="924" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1077.6" x2="1077.6" y1="89.6719" y2="481.7438"/><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="71.3098">Device</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="291.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="300" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="318.6" y="71.3098">instance #1</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="463.2" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="471.6" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="490.2" y="71.3098">instance #2</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="648" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="656.4" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="672" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="838.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="847.2" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="888.6" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1022.4" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1030.8" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="142.2375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="365.4" y="328.7063"/><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1072.2" y="451.7438"/><polygon fill="#A80036" points="910.2,176.7094,922.2,181.5094,910.2,186.3094,915,181.5094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="543" x2="917.4" y1="181.5094" y2="181.5094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="551.4" y="148.1912">0</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="567" y="120.9521">Consumer link on</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="156" x="567" y="139.1115">"command/TENANT"</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="148.8" x="567" y="157.2709">created for another</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="92.4" x="567" y="175.4303">subscription</text><path d="M9.6,197.1094 L9.6,245.1094 L285.6,245.1094 L285.6,209.1094 L273.6,197.1094 L9.6,197.1094 " fill="#FBFB77" filter="url(#f14y3nnq0zl06i)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M273.6,197.1094 L273.6,209.1094 L285.6,209.1094 L273.6,197.1094 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="217.2" x="16.8" y="217.5896">The device is connected and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="250.8" x="16.8" y="235.749">authenticated with TENANT/4711</text><path d="M98.4,264.6281 L357.6,264.6281 L357.6,273.0281 L345.6,285.0281 L98.4,285.0281 L98.4,264.6281 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="196.7156" style="stroke: #000000; stroke-width: 2.4;" width="1047.6" x="98.4" y="264.6281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="116.4" y="280.3084">Command subscription</text><polygon fill="#A80036" points="351,323.9063,363,328.7063,351,333.5062,355.8,328.7063" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="358.2" y1="328.7063" y2="328.7063"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="157.8" y="313.5475">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="173.4" y="304.4678">Command subscription</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="102" x="178.2" y="322.6271">/ TTD request</text><polygon fill="#A80036" points="910.2,358.8656,922.2,363.6656,910.2,368.4656,915,363.6656" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="377.4" x2="917.4" y1="363.6656" y2="363.6656"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="385.8" y="357.5865">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="300" x="401.4" y="357.5865">attach("receiver", "command/TENANT")</text><polygon fill="#A80036" points="723,411.9844,735,416.7844,723,421.5844,727.8,416.7844" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="377.4" x2="730.2" y1="416.7844" y2="416.7844"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="385.8" y="401.6256">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="401.4" y="392.5459">set command handling adapter instance</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="300" x="401.4" y="410.7053">for device 4711 to adapter instance #1</text><polygon fill="#A80036" points="1057.8,446.9437,1069.8,451.7438,1057.8,456.5438,1062.6,451.7438" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="377.4" x2="1065" y1="451.7438" y2="451.7438"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="385.8" y="445.6646">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="585.6" x="401.4" y="445.6646">transfer("event/TENANT","4711","ttd=${ttd}")  via AMQP messaging network</text><!--MD5=[c8b432715fa26176d4dfd933528d308b]
+@startuml
+scale 1.2
+hide footbox
+
+participant Device order 10
+box "Hono"
+    participant "Protocol Adapter\ninstance #1" order 30
+    participant "Protocol Adapter\ninstance #2" order 40
+    participant "Device Connection\nAPI component" order 50
+end box
+participant "AMQP messaging \nnetwork" order 60
+participant Application order 70
+
+autonumber 0
+
+"Protocol Adapter\ninstance #2" -> "AMQP messaging \nnetwork": Consumer link on \n"command/TENANT"\ncreated for another \nsubscription
+
+note over Device
+The device is connected and
+authenticated with TENANT/4711
+end note
+
+group Command subscription
+
+    Device -> "Protocol Adapter\ninstance #1": Command subscription\n / TTD request
+    activate "Protocol Adapter\ninstance #1"
+
+    "Protocol Adapter\ninstance #1" -> "AMQP messaging \nnetwork": attach("receiver", "command/TENANT")
+    "Protocol Adapter\ninstance #1" -> "Device Connection\nAPI component": set command handling adapter instance \nfor device 4711 to adapter instance #1
+
+    "Protocol Adapter\ninstance #1" -> Application: transfer("event/TENANT","4711","ttd=${ttd}")  via AMQP messaging network
+    activate Application
+end
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.4+11-post-Ubuntu-1ubuntu218.04.3
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/concepts/command_control_concept_delegate_2.svg b/docs/1.2/concepts/command_control_concept_delegate_2.svg
new file mode 100644
index 0000000..ac27c16
--- /dev/null
+++ b/docs/1.2/concepts/command_control_concept_delegate_2.svg
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="643.2px" preserveAspectRatio="none" style="width:1296px;height:643px;" version="1.1" viewBox="0 0 1296 643" width="1296px" zoomAndPan="magnify"><defs><filter height="300%" id="ffihz7kya2wlh" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="617.1" style="stroke: #A80036; stroke-width: 1.2;" width="708" x="201.6" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="532.8" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="159.3563" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="451.8" y="316.7063"/><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="809.4" y="369.825"/><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="996.6" y="476.0625"/><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="498.6281" style="stroke: #000000; stroke-width: 2.4;" width="1267.2" x="15.6" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="66" x2="66" y1="89.6719" y2="629.1"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="285.6" x2="285.6" y1="89.6719" y2="629.1"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="457.2" x2="457.2" y1="89.6719" y2="629.1"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="814.8" x2="814.8" y1="89.6719" y2="629.1"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1002" x2="1002" y1="89.6719" y2="629.1"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1214.4" x2="1214.4" y1="89.6719" y2="629.1"/><rect fill="#FEFECE" filter="url(#ffihz7kya2wlh)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="27.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="36" y="71.3098">Device</text><rect fill="#FEFECE" filter="url(#ffihz7kya2wlh)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="206.4" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="214.8" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="233.4" y="71.3098">instance #1</text><rect fill="#FEFECE" filter="url(#ffihz7kya2wlh)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="378" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="386.4" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="405" y="71.3098">instance #2</text><rect fill="#FEFECE" filter="url(#ffihz7kya2wlh)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="726" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="734.4" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="750" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#ffihz7kya2wlh)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="916.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="925.2" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="966.6" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#ffihz7kya2wlh)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1159.2" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1167.6" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="159.3563" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="451.8" y="316.7063"/><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="809.4" y="369.825"/><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="996.6" y="476.0625"/><path d="M15.6,110.0719 L242.4,110.0719 L242.4,118.4719 L230.4,130.4719 L15.6,130.4719 L15.6,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="498.6281" style="stroke: #000000; stroke-width: 2.4;" width="1267.2" x="15.6" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="33.6" y="125.7521">Command handling</text><polygon fill="#A80036" points="1015.8,187.5094,1003.8,192.3094,1015.8,197.1094,1011,192.3094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1008.6" x2="1213.8" y1="192.3094" y2="192.3094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="1023" y="168.0709">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="1038.6" y="149.9115">attach("receiver",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="168" x="1038.6" y="168.0709">"command_response/</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="1043.4" y="186.2303">TENANT/${replyId}")</text><polygon fill="#A80036" points="1015.8,240.6281,1003.8,245.4281,1015.8,250.2281,1011,245.4281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1008.6" x2="1213.8" y1="245.4281" y2="245.4281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="1023" y="230.2693">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="124.8" x="1038.6" y="221.1896">attach("sender",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="162" x="1038.6" y="239.349">"command/TENANT")</text><polygon fill="#A80036" points="477,311.9063,465,316.7063,477,321.5062,472.2,316.7063" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="469.8" x2="1213.8" y1="316.7063" y2="316.7063"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="484.2" y="292.4678">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="226.8" x="499.8" y="274.3084">transfer("command/TENANT",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="504.6" y="292.4678">"command/TENANT/4711","${payload}")</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="514.2" y="310.6271">via AMQP messaging network</text><polygon fill="#A80036" points="795,365.025,807,369.825,795,374.625,799.8,369.825" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="463.8" x2="802.2" y1="369.825" y2="369.825"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="472.2" y="354.6662">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="242.4" x="487.8" y="345.5865">get command handling adapter</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="195.6" x="487.8" y="363.7459">instances for device 4711</text><polygon fill="#A80036" points="477,418.1438,465,422.9437,477,427.7438,472.2,422.9437" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 2.0,2.0;" x1="469.8" x2="814.2" y1="422.9437" y2="422.9437"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="484.2" y="407.785">5</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="296.4" x="499.8" y="398.7053">JSON containing adapter instance "#1"</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="236.4" x="499.8" y="416.8646">handling commands for "4711"</text><polygon fill="#A80036" points="982.2,471.2625,994.2,476.0625,982.2,480.8625,987,476.0625" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="457.8" x2="989.4" y1="476.0625" y2="476.0625"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="466.2" y="460.9037">6</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="254.4" x="481.8" y="451.824">transfer("command_internal/#1",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="486.6" y="469.9834">"command/TENANT/4711","${payload}")</text><polygon fill="#A80036" points="299.4,524.3813,287.4,529.1813,299.4,533.9812,294.6,529.1813" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="292.2" x2="1001.4" y1="529.1813" y2="529.1813"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="306.6" y="514.0225">7</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="254.4" x="322.2" y="504.9428">transfer("command_internal/#1",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="327" y="523.1021">"command/TENANT/4711","${payload}")</text><polygon fill="#A80036" points="79.8,559.3406,67.8,564.1406,79.8,568.9406,75,564.1406" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="72.6" x2="285" y1="564.1406" y2="564.1406"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="87" y="558.0615">8</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="175.2" x="102.6" y="558.0615">Command is published</text><polygon fill="#A80036" points="1200.6,594.3,1212.6,599.1,1200.6,603.9,1205.4,599.1" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="286.2" x2="1207.8" y1="599.1" y2="599.1"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="294.6" y="593.0209">9</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="411.6" x="310.2" y="593.0209">disposition("accepted")  via AMQP messaging network</text><!--MD5=[3bd9add0052cc62a66bf16f931f011f7]
+@startuml
+scale 1.2
+hide footbox
+
+participant Device order 10
+box "Hono"
+    participant "Protocol Adapter\ninstance #1" order 30
+    participant "Protocol Adapter\ninstance #2" order 40
+    participant "Device Connection\nAPI component" order 50
+end box
+participant "AMQP messaging \nnetwork" order 60
+participant Application order 70
+
+autonumber
+
+group Command handling
+
+    Application -> "AMQP messaging \nnetwork": attach("receiver", \n"command_response/\n TENANT/${replyId}")
+    Application -> "AMQP messaging \nnetwork": attach("sender", \n"command/TENANT")
+
+    Application -> "Protocol Adapter\ninstance #2": transfer("command/TENANT",\n "command/TENANT/4711","${payload}")\n   via AMQP messaging network
+    activate "Protocol Adapter\ninstance #2"
+
+    "Protocol Adapter\ninstance #2" -> "Device Connection\nAPI component": get command handling adapter \ninstances for device 4711
+    activate "Device Connection\nAPI component"
+    return JSON containing adapter instance "#1" \nhandling commands for "4711"
+
+    "Protocol Adapter\ninstance #2" -> "AMQP messaging \nnetwork": transfer("command_internal/#1",\n "command/TENANT/4711","${payload}")
+    deactivate "Protocol Adapter\ninstance #2"
+    activate "AMQP messaging \nnetwork"
+    "AMQP messaging \nnetwork" -> "Protocol Adapter\ninstance #1": transfer("command_internal/#1",\n "command/TENANT/4711","${payload}")
+    deactivate "AMQP messaging \nnetwork"
+
+    "Protocol Adapter\ninstance #1" -> Device: Command is published
+    "Protocol Adapter\ninstance #1" -> Application: disposition("accepted")  via AMQP messaging network
+end
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.4+11-post-Ubuntu-1ubuntu218.04.3
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/concepts/command_control_concept_delegate_3.svg b/docs/1.2/concepts/command_control_concept_delegate_3.svg
new file mode 100644
index 0000000..c6d3f17
--- /dev/null
+++ b/docs/1.2/concepts/command_control_concept_delegate_3.svg
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="316.8px" preserveAspectRatio="none" style="width:1051px;height:316px;" version="1.1" viewBox="0 0 1051 316" width="1051.2px" zoomAndPan="magnify"><defs><filter height="300%" id="f5wjt7gogzi89" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="299.8219" style="stroke: #A80036; stroke-width: 1.2;" width="340.8" x="237.6" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="385.2" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f5wjt7gogzi89)" height="108.6375" style="stroke: #000000; stroke-width: 2.4;" width="1022.4" x="15.6" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="66" x2="66" y1="89.6719" y2="239.1094"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="321.6" x2="321.6" y1="89.6719" y2="239.1094"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="493.2" x2="493.2" y1="89.6719" y2="239.1094"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="670.8" x2="670.8" y1="89.6719" y2="239.1094"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="969.6" x2="969.6" y1="89.6719" y2="239.1094"/><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="27.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="36" y="71.3098">Device</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="27.6" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="36" y="261.9035">Device</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="242.4" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="250.8" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="276.6" y="71.3098">instance 1</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="242.4" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="250.8" y="261.9035">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="276.6" y="281.4598">instance 1</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="414" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="422.4" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="448.2" y="71.3098">instance 2</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="414" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="422.4" y="261.9035">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="448.2" y="281.4598">instance 2</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="585.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="594" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="635.4" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="585.6" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="594" y="261.9035">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="635.4" y="281.4598">network</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="914.4" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="922.8" y="71.3098">Application</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="914.4" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="922.8" y="261.9035">Application</text><path d="M15.6,110.0719 L330,110.0719 L330,118.4719 L318,130.4719 L15.6,130.4719 L15.6,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="108.6375" style="stroke: #000000; stroke-width: 2.4;" width="1022.4" x="15.6" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="260.4" x="33.6" y="125.7521">Command response handling</text><polygon fill="#A80036" points="307.8,151.1906,319.8,155.9906,307.8,160.7906,312.6,155.9906" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="66.6" x2="315" y1="155.9906" y2="155.9906"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="75" y="149.9115">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="211.2" x="90.6" y="149.9115">Command response is sent</text><polygon fill="#A80036" points="955.8,204.3094,967.8,209.1094,955.8,213.9094,960.6,209.1094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="322.2" x2="963" y1="209.1094" y2="209.1094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="330.6" y="193.9506">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="603.6" x="346.2" y="184.8709">transfer("command_response/TENANT/${replyId}","status=200","${payload}")</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="355.8" y="203.0303">via AMQP messaging network</text><!--MD5=[5e5ec6ad238f39ba1a44ff34d08a44f9]
+@startuml
+scale 1.2
+
+participant Device order 10
+box "Hono"
+    participant "Protocol Adapter\ninstance 1" order 30
+    participant "Protocol Adapter\ninstance 2" order 40
+end box
+participant "AMQP messaging \nnetwork" order 60
+participant Application order 70
+
+autonumber
+
+group Command response handling
+
+    Device -> "Protocol Adapter\ninstance 1": Command response is sent
+    "Protocol Adapter\ninstance 1" -> Application: transfer("command_response/TENANT/${replyId}","status=200","${payload}")\n  via AMQP messaging network
+    deactivate "Protocol Adapter\ninstance 1"
+    deactivate Application
+end
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.4+11-post-Ubuntu-1ubuntu218.04.3
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/concepts/command_control_concept_gateway_1.svg b/docs/1.2/concepts/command_control_concept_gateway_1.svg
new file mode 100644
index 0000000..df1dad1
--- /dev/null
+++ b/docs/1.2/concepts/command_control_concept_gateway_1.svg
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="578.4px" preserveAspectRatio="none" style="width:1095px;height:578px;" version="1.1" viewBox="0 0 1095 578" width="1095.6px" zoomAndPan="magnify"><defs><filter height="300%" id="fxufgiin6qiiw" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="553.0219" style="stroke: #A80036; stroke-width: 1.2;" width="420" x="294" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="481.2" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#fxufgiin6qiiw)" height="231.675" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="372.6" y="322.5469"/><rect fill="#FFFFFF" filter="url(#fxufgiin6qiiw)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1008.6" y="535.0219"/><rect fill="#FFFFFF" filter="url(#fxufgiin6qiiw)" height="351.2719" style="stroke: #000000; stroke-width: 2.4;" width="1068" x="14.4" y="193.35"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="156" x2="156" y1="89.6719" y2="565.0219"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="378" x2="378" y1="89.6719" y2="565.0219"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="619.2" x2="619.2" y1="89.6719" y2="565.0219"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="806.4" x2="806.4" y1="89.6719" y2="565.0219"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1014" x2="1014" y1="89.6719" y2="565.0219"/><rect fill="#FEFECE" filter="url(#fxufgiin6qiiw)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="110.4" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="118.8" y="71.3098">Gateway</text><rect fill="#FEFECE" filter="url(#fxufgiin6qiiw)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="298.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="307.2" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="325.8" y="71.3098">instance #1</text><rect fill="#FEFECE" filter="url(#fxufgiin6qiiw)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="530.4" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="538.8" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="554.4" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#fxufgiin6qiiw)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="721.2" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="729.6" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="771" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#fxufgiin6qiiw)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="958.8" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="967.2" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#fxufgiin6qiiw)" height="231.675" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="372.6" y="322.5469"/><rect fill="#FFFFFF" filter="url(#fxufgiin6qiiw)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1008.6" y="535.0219"/><path d="M28.8,107.6719 L28.8,173.6719 L279.6,173.6719 L279.6,119.6719 L267.6,107.6719 L28.8,107.6719 " fill="#FBFB77" filter="url(#fxufgiin6qiiw)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M267.6,107.6719 L267.6,119.6719 L279.6,119.6719 L267.6,107.6719 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="160.8" x="36" y="128.1521">The gateway 'gw-1' is</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="36" y="146.3115">connected and authenticated</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="136.8" x="36" y="164.4709">with TENANT/gw-1</text><path d="M14.4,193.35 L273.6,193.35 L273.6,201.75 L261.6,213.75 L14.4,213.75 L14.4,193.35 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="351.2719" style="stroke: #000000; stroke-width: 2.4;" width="1068" x="14.4" y="193.35"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="32.4" y="209.0303">Command subscription</text><path d="M26.4,219.9094 L26.4,267.9094 L280.8,267.9094 L280.8,231.9094 L268.8,219.9094 L26.4,219.9094 " fill="#FBFB77" filter="url(#fxufgiin6qiiw)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M268.8,219.9094 L268.8,231.9094 L280.8,231.9094 L268.8,219.9094 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="182.4" x="33.6" y="240.3896">The gateway subscribes</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="229.2" x="33.6" y="258.549">to commands for device 4711</text><polygon fill="#A80036" points="358.2,317.7469,370.2,322.5469,358.2,327.3469,363,322.5469" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="156.6" x2="365.4" y1="322.5469" y2="322.5469"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="165" y="307.3881">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="180.6" y="298.3084">Command subscription</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="102" x="185.4" y="316.4678">/ TTD request</text><polygon fill="#A80036" points="792.6,352.7063,804.6,357.5062,792.6,362.3063,797.4,357.5062" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="384.6" x2="799.8" y1="357.5062" y2="357.5062"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="393" y="351.4271">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="300" x="408.6" y="351.4271">attach("receiver", "command/TENANT")</text><polygon fill="#A80036" points="605.4,442.1438,617.4,446.9437,605.4,451.7438,610.2,446.9437" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="384.6" x2="612.6" y1="446.9437" y2="446.9437"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="393" y="413.6256">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="408.6" y="386.3865">set command handling</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="129.6" x="408.6" y="404.5459">adapter instance</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="117.6" x="408.6" y="422.7053">for device 4711</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="408.6" y="440.8646">to adapter instance #1</text><polygon fill="#A80036" points="605.4,495.2625,617.4,500.0625,605.4,504.8625,610.2,500.0625" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="384.6" x2="612.6" y1="500.0625" y2="500.0625"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="393" y="484.9037">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="408.6" y="475.824">set last known gateway</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="190.8" x="408.6" y="493.9834">for device 4711 to "gw-1"</text><polygon fill="#A80036" points="994.2,530.2219,1006.2,535.0219,994.2,539.8219,999,535.0219" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="384.6" x2="1001.4" y1="535.0219" y2="535.0219"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="393" y="528.9428">5</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="585.6" x="408.6" y="528.9428">transfer("event/TENANT","4711","ttd=${ttd}")  via AMQP messaging network</text><!--MD5=[c8432a7ae55787c91cc1391650da3925]
+@startuml
+scale 1.2
+hide footbox
+
+participant Gateway order 20
+box "Hono"
+    participant "Protocol Adapter\ninstance #1" order 30
+    participant "Device Connection\nAPI component" order 50
+end box
+participant "AMQP messaging \nnetwork" order 60
+participant Application order 70
+
+autonumber
+
+note over Gateway
+The gateway 'gw-1' is
+connected and authenticated
+with TENANT/gw-1
+end note
+
+group Command subscription
+    note over Gateway
+    The gateway subscribes
+    to commands for device 4711
+    end note
+    Gateway -> "Protocol Adapter\ninstance #1": Command subscription\n / TTD request
+    activate "Protocol Adapter\ninstance #1"
+
+    "Protocol Adapter\ninstance #1" -> "AMQP messaging \nnetwork": attach("receiver", "command/TENANT")
+    "Protocol Adapter\ninstance #1" -> "Device Connection\nAPI component": set command handling \nadapter instance \nfor device 4711 \nto adapter instance #1
+
+    "Protocol Adapter\ninstance #1" -> "Device Connection\nAPI component": set last known gateway \nfor device 4711 to "gw-1"
+    "Protocol Adapter\ninstance #1" -> Application: transfer("event/TENANT","4711","ttd=${ttd}")  via AMQP messaging network
+    activate Application
+end
+
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.4+11-post-Ubuntu-1ubuntu218.04.3
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/concepts/command_control_concept_gateway_2.svg b/docs/1.2/concepts/command_control_concept_gateway_2.svg
new file mode 100644
index 0000000..04f0e4e
--- /dev/null
+++ b/docs/1.2/concepts/command_control_concept_gateway_2.svg
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="685.2px" preserveAspectRatio="none" style="width:1194px;height:685px;" version="1.1" viewBox="0 0 1194 685" width="1194px" zoomAndPan="magnify"><defs><filter height="300%" id="f160zighuzisgk" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="659.2594" style="stroke: #A80036; stroke-width: 1.2;" width="530.4" x="277.2" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="519.6" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f160zighuzisgk)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="707.4" y="351.6656"/><rect fill="#FFFFFF" filter="url(#f160zighuzisgk)" height="540.7875" style="stroke: #000000; stroke-width: 2.4;" width="1166.4" x="14.4" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="141.6" x2="141.6" y1="89.6719" y2="671.2594"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="361.2" x2="361.2" y1="89.6719" y2="671.2594"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="712.8" x2="712.8" y1="89.6719" y2="671.2594"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="900" x2="900" y1="89.6719" y2="671.2594"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1112.4" x2="1112.4" y1="89.6719" y2="671.2594"/><rect fill="#FEFECE" filter="url(#f160zighuzisgk)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="96" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="104.4" y="71.3098">Gateway</text><rect fill="#FEFECE" filter="url(#f160zighuzisgk)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="282" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="290.4" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="309" y="71.3098">instance #1</text><rect fill="#FEFECE" filter="url(#f160zighuzisgk)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="624" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="632.4" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="648" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f160zighuzisgk)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="814.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="823.2" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="864.6" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f160zighuzisgk)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1057.2" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1065.6" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#f160zighuzisgk)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="707.4" y="351.6656"/><path d="M14.4,110.0719 L241.2,110.0719 L241.2,118.4719 L229.2,130.4719 L14.4,130.4719 L14.4,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="540.7875" style="stroke: #000000; stroke-width: 2.4;" width="1166.4" x="14.4" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="32.4" y="125.7521">Command handling</text><polygon fill="#A80036" points="913.8,187.5094,901.8,192.3094,913.8,197.1094,909,192.3094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="906.6" x2="1111.8" y1="192.3094" y2="192.3094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="921" y="168.0709">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="936.6" y="149.9115">attach("receiver",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="168" x="936.6" y="168.0709">"command_response/</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="941.4" y="186.2303">TENANT/${replyId}")</text><polygon fill="#A80036" points="913.8,240.6281,901.8,245.4281,913.8,250.2281,909,245.4281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="906.6" x2="1111.8" y1="245.4281" y2="245.4281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="921" y="230.2693">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="124.8" x="936.6" y="221.1896">attach("sender",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="162" x="936.6" y="239.349">"command/TENANT")</text><polygon fill="#A80036" points="375,293.7469,363,298.5469,375,303.3469,370.2,298.5469" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="367.8" x2="1111.8" y1="298.5469" y2="298.5469"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="382.2" y="283.3881">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="542.4" x="397.8" y="274.3084">transfer("command/TENANT", "command/TENANT/4711","${payload}")</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="412.2" y="292.4678">via AMQP messaging network</text><polygon fill="#A80036" points="693,346.8656,705,351.6656,693,356.4656,697.8,351.6656" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="361.8" x2="700.2" y1="351.6656" y2="351.6656"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="370.2" y="336.5068">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="242.4" x="385.8" y="327.4271">get command handling adapter</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="195.6" x="385.8" y="345.5865">instances for device 4711</text><polygon fill="#A80036" points="375,399.9844,363,404.7844,375,409.5844,370.2,404.7844" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 2.0,2.0;" x1="367.8" x2="712.2" y1="404.7844" y2="404.7844"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="382.2" y="389.6256">5</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="296.4" x="397.8" y="380.5459">JSON containing adapter instance "#1"</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="236.4" x="397.8" y="398.7053">handling commands for "4711"</text><path d="M220.8,420.3844 L220.8,504.3844 L496.8,504.3844 L496.8,432.3844 L484.8,420.3844 L220.8,420.3844 " fill="#FBFB77" filter="url(#f160zighuzisgk)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M484.8,420.3844 L484.8,432.3844 L496.8,432.3844 L484.8,420.3844 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="248.4" x="228" y="440.8646">Command is already at the right</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="238.8" x="228" y="459.024">adapter instance, gets handled</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="250.8" x="228" y="477.1834">by command handler associated</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="87.6" x="228" y="495.3428">with "gw-1".</text><polygon fill="#A80036" points="155.4,536.3813,143.4,541.1813,155.4,545.9812,150.6,541.1813" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="148.2" x2="360.6" y1="541.1813" y2="541.1813"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="162.6" y="535.1021">6</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="175.2" x="178.2" y="535.1021">Command is published</text><path d="M26.4,556.7813 L26.4,604.7813 L252,604.7813 L252,568.7813 L240,556.7813 L26.4,556.7813 " fill="#FBFB77" filter="url(#f160zighuzisgk)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M240,556.7813 L240,568.7813 L252,568.7813 L240,556.7813 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="33.6" y="577.2615">The gateway sends the</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="200.4" x="33.6" y="595.4209">command to device 4711.</text><polygon fill="#A80036" points="1098.6,636.4594,1110.6,641.2594,1098.6,646.0594,1103.4,641.2594" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="361.8" x2="1105.8" y1="641.2594" y2="641.2594"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="370.2" y="635.1803">7</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="411.6" x="385.8" y="635.1803">disposition("accepted")  via AMQP messaging network</text><!--MD5=[40c7e1303a3221224bab616aecbb0475]
+@startuml
+scale 1.2
+hide footbox
+
+participant Gateway order 20
+box "Hono"
+    participant "Protocol Adapter\ninstance #1" order 30
+    participant "Device Connection\nAPI component" order 50
+end box
+participant "AMQP messaging \nnetwork" order 60
+participant Application order 70
+
+autonumber
+
+group Command handling
+
+    Application -> "AMQP messaging \nnetwork": attach("receiver", \n"command_response/\n TENANT/${replyId}")
+    Application -> "AMQP messaging \nnetwork": attach("sender", \n"command/TENANT")
+
+    Application -> "Protocol Adapter\ninstance #1": transfer("command/TENANT", "command/TENANT/4711","${payload}")\n   via AMQP messaging network
+
+    "Protocol Adapter\ninstance #1" -> "Device Connection\nAPI component": get command handling adapter \ninstances for device 4711
+    activate "Device Connection\nAPI component"
+    return JSON containing adapter instance "#1" \nhandling commands for "4711"
+
+    note over "Protocol Adapter\ninstance #1"
+    Command is already at the right
+    adapter instance, gets handled
+    by command handler associated
+    with "gw-1".
+    end note
+
+    "Protocol Adapter\ninstance #1" -> Gateway: Command is published
+    note over Gateway
+    The gateway sends the
+    command to device 4711.
+    end note
+    "Protocol Adapter\ninstance #1" -> Application: disposition("accepted")  via AMQP messaging network
+end
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.4+11-post-Ubuntu-1ubuntu218.04.3
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/concepts/command_control_concept_gateway_3.svg b/docs/1.2/concepts/command_control_concept_gateway_3.svg
new file mode 100644
index 0000000..2a5499e
--- /dev/null
+++ b/docs/1.2/concepts/command_control_concept_gateway_3.svg
@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="382.8px" preserveAspectRatio="none" style="width:1046px;height:382px;" version="1.1" viewBox="0 0 1046 382" width="1046.4px" zoomAndPan="magnify"><defs><filter height="300%" id="f1syi2mmgw2dx7" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="364.9406" style="stroke: #A80036; stroke-width: 1.2;" width="360" x="358.8" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="516" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f1syi2mmgw2dx7)" height="173.7563" style="stroke: #000000; stroke-width: 2.4;" width="1018.8" x="14.4" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="187.2" x2="187.2" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="442.8" x2="442.8" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="624" x2="624" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="811.2" x2="811.2" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="964.8" x2="964.8" y1="89.6719" y2="304.2281"/><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="141.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="150" y="71.3098">Gateway</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="141.6" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="150" y="327.0223">Gateway</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="363.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="372" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="397.8" y="71.3098">instance 1</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="363.6" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="372" y="327.0223">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="397.8" y="346.5785">instance 1</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="535.2" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="543.6" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="559.2" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="535.2" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="543.6" y="327.0223">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="559.2" y="346.5785">API component</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="726" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="734.4" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="775.8" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="726" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="734.4" y="327.0223">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="775.8" y="346.5785">network</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="909.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="918" y="71.3098">Application</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="909.6" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="918" y="327.0223">Application</text><path d="M14.4,110.0719 L328.8,110.0719 L328.8,118.4719 L316.8,130.4719 L14.4,130.4719 L14.4,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="173.7563" style="stroke: #000000; stroke-width: 2.4;" width="1018.8" x="14.4" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="260.4" x="32.4" y="125.7521">Command response handling</text><path d="M26.4,136.6313 L26.4,184.6313 L343.2,184.6313 L343.2,148.6313 L331.2,136.6313 L26.4,136.6313 " fill="#FBFB77" filter="url(#f1syi2mmgw2dx7)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M331.2,136.6313 L331.2,148.6313 L343.2,148.6313 L331.2,136.6313 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="194.4" x="33.6" y="157.1115">The gateway receives the</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="291.6" x="33.6" y="175.2709">command response from device 4711</text><polygon fill="#A80036" points="429,216.3094,441,221.1094,429,225.9094,433.8,221.1094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="187.8" x2="436.2" y1="221.1094" y2="221.1094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="196.2" y="215.0303">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="211.2" x="211.8" y="215.0303">Command response is sent</text><polygon fill="#A80036" points="951,269.4281,963,274.2281,951,279.0281,955.8,274.2281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="443.4" x2="958.2" y1="274.2281" y2="274.2281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="451.8" y="259.0693">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="390" x="467.4" y="249.9896">transfer("command_response/TENANT/${replyId}",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="453.6" x="472.2" y="268.149">"status=200","${payload}")   via AMQP messaging network</text><!--MD5=[314ae5857e0e2e146e21c67a08eb6e9b]
+@startuml
+scale 1.2
+
+participant Gateway order 20
+box "Hono"
+    participant "Protocol Adapter\ninstance 1" order 30
+    participant "Device Connection\nAPI component" order 50
+end box
+participant "AMQP messaging \nnetwork" order 60
+participant Application order 70
+
+autonumber
+
+group Command response handling
+    note over Gateway
+    The gateway receives the
+    command response from device 4711
+    end note
+    Gateway -> "Protocol Adapter\ninstance 1": Command response is sent
+    "Protocol Adapter\ninstance 1" -> Application: transfer("command_response/TENANT/${replyId}",\n "status=200","${payload}")   via AMQP messaging network
+    deactivate "Protocol Adapter\ninstance 1"
+    deactivate Application
+end
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.4+11-post-Ubuntu-1ubuntu218.04.3
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/concepts/command_control_concept_gateway_all_devices_1.svg b/docs/1.2/concepts/command_control_concept_gateway_all_devices_1.svg
new file mode 100644
index 0000000..d9a2b1a
--- /dev/null
+++ b/docs/1.2/concepts/command_control_concept_gateway_all_devices_1.svg
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="543.6px" preserveAspectRatio="none" style="width:1074px;height:543px;" version="1.1" viewBox="0 0 1074 543" width="1074px" zoomAndPan="magnify"><defs><filter height="300%" id="f1jklk7noazmnx" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="518.0625" style="stroke: #A80036; stroke-width: 1.2;" width="410.4" x="274.8" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="457.2" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f1jklk7noazmnx)" height="178.5563" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="353.4" y="340.7063"/><rect fill="#FFFFFF" filter="url(#f1jklk7noazmnx)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="987" y="500.0625"/><rect fill="#FFFFFF" filter="url(#f1jklk7noazmnx)" height="316.3125" style="stroke: #000000; stroke-width: 2.4;" width="1041.6" x="19.2" y="193.35"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="136.8" x2="136.8" y1="89.6719" y2="530.0625"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="358.8" x2="358.8" y1="89.6719" y2="530.0625"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="590.4" x2="590.4" y1="89.6719" y2="530.0625"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="777.6" x2="777.6" y1="89.6719" y2="530.0625"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="992.4" x2="992.4" y1="89.6719" y2="530.0625"/><rect fill="#FEFECE" filter="url(#f1jklk7noazmnx)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="91.2" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="99.6" y="71.3098">Gateway</text><rect fill="#FEFECE" filter="url(#f1jklk7noazmnx)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="279.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="288" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="306.6" y="71.3098">instance #1</text><rect fill="#FEFECE" filter="url(#f1jklk7noazmnx)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="501.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="510" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="525.6" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f1jklk7noazmnx)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="692.4" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="700.8" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="742.2" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f1jklk7noazmnx)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="937.2" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="945.6" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#f1jklk7noazmnx)" height="178.5563" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="353.4" y="340.7063"/><rect fill="#FFFFFF" filter="url(#f1jklk7noazmnx)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="987" y="500.0625"/><path d="M9.6,107.6719 L9.6,173.6719 L260.4,173.6719 L260.4,119.6719 L248.4,107.6719 L9.6,107.6719 " fill="#FBFB77" filter="url(#f1jklk7noazmnx)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M248.4,107.6719 L248.4,119.6719 L260.4,119.6719 L248.4,107.6719 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="160.8" x="16.8" y="128.1521">The gateway 'gw-1' is</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="16.8" y="146.3115">connected and authenticated</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="136.8" x="16.8" y="164.4709">with TENANT/gw-1</text><path d="M19.2,193.35 L278.4,193.35 L278.4,201.75 L266.4,213.75 L19.2,213.75 L19.2,193.35 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="316.3125" style="stroke: #000000; stroke-width: 2.4;" width="1041.6" x="19.2" y="193.35"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="37.2" y="209.0303">Command subscription</text><path d="M31.2,219.9094 L31.2,285.9094 L238.8,285.9094 L238.8,231.9094 L226.8,219.9094 L31.2,219.9094 " fill="#FBFB77" filter="url(#f1jklk7noazmnx)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M226.8,219.9094 L226.8,231.9094 L238.8,231.9094 L226.8,219.9094 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="182.4" x="38.4" y="240.3896">The gateway subscribes</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="38.4" y="258.549">to commands just as a</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="156" x="38.4" y="276.7084">normal device would</text><polygon fill="#A80036" points="339,335.9063,351,340.7063,339,345.5062,343.8,340.7063" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="137.4" x2="346.2" y1="340.7063" y2="340.7063"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="145.8" y="325.5475">0</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="161.4" y="316.4678">Command subscription</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="102" x="166.2" y="334.6271">/ TTD request</text><polygon fill="#A80036" points="763.8,370.8656,775.8,375.6656,763.8,380.4656,768.6,375.6656" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="365.4" x2="771" y1="375.6656" y2="375.6656"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="373.8" y="369.5865">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="300" x="389.4" y="369.5865">attach("receiver", "command/TENANT")</text><polygon fill="#A80036" points="576.6,460.3031,588.6,465.1031,576.6,469.9031,581.4,465.1031" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="365.4" x2="583.8" y1="465.1031" y2="465.1031"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="373.8" y="431.785">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="389.4" y="404.5459">set command handling</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="129.6" x="389.4" y="422.7053">adapter instance</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="122.4" x="389.4" y="440.8646">for device 'gw-1'</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="389.4" y="459.024">to adapter instance #1</text><polygon fill="#A80036" points="972.6,495.2625,984.6,500.0625,972.6,504.8625,977.4,500.0625" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="365.4" x2="979.8" y1="500.0625" y2="500.0625"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="373.8" y="493.9834">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="583.2" x="389.4" y="493.9834">transfer("event/TENANT","gw-1","ttd=${ttd}")  via AMQP messaging network</text><!--MD5=[93e2f9ddcc703299e7ec00e54289c11f]
+@startuml
+scale 1.2
+hide footbox
+
+participant Gateway order 20
+box "Hono"
+    participant "Protocol Adapter\ninstance #1" order 30
+    participant "Device Connection\nAPI component" order 50
+end box
+participant "AMQP messaging \nnetwork" order 60
+participant Application order 70
+
+autonumber 0
+
+note over Gateway
+The gateway 'gw-1' is
+connected and authenticated
+with TENANT/gw-1
+end note
+
+group Command subscription
+    note over Gateway
+    The gateway subscribes
+    to commands just as a
+    normal device would
+    end note
+    Gateway -> "Protocol Adapter\ninstance #1": Command subscription\n / TTD request
+    activate "Protocol Adapter\ninstance #1"
+
+    "Protocol Adapter\ninstance #1" -> "AMQP messaging \nnetwork": attach("receiver", "command/TENANT")
+    "Protocol Adapter\ninstance #1" -> "Device Connection\nAPI component": set command handling \nadapter instance \nfor device 'gw-1' \nto adapter instance #1
+
+    "Protocol Adapter\ninstance #1" -> Application: transfer("event/TENANT","gw-1","ttd=${ttd}")  via AMQP messaging network
+    activate Application
+end
+
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.4+11-post-Ubuntu-1ubuntu218.04.3
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/concepts/command_control_concept_gateway_all_devices_2.svg b/docs/1.2/concepts/command_control_concept_gateway_all_devices_2.svg
new file mode 100644
index 0000000..5995a16
--- /dev/null
+++ b/docs/1.2/concepts/command_control_concept_gateway_all_devices_2.svg
@@ -0,0 +1,56 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="750px" preserveAspectRatio="none" style="width:1194px;height:750px;" version="1.1" viewBox="0 0 1194 750" width="1194px" zoomAndPan="magnify"><defs><filter height="300%" id="f1h6xgtolsw5l8" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="724.3781" style="stroke: #A80036; stroke-width: 1.2;" width="530.4" x="277.2" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="519.6" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f1h6xgtolsw5l8)" height="136.3969" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="707.4" y="351.6656"/><rect fill="#FFFFFF" filter="url(#f1h6xgtolsw5l8)" height="605.9063" style="stroke: #000000; stroke-width: 2.4;" width="1166.4" x="14.4" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="141.6" x2="141.6" y1="89.6719" y2="736.3781"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="361.2" x2="361.2" y1="89.6719" y2="736.3781"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="712.8" x2="712.8" y1="89.6719" y2="736.3781"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="900" x2="900" y1="89.6719" y2="736.3781"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1112.4" x2="1112.4" y1="89.6719" y2="736.3781"/><rect fill="#FEFECE" filter="url(#f1h6xgtolsw5l8)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="96" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="104.4" y="71.3098">Gateway</text><rect fill="#FEFECE" filter="url(#f1h6xgtolsw5l8)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="282" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="290.4" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="309" y="71.3098">instance #1</text><rect fill="#FEFECE" filter="url(#f1h6xgtolsw5l8)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="624" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="632.4" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="648" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f1h6xgtolsw5l8)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="814.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="823.2" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="864.6" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f1h6xgtolsw5l8)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1057.2" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1065.6" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#f1h6xgtolsw5l8)" height="136.3969" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="707.4" y="351.6656"/><path d="M14.4,110.0719 L241.2,110.0719 L241.2,118.4719 L229.2,130.4719 L14.4,130.4719 L14.4,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="605.9063" style="stroke: #000000; stroke-width: 2.4;" width="1166.4" x="14.4" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="32.4" y="125.7521">Command handling</text><polygon fill="#A80036" points="913.8,187.5094,901.8,192.3094,913.8,197.1094,909,192.3094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="906.6" x2="1111.8" y1="192.3094" y2="192.3094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="921" y="168.0709">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="936.6" y="149.9115">attach("receiver",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="168" x="936.6" y="168.0709">"command_response/</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="941.4" y="186.2303">TENANT/${replyId}")</text><polygon fill="#A80036" points="913.8,240.6281,901.8,245.4281,913.8,250.2281,909,245.4281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="906.6" x2="1111.8" y1="245.4281" y2="245.4281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="921" y="230.2693">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="124.8" x="936.6" y="221.1896">attach("sender",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="162" x="936.6" y="239.349">"command/TENANT")</text><polygon fill="#A80036" points="375,293.7469,363,298.5469,375,303.3469,370.2,298.5469" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="367.8" x2="1111.8" y1="298.5469" y2="298.5469"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="382.2" y="283.3881">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="542.4" x="397.8" y="274.3084">transfer("command/TENANT", "command/TENANT/4711","${payload}")</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="412.2" y="292.4678">via AMQP messaging network</text><polygon fill="#A80036" points="693,346.8656,705,351.6656,693,356.4656,697.8,351.6656" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="361.8" x2="700.2" y1="351.6656" y2="351.6656"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="370.2" y="336.5068">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="242.4" x="385.8" y="327.4271">get command handling adapter</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="195.6" x="385.8" y="345.5865">instances for device 4711</text><path d="M507.6,367.2656 L507.6,433.2656 L913.2,433.2656 L913.2,379.2656 L901.2,367.2656 L507.6,367.2656 " fill="#FBFB77" filter="url(#f1h6xgtolsw5l8)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M901.2,367.2656 L901.2,379.2656 L913.2,379.2656 L901.2,367.2656 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="380.4" x="514.8" y="387.7459">No adapter instance associated with device 4711,</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="294" x="514.8" y="405.9053">therefore check the gateways of 4711,</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="265.2" x="514.8" y="424.0646">preferably the last known gateway.</text><polygon fill="#A80036" points="375,483.2625,363,488.0625,375,492.8625,370.2,488.0625" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 2.0,2.0;" x1="367.8" x2="712.2" y1="488.0625" y2="488.0625"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="382.2" y="472.9037">5</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="296.4" x="397.8" y="463.824">JSON containing adapter instance "#1"</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="234" x="397.8" y="481.9834">handling commands for "gw-1"</text><path d="M222,503.6625 L222,569.6625 L495.6,569.6625 L495.6,515.6625 L483.6,503.6625 L222,503.6625 " fill="#FBFB77" filter="url(#f1h6xgtolsw5l8)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M483.6,503.6625 L483.6,515.6625 L495.6,515.6625 L483.6,503.6625 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="248.4" x="229.2" y="524.1428">Command is already at the right</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="238.8" x="229.2" y="542.3021">adapter instance, gets handled</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="246" x="229.2" y="560.4615">by command handler for "gw-1".</text><polygon fill="#A80036" points="155.4,601.5,143.4,606.3,155.4,611.1,150.6,606.3" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="148.2" x2="360.6" y1="606.3" y2="606.3"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="162.6" y="600.2209">6</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="175.2" x="178.2" y="600.2209">Command is published</text><path d="M26.4,621.9 L26.4,669.9 L252,669.9 L252,633.9 L240,621.9 L26.4,621.9 " fill="#FBFB77" filter="url(#f1h6xgtolsw5l8)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M240,621.9 L240,633.9 L252,633.9 L240,621.9 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="33.6" y="642.3803">The gateway sends the</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="200.4" x="33.6" y="660.5396">command to device 4711.</text><polygon fill="#A80036" points="1098.6,701.5781,1110.6,706.3781,1098.6,711.1781,1103.4,706.3781" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="361.8" x2="1105.8" y1="706.3781" y2="706.3781"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="370.2" y="700.299">7</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="411.6" x="385.8" y="700.299">disposition("accepted")  via AMQP messaging network</text><!--MD5=[60c34d2770f1fbce83cf895feefca606]
+@startuml
+scale 1.2
+hide footbox
+
+participant Gateway order 20
+box "Hono"
+    participant "Protocol Adapter\ninstance #1" order 30
+    participant "Device Connection\nAPI component" order 50
+end box
+participant "AMQP messaging \nnetwork" order 60
+participant Application order 70
+
+autonumber
+
+group Command handling
+
+    Application -> "AMQP messaging \nnetwork": attach("receiver", \n"command_response/\n TENANT/${replyId}")
+    Application -> "AMQP messaging \nnetwork": attach("sender", \n"command/TENANT")
+
+    Application -> "Protocol Adapter\ninstance #1": transfer("command/TENANT", "command/TENANT/4711","${payload}")\n   via AMQP messaging network
+
+    "Protocol Adapter\ninstance #1" -> "Device Connection\nAPI component": get command handling adapter \ninstances for device 4711
+    activate "Device Connection\nAPI component"
+    note over "Device Connection\nAPI component"
+    No adapter instance associated with device 4711,
+    therefore check the gateways of 4711,
+    preferably the last known gateway.
+    end note
+    return JSON containing adapter instance "#1" \nhandling commands for "gw-1"
+
+    note over "Protocol Adapter\ninstance #1"
+    Command is already at the right
+    adapter instance, gets handled
+    by command handler for "gw-1".
+    end note
+
+    "Protocol Adapter\ninstance #1" -> Gateway: Command is published
+    note over Gateway
+    The gateway sends the
+    command to device 4711.
+    end note
+    "Protocol Adapter\ninstance #1" -> Application: disposition("accepted")  via AMQP messaging network
+end
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.4+11-post-Ubuntu-1ubuntu218.04.3
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/concepts/command_control_concept_http.svg b/docs/1.2/concepts/command_control_concept_http.svg
new file mode 100644
index 0000000..4584ba5
--- /dev/null
+++ b/docs/1.2/concepts/command_control_concept_http.svg
@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="478.8px" preserveAspectRatio="none" style="width:1600px;height:478px;" version="1.1" viewBox="0 0 1600 478" width="1600.8px" zoomAndPan="magnify"><defs><filter height="300%" id="fo1zb0wqg7eoa" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#fo1zb0wqg7eoa)" height="139.8375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="822.6" y="83.3156"/><rect fill="#FFFFFF" filter="url(#fo1zb0wqg7eoa)" height="104.8781" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="822.6" y="305.0719"/><rect fill="#FFFFFF" filter="url(#fo1zb0wqg7eoa)" height="256.7156" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1530.6" y="118.275"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="169.2" x2="169.2" y1="45.9563" y2="431.55"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="828" x2="828" y1="45.9563" y2="431.55"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1536" x2="1536" y1="45.9563" y2="431.55"/><rect fill="#FEFECE" filter="url(#fo1zb0wqg7eoa)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="130.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="139.2" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#fo1zb0wqg7eoa)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="130.8" y="430.35"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="139.2" y="454.3441">Device</text><rect fill="#FEFECE" filter="url(#fo1zb0wqg7eoa)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="130.8" x="760.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="114" x="769.2" y="27.5941">HTTP Adapter</text><rect fill="#FEFECE" filter="url(#fo1zb0wqg7eoa)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="130.8" x="760.8" y="430.35"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="114" x="769.2" y="454.3441">HTTP Adapter</text><rect fill="#FEFECE" filter="url(#fo1zb0wqg7eoa)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1480.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1489.2" y="27.5941">Application</text><rect fill="#FEFECE" filter="url(#fo1zb0wqg7eoa)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1480.8" y="430.35"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1489.2" y="454.3441">Application</text><rect fill="#FFFFFF" filter="url(#fo1zb0wqg7eoa)" height="139.8375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="822.6" y="83.3156"/><rect fill="#FFFFFF" filter="url(#fo1zb0wqg7eoa)" height="104.8781" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="822.6" y="305.0719"/><rect fill="#FFFFFF" filter="url(#fo1zb0wqg7eoa)" height="256.7156" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1530.6" y="118.275"/><polygon fill="#A80036" points="808.2,78.5156,820.2,83.3156,808.2,88.1156,813,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="169.8" x2="815.4" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="380.4" x="178.2" y="77.2365">1. HTTP request ("POST", "/event", "hono-ttd=30")</text><polygon fill="#A80036" points="1516.2,113.475,1528.2,118.275,1516.2,123.075,1521,118.275" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="834.6" x2="1523.4" y1="118.275" y2="118.275"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="338.4" x="843" y="112.1959">2. transfer("event/TENANT","4711","ttd=30")</text><polygon fill="#A80036" points="847.8,148.4344,835.8,153.2344,847.8,158.0344,843,153.2344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="840.6" x2="1529.4" y1="153.2344" y2="153.2344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="380.4" x="855" y="147.1553">3. transfer("command/TENANT/4711","light","ON")</text><polygon fill="#A80036" points="183,183.3937,171,188.1938,183,192.9938,178.2,188.1938" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="175.8" x2="821.4" y1="188.1938" y2="188.1938"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="624" x="190.2" y="182.1146">4. HTTP response (("200", "hono-cmd=light", "hono-cmd-req-id=${reqId}"), "ON")</text><polygon fill="#A80036" points="1516.2,218.3531,1528.2,223.1531,1516.2,227.9531,1521,223.1531" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="828.6" x2="1523.4" y1="223.1531" y2="223.1531"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="837" y="217.074">disposition("accepted")</text><path d="M9.6,238.7531 L9.6,268.7531 L325.2,268.7531 L325.2,250.7531 L313.2,238.7531 L9.6,238.7531 " fill="#FBFB77" filter="url(#fo1zb0wqg7eoa)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M313.2,238.7531 L313.2,250.7531 L325.2,250.7531 L313.2,238.7531 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="290.4" x="16.8" y="259.2334">Command response in next operation</text><polygon fill="#A80036" points="808.2,300.2719,820.2,305.0719,808.2,309.8719,813,305.0719" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="169.8" x2="815.4" y1="305.0719" y2="305.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="536.4" x="178.2" y="298.9928">5. HTTP request("POST", "/command/res/${reqId}/200", "lumen=100")</text><polygon fill="#A80036" points="1516.2,335.2313,1528.2,340.0313,1516.2,344.8313,1521,340.0313" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="834.6" x2="1523.4" y1="340.0313" y2="340.0313"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="667.2" x="843" y="333.9521">6. transfer("command_response/TENANT/4711/${replyId}","status=200","lumen=100")</text><polygon fill="#A80036" points="847.8,370.1906,835.8,374.9906,847.8,379.7906,843,374.9906" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="840.6" x2="1535.4" y1="374.9906" y2="374.9906"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="855" y="368.9115">disposition("accepted")</text><polygon fill="#A80036" points="183,405.15,171,409.95,183,414.75,178.2,409.95" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="175.8" x2="827.4" y1="409.95" y2="409.95"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="190.8" x="190.2" y="403.8709">7. HTTP response ("202")</text><!--
+@startuml
+scale 1.2
+
+participant Device
+participant "HTTP Adapter"
+participant Application
+
+Device -> "HTTP Adapter": 1. HTTP request ("POST", "/event", "hono-ttd=30")
+activate "HTTP Adapter"
+"HTTP Adapter" -> Application: 2. transfer("event/TENANT","4711","ttd=30")
+activate Application
+Application -> "HTTP Adapter": 3. transfer("command/TENANT/4711","light","ON")
+"HTTP Adapter" -> Device: 4. HTTP response (("200", "hono-cmd=light", "hono-cmd-req-id=${reqId}"), "ON")
+"HTTP Adapter" -> Application: disposition("accepted")
+deactivate "HTTP Adapter"
+note over Device
+Command response in next operation
+end note
+Device -> "HTTP Adapter": 5. HTTP request("POST", "/command/res/${reqId}/200", "lumen=100")
+activate "HTTP Adapter"
+"HTTP Adapter" -> Application: 6. transfer("command_response/TENANT/4711/${replyId}","status=200","lumen=100")
+Application -> "HTTP Adapter": disposition("accepted")
+deactivate Application
+"HTTP Adapter" -> Device: 7. HTTP response ("202")
+deactivate "HTTP Adapter"
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/concepts/command_control_concept_mqtt.svg b/docs/1.2/concepts/command_control_concept_mqtt.svg
new file mode 100644
index 0000000..f8540e6
--- /dev/null
+++ b/docs/1.2/concepts/command_control_concept_mqtt.svg
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="427.2px" preserveAspectRatio="none" style="width:1400px;height:427px;" version="1.1" viewBox="0 0 1400 427" width="1400.4px" zoomAndPan="magnify"><defs><filter height="300%" id="fv63cmfv2nt78" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#fv63cmfv2nt78)" height="209.7563" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="622.2" y="148.4344"/><rect fill="#FFFFFF" filter="url(#fv63cmfv2nt78)" height="174.7969" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1330.2" y="183.3937"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="148.8" x2="148.8" y1="45.9563" y2="379.7906"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="627.6" x2="627.6" y1="45.9563" y2="379.7906"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1335.6" x2="1335.6" y1="45.9563" y2="379.7906"/><rect fill="#FEFECE" filter="url(#fv63cmfv2nt78)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#fv63cmfv2nt78)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="378.5906"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="402.5848">Device</text><rect fill="#FEFECE" filter="url(#fv63cmfv2nt78)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="135.6" x="558" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="566.4" y="27.5941">MQTT Adapter</text><rect fill="#FEFECE" filter="url(#fv63cmfv2nt78)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="135.6" x="558" y="378.5906"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="566.4" y="402.5848">MQTT Adapter</text><rect fill="#FEFECE" filter="url(#fv63cmfv2nt78)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1280.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1288.8" y="27.5941">Application</text><rect fill="#FEFECE" filter="url(#fv63cmfv2nt78)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1280.4" y="378.5906"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1288.8" y="402.5848">Application</text><rect fill="#FFFFFF" filter="url(#fv63cmfv2nt78)" height="209.7563" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="622.2" y="148.4344"/><rect fill="#FFFFFF" filter="url(#fv63cmfv2nt78)" height="174.7969" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1330.2" y="183.3937"/><path d="M9.6,63.9563 L9.6,111.9563 L285.6,111.9563 L285.6,75.9563 L273.6,63.9563 L9.6,63.9563 " fill="#FBFB77" filter="url(#fv63cmfv2nt78)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M273.6,63.9563 L273.6,75.9563 L285.6,75.9563 L273.6,63.9563 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="217.2" x="16.8" y="84.4365">The device is connected and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="250.8" x="16.8" y="102.5959">authenticated with TENANT/4711</text><polygon fill="#A80036" points="607.8,143.6344,619.8,148.4344,607.8,153.2344,612.6,148.4344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="615" y1="148.4344" y2="148.4344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="267.6" x="157.8" y="142.3553">1. SUBSCRIBE("command///req/#")</text><polygon fill="#A80036" points="1315.8,178.5938,1327.8,183.3937,1315.8,188.1938,1320.6,183.3937" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="634.2" x2="1323" y1="183.3937" y2="183.3937"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="334.8" x="642.6" y="177.3146">2. transfer("event/TENANT","4711","ttd=-1")</text><polygon fill="#A80036" points="647.4,213.5531,635.4,218.3531,647.4,223.1531,642.6,218.3531" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="640.2" x2="1329" y1="218.3531" y2="218.3531"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="380.4" x="654.6" y="212.274">3. transfer("command/TENANT/4711","light","ON")</text><polygon fill="#A80036" points="162.6,248.5125,150.6,253.3125,162.6,258.1125,157.8,253.3125" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="155.4" x2="621" y1="253.3125" y2="253.3125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="382.8" x="169.8" y="247.2334">4. PUBLISH("command///req/${reqId}/light", "ON")</text><polygon fill="#A80036" points="1315.8,283.4719,1327.8,288.2719,1315.8,293.0719,1320.6,288.2719" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="634.2" x2="1323" y1="288.2719" y2="288.2719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="642.6" y="282.1928">disposition("accepted")</text><polygon fill="#A80036" points="607.8,318.4313,619.8,323.2313,607.8,328.0313,612.6,323.2313" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="615" y1="323.2313" y2="323.2313"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="444" x="157.8" y="317.1521">5. PUBLISH("command///res/${reqId}/200", "lumen=100")</text><polygon fill="#A80036" points="1321.8,353.3906,1333.8,358.1906,1321.8,362.9906,1326.6,358.1906" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="628.2" x2="1329" y1="358.1906" y2="358.1906"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="667.2" x="636.6" y="352.1115">6. transfer("command_response/TENANT/4711/${replyId}","status=200","lumen=100")</text><!--MD5=[130e2d2ad51dc80d7f83df15b0506eb0]
+@startuml
+scale 1.2
+
+participant Device
+participant "MQTT Adapter"
+participant Application
+
+note over Device
+The device is connected and
+authenticated with TENANT/4711
+end note
+Device -> "MQTT Adapter": 1. SUBSCRIBE("command///req/#")
+activate "MQTT Adapter"
+"MQTT Adapter" -> Application: 2. transfer("event/TENANT","4711","ttd=-1")
+activate Application
+Application -> "MQTT Adapter": 3. transfer("command/TENANT/4711","light","ON")
+"MQTT Adapter" -> Device: 4. PUBLISH("command///req/${reqId}/light", "ON")
+"MQTT Adapter" -> Application: disposition("accepted")
+Device -> "MQTT Adapter": 5. PUBLISH("command///res/${reqId}/200", "lumen=100")
+"MQTT Adapter" -> Application: 6. transfer("command_response/TENANT/4711/${replyId}","status=200","lumen=100")
+deactivate "MQTT Adapter"
+deactivate Application
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 10:02:15 UTC 2019)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
diff --git a/docs/1.2/concepts/command_control_concept_one_way_http.svg b/docs/1.2/concepts/command_control_concept_one_way_http.svg
new file mode 100644
index 0000000..89f36d9
--- /dev/null
+++ b/docs/1.2/concepts/command_control_concept_one_way_http.svg
@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="339.6px" preserveAspectRatio="none" style="width:1089px;height:339px;" version="1.1" viewBox="0 0 1089 339" width="1089.6px" zoomAndPan="magnify"><defs><filter height="300%" id="f19vdhjwihf8vo" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f19vdhjwihf8vo)" height="139.8375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="598.2" y="83.3156"/><rect fill="#FFFFFF" filter="url(#f19vdhjwihf8vo)" height="162.6375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1019.4" y="118.275"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="175.2" x2="175.2" y1="45.9563" y2="291.7125"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="603.6" x2="603.6" y1="45.9563" y2="291.7125"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1024.8" x2="1024.8" y1="45.9563" y2="291.7125"/><rect fill="#FEFECE" filter="url(#f19vdhjwihf8vo)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="136.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="145.2" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#f19vdhjwihf8vo)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="136.8" y="290.5125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="145.2" y="314.5066">Device</text><rect fill="#FEFECE" filter="url(#f19vdhjwihf8vo)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="130.8" x="536.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="114" x="544.8" y="27.5941">HTTP Adapter</text><rect fill="#FEFECE" filter="url(#f19vdhjwihf8vo)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="130.8" x="536.4" y="290.5125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="114" x="544.8" y="314.5066">HTTP Adapter</text><rect fill="#FEFECE" filter="url(#f19vdhjwihf8vo)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="969.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="978" y="27.5941">Application</text><rect fill="#FEFECE" filter="url(#f19vdhjwihf8vo)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="969.6" y="290.5125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="978" y="314.5066">Application</text><rect fill="#FFFFFF" filter="url(#f19vdhjwihf8vo)" height="139.8375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="598.2" y="83.3156"/><rect fill="#FFFFFF" filter="url(#f19vdhjwihf8vo)" height="162.6375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1019.4" y="118.275"/><polygon fill="#A80036" points="583.8,78.5156,595.8,83.3156,583.8,88.1156,588.6,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="175.8" x2="591" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="380.4" x="184.2" y="77.2365">1. HTTP request ("POST", "/event", "hono-ttd=30")</text><polygon fill="#A80036" points="1005,113.475,1017,118.275,1005,123.075,1009.8,118.275" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="610.2" x2="1012.2" y1="118.275" y2="118.275"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="338.4" x="618.6" y="112.1959">2. transfer("event/TENANT","4711","ttd=30")</text><polygon fill="#A80036" points="623.4,148.4344,611.4,153.2344,623.4,158.0344,618.6,153.2344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="616.2" x2="1018.2" y1="153.2344" y2="153.2344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="380.4" x="630.6" y="147.1553">3. transfer("command/TENANT/4711","light","ON")</text><polygon fill="#A80036" points="189,183.3937,177,188.1938,189,192.9938,184.2,188.1938" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="181.8" x2="597" y1="188.1938" y2="188.1938"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="393.6" x="196.2" y="182.1146">4. HTTP response (("200", "hono-cmd=light"), "ON")</text><polygon fill="#A80036" points="1005,218.3531,1017,223.1531,1005,227.9531,1009.8,223.1531" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="604.2" x2="1012.2" y1="223.1531" y2="223.1531"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="612.6" y="217.074">disposition("accepted")</text><path d="M9.6,238.7531 L9.6,268.7531 L337.2,268.7531 L337.2,250.7531 L325.2,238.7531 L9.6,238.7531 " fill="#FBFB77" filter="url(#f19vdhjwihf8vo)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M325.2,238.7531 L325.2,250.7531 L337.2,250.7531 L325.2,238.7531 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="302.4" x="16.8" y="259.2334">No response expected from the device.</text><!--
+@startuml
+scale 1.2
+
+participant Device
+participant "HTTP Adapter"
+participant Application
+
+Device -> "HTTP Adapter": 1. HTTP request ("POST", "/event", "hono-ttd=30")
+activate "HTTP Adapter"
+"HTTP Adapter" -> Application: 2. transfer("event/TENANT","4711","ttd=30")
+activate Application
+Application -> "HTTP Adapter": 3. transfer("command/TENANT/4711","light","ON")
+"HTTP Adapter" -> Device: 4. HTTP response (("200", "hono-cmd=light"), "ON")
+"HTTP Adapter" -> Application: disposition("accepted")
+deactivate "HTTP Adapter"
+note over Device
+No response expected from the device.
+end note
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/concepts/command_control_concept_one_way_mqtt.svg b/docs/1.2/concepts/command_control_concept_one_way_mqtt.svg
new file mode 100644
index 0000000..a53ea56
--- /dev/null
+++ b/docs/1.2/concepts/command_control_concept_one_way_mqtt.svg
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="357.6px" preserveAspectRatio="none" style="width:966px;height:357px;" version="1.1" viewBox="0 0 966 357" width="966px" zoomAndPan="magnify"><defs><filter height="300%" id="f19t5uq8ddfn8" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f19t5uq8ddfn8)" height="139.8375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="474.6" y="148.4344"/><rect fill="#FFFFFF" filter="url(#f19t5uq8ddfn8)" height="104.8781" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="895.8" y="183.3937"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="148.8" x2="148.8" y1="45.9563" y2="309.8719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="480" x2="480" y1="45.9563" y2="309.8719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="901.2" x2="901.2" y1="45.9563" y2="309.8719"/><rect fill="#FEFECE" filter="url(#f19t5uq8ddfn8)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#f19t5uq8ddfn8)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="308.6719"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="332.666">Device</text><rect fill="#FEFECE" filter="url(#f19t5uq8ddfn8)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="135.6" x="410.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="418.8" y="27.5941">MQTT Adapter</text><rect fill="#FEFECE" filter="url(#f19t5uq8ddfn8)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="135.6" x="410.4" y="308.6719"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="418.8" y="332.666">MQTT Adapter</text><rect fill="#FEFECE" filter="url(#f19t5uq8ddfn8)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="846" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="854.4" y="27.5941">Application</text><rect fill="#FEFECE" filter="url(#f19t5uq8ddfn8)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="846" y="308.6719"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="854.4" y="332.666">Application</text><rect fill="#FFFFFF" filter="url(#f19t5uq8ddfn8)" height="139.8375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="474.6" y="148.4344"/><rect fill="#FFFFFF" filter="url(#f19t5uq8ddfn8)" height="104.8781" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="895.8" y="183.3937"/><path d="M9.6,63.9563 L9.6,111.9563 L285.6,111.9563 L285.6,75.9563 L273.6,63.9563 L9.6,63.9563 " fill="#FBFB77" filter="url(#f19t5uq8ddfn8)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M273.6,63.9563 L273.6,75.9563 L285.6,75.9563 L273.6,63.9563 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="217.2" x="16.8" y="84.4365">The device is connected and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="250.8" x="16.8" y="102.5959">authenticated with TENANT/4711</text><polygon fill="#A80036" points="460.2,143.6344,472.2,148.4344,460.2,153.2344,465,148.4344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="467.4" y1="148.4344" y2="148.4344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="267.6" x="157.8" y="142.3553">1. SUBSCRIBE("command///req/#")</text><polygon fill="#A80036" points="881.4,178.5938,893.4,183.3937,881.4,188.1938,886.2,183.3937" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="486.6" x2="888.6" y1="183.3937" y2="183.3937"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="334.8" x="495" y="177.3146">2. transfer("event/TENANT","4711","ttd=-1")</text><polygon fill="#A80036" points="499.8,213.5531,487.8,218.3531,499.8,223.1531,495,218.3531" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="492.6" x2="894.6" y1="218.3531" y2="218.3531"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="380.4" x="507" y="212.274">3. transfer("command/TENANT/4711","light","ON")</text><polygon fill="#A80036" points="162.6,248.5125,150.6,253.3125,162.6,258.1125,157.8,253.3125" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="155.4" x2="473.4" y1="253.3125" y2="253.3125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="169.8" y="247.2334">4. PUBLISH("command</text><text fill="#000000" font-family="sans-serif" font-size="15.6" font-style="italic" lengthAdjust="spacingAndGlyphs" textLength="30" x="346.2" y="247.2334">/req</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="90" x="376.2" y="247.2334">light", "ON")</text><polygon fill="#A80036" points="887.4,283.4719,899.4,288.2719,887.4,293.0719,892.2,288.2719" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="480.6" x2="894.6" y1="288.2719" y2="288.2719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="489" y="282.1928">disposition("accepted")</text><!--MD5=[7651b2573c32d1b0c97f09ff206baf24]
+@startuml
+scale 1.2
+
+participant Device
+participant "MQTT Adapter"
+participant Application
+
+note over Device
+The device is connected and
+authenticated with TENANT/4711
+end note
+Device -> "MQTT Adapter": 1. SUBSCRIBE("command///req/#")
+activate "MQTT Adapter"
+"MQTT Adapter" -> Application: 2. transfer("event/TENANT","4711","ttd=-1")
+activate Application
+Application -> "MQTT Adapter": 3. transfer("command/TENANT/4711","light","ON")
+"MQTT Adapter" -> Device: 4. PUBLISH("command///req//light", "ON")
+"MQTT Adapter" -> Application: disposition("accepted")
+deactivate "MQTT Adapter"
+deactivate Application
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 10:02:15 UTC 2019)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
diff --git a/docs/1.2/concepts/connecting-devices/device-types.svg b/docs/1.2/concepts/connecting-devices/device-types.svg
new file mode 100644
index 0000000..409aeea
--- /dev/null
+++ b/docs/1.2/concepts/connecting-devices/device-types.svg
@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="237.6px" preserveAspectRatio="none" style="width:960px;height:237px;" version="1.1" viewBox="0 0 960 237" width="960px" zoomAndPan="magnify"><defs><filter height="300%" id="f10lz29lw21ygl" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><!--MD5=[63d763348ac51c2b67460dafb50138c0]
+entity MQTTDevice--><ellipse cx="343.2" cy="21" fill="#FEFECE" filter="url(#f10lz29lw21ygl)" rx="9.6" ry="9.6" style="stroke: #A80036; stroke-width: 1.7999999999999998;"/><path d="M343.2,30.6 L343.2,63 M327.6,40.2 L358.8,40.2 M343.2,63 L327.6,81 M343.2,63 L358.8,81 " fill="none" filter="url(#f10lz29lw21ygl)" style="stroke: #A80036; stroke-width: 1.7999999999999998;"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="110.4" x="288" y="103.1941">MQTT Device</text><!--MD5=[119379320346e5b6ddb291da4ce124eb]
+entity BLEDevice--><ellipse cx="78.6" cy="139.8" fill="#FEFECE" filter="url(#f10lz29lw21ygl)" rx="9.6" ry="9.6" style="stroke: #A80036; stroke-width: 1.7999999999999998;"/><path d="M78.6,149.4 L78.6,181.8 M63,159 L94.2,159 M78.6,181.8 L63,199.8 M78.6,181.8 L94.2,199.8 " fill="none" filter="url(#f10lz29lw21ygl)" style="stroke: #A80036; stroke-width: 1.7999999999999998;"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="142.8" x="7.2" y="221.9941">Bluetooth Device</text><!--MD5=[49cbbb1648246ecd0e2d56eda0c19f08]
+entity Gateway--><polygon fill="#FEFECE" filter="url(#f10lz29lw21ygl)" points="253.2,161.4,265.2,149.4,433.2,149.4,433.2,192.9562,421.2,204.9562,253.2,204.9562,253.2,161.4" style="stroke: #000000; stroke-width: 1.7999999999999998;"/><line style="stroke: #000000; stroke-width: 1.7999999999999998;" x1="421.2" x2="432" y1="161.4" y2="150.6"/><line style="stroke: #000000; stroke-width: 1.7999999999999998;" x1="253.2" x2="421.2" y1="161.4" y2="161.4"/><line style="stroke: #000000; stroke-width: 1.7999999999999998;" x1="421.2" x2="421.2" y1="161.4" y2="204.9562"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="132" x="271.2" y="188.9941">Device Gateway</text><!--MD5=[9eb86c2b3d925a16ba1bdada40016c70]
+entity Internet--><path d="M560.8785,89.1911 C563.9566,81.9471 568.7208,81.2503 574.5318,86.1078 C578.7269,80.3426 584.9208,78.9848 588.4861,86.757 C590.6641,80.3187 596.1368,80.0484 600.2908,84.6427 C604.5612,79.8094 611.4498,79.4137 613.7271,86.8292 C617.8531,81.1014 623.0471,79.723 627.3117,86.6807 C632.7286,80.1128 636.9463,80.7613 640.9011,88.1086 C651.808,91.2621 655.8529,96.46 649.707,107.3982 C656.5444,115.726 651.4192,124.4541 641.9418,125.9547 C639.374,132.4826 634.5863,134.3051 628.9448,129.4706 C625.1298,136.2009 619.9029,137.0808 614.4687,131.3519 C612.6371,138.7003 607.7712,141.9413 600.8647,136.9439 C594.6526,141.7902 590.167,139.1128 588.7568,132.0583 C582.3481,137.3761 576.9249,136.9161 573.523,128.6791 C568.6761,132.9777 563.7386,131.4352 561.7347,125.4274 C551.4822,121.0751 550.5751,112.8856 557.9704,105.2422 C550.5462,98.313 551.1415,93.0111 560.8785,89.1911 " fill="#FEFECE" style="stroke: #000000; stroke-width: 1.7999999999999998;"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="64.8" x="567.6" y="110.9941">Internet</text><!--MD5=[fe0bae4af69ca8947a410fa6d457e8ef]
+entity Adapter--><polygon fill="#FFA500" filter="url(#f10lz29lw21ygl)" points="766.8,89.4,778.8,77.4,933.6,77.4,933.6,120.9563,921.6,132.9562,766.8,132.9562,766.8,89.4" style="stroke: #000000; stroke-width: 1.7999999999999998;"/><line style="stroke: #000000; stroke-width: 1.7999999999999998;" x1="921.6" x2="932.4" y1="89.4" y2="78.6"/><line style="stroke: #000000; stroke-width: 1.7999999999999998;" x1="766.8" x2="921.6" y1="89.4" y2="89.4"/><line style="stroke: #000000; stroke-width: 1.7999999999999998;" x1="921.6" x2="921.6" y1="89.4" y2="132.9562"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="784.8" y="116.9941">MQTT Adapter</text><!--MD5=[fbacf958340d5ea8486c8bd6a64fda31]
+link MQTTDevice to Internet--><path d="M398.6628,68.1828 C443.3172,76.3968 506.0832,87.9432 549.3612,95.9052 " fill="none" id="MQTTDevice-Internet" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="42" x="470.4" y="77.4803">MQTT</text><!--MD5=[a8512f110cb6ccc8f4f6970366c2a2de]
+link Internet to Adapter--><path d="M650.7504,105 C683.8008,105 728.0508,105 766.3596,105 " fill="none" id="Internet-Adapter" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="42" x="687.6" y="100.2803">MQTT</text><!--MD5=[569964c243cbd685f19f098ae53e1f8e]
+link BLEDevice to Gateway--><path d="M150.0648,177 C181.6164,177 219.21,177 252.7284,177 " fill="none" id="BLEDevice-Gateway" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="28.8" x="187.2" y="172.2803">BLE</text><!--MD5=[67694bcfcd38c5cf7fee209ed0b6e046]
+link Gateway to Internet--><path d="M433.3764,151.8179 C472.35,140.7877 516.6012,128.2638 549.5232,118.9463 " fill="none" id="Gateway-Internet" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="42" x="470.4" y="125.4803">MQTT</text><!--MD5=[bc9d9f23afa4d8e3b8b63bf02da2758d]
+@startuml
+left to right direction
+scale 1.2
+
+actor "MQTT Device" as MQTTDevice
+actor "Bluetooth Device" as BLEDevice
+node "Device Gateway" as Gateway
+cloud Internet
+node "MQTT Adapter" as Adapter #orange
+
+MQTTDevice - - Internet : MQTT
+Internet - - Adapter : MQTT
+BLEDevice - - Gateway : BLE
+Gateway - - Internet : MQTT
+@enduml
+
+PlantUML version 1.2020.02beta5(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/concepts/connecting-devices/device-via-gateway-auth.svg b/docs/1.2/concepts/connecting-devices/device-via-gateway-auth.svg
new file mode 100644
index 0000000..db88a30
--- /dev/null
+++ b/docs/1.2/concepts/connecting-devices/device-via-gateway-auth.svg
@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="729.6px" preserveAspectRatio="none" style="width:1423px;height:729px;" version="1.1" viewBox="0 0 1423 729" width="1423.2px" zoomAndPan="magnify"><defs><filter height="300%" id="f1bcnn0h64qkyn" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f1bcnn0h64qkyn)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1044.6" y="210.8344"/><rect fill="#FFFFFF" filter="url(#f1bcnn0h64qkyn)" height="136.3969" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1205.4" y="432.5906"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="84" x2="84" y1="103.5562" y2="625.5469"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="285.6" x2="285.6" y1="103.5562" y2="625.5469"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="675.6" x2="675.6" y1="103.5562" y2="625.5469"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1050.6" x2="1050.6" y1="103.5562" y2="625.5469"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1211.4" x2="1211.4" y1="103.5562" y2="625.5469"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="142.8" x="9.6" y="99.5941">Bluetooth Device</text><ellipse cx="84.6" cy="15.6" fill="#FEFECE" filter="url(#f1bcnn0h64qkyn)" rx="9.6" ry="9.6" style="stroke: #A80036; stroke-width: 2.4;"/><path d="M84.6,25.2 L84.6,57.6 M69,34.8 L100.2,34.8 M84.6,57.6 L69,75.6 M84.6,57.6 L100.2,75.6 " fill="none" filter="url(#f1bcnn0h64qkyn)" style="stroke: #A80036; stroke-width: 2.4;"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="142.8" x="9.6" y="639.941">Bluetooth Device</text><ellipse cx="84.6" cy="655.9031" fill="#FEFECE" filter="url(#f1bcnn0h64qkyn)" rx="9.6" ry="9.6" style="stroke: #A80036; stroke-width: 2.4;"/><path d="M84.6,665.5031 L84.6,697.9031 M69,675.1031 L100.2,675.1031 M84.6,697.9031 L69,715.9031 M84.6,697.9031 L100.2,715.9031 " fill="none" filter="url(#f1bcnn0h64qkyn)" style="stroke: #A80036; stroke-width: 2.4;"/><rect fill="#FEFECE" filter="url(#f1bcnn0h64qkyn)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="240" y="61.2"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="248.4" y="85.1941">Gateway</text><rect fill="#FEFECE" filter="url(#f1bcnn0h64qkyn)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="240" y="624.3469"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="248.4" y="648.341">Gateway</text><rect fill="#FFA500" filter="url(#f1bcnn0h64qkyn)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="135.6" x="606" y="61.2"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="614.4" y="85.1941">MQTT Adapter</text><rect fill="#FFA500" filter="url(#f1bcnn0h64qkyn)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="135.6" x="606" y="624.3469"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="614.4" y="648.341">MQTT Adapter</text><rect fill="#FFA500" filter="url(#f1bcnn0h64qkyn)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="110.4" x="993" y="61.2"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="93.6" x="1001.4" y="85.1941">Credentials</text><rect fill="#FFA500" filter="url(#f1bcnn0h64qkyn)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="110.4" x="993" y="624.3469"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="93.6" x="1001.4" y="648.341">Credentials</text><rect fill="#FFA500" filter="url(#f1bcnn0h64qkyn)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="177.6" x="1120.2" y="61.2"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="160.8" x="1128.6" y="85.1941">Device Registration</text><rect fill="#FFA500" filter="url(#f1bcnn0h64qkyn)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="177.6" x="1120.2" y="624.3469"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="160.8" x="1128.6" y="648.341">Device Registration</text><rect fill="#FFFFFF" filter="url(#f1bcnn0h64qkyn)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1044.6" y="210.8344"/><rect fill="#FFFFFF" filter="url(#f1bcnn0h64qkyn)" height="136.3969" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1205.4" y="432.5906"/><polygon fill="#A80036" points="271.8,136.1156,283.8,140.9156,271.8,145.7156,276.6,140.9156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="84.6" x2="279" y1="140.9156" y2="140.9156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="93" y="134.8365">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="108.6" y="134.8365">establish connection</text><polygon fill="#A80036" points="661.8,171.075,673.8,175.875,661.8,180.675,666.6,175.875" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="286.2" x2="669" y1="175.875" y2="175.875"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="294.6" y="169.7959">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="306" x="310.2" y="169.7959">CONNECT(tenant, gatewayId, password)</text><polygon fill="#A80036" points="1030.2,206.0344,1042.2,210.8344,1030.2,215.6344,1035,210.8344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="676.2" x2="1037.4" y1="210.8344" y2="210.8344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="684.6" y="204.7553">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="330" x="700.2" y="204.7553">get(tenant, gatewayId, "hashed-password")</text><polygon fill="#A80036" points="689.4,240.9937,677.4,245.7938,689.4,250.5938,684.6,245.7938" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 2.0,2.0;" x1="682.2" x2="1049.4" y1="245.7938" y2="245.7938"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="696.6" y="239.7146">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="114" x="712.2" y="239.7146">password hash</text><path d="M596.4,261.3938 L596.4,291.3938 L751.2,291.3938 L751.2,273.3938 L739.2,261.3938 L596.4,261.3938 " fill="#FBFB77" filter="url(#f1bcnn0h64qkyn)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M739.2,261.3938 L739.2,273.3938 L751.2,273.3938 L739.2,261.3938 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="129.6" x="603.6" y="281.874">verify credentials</text><polygon fill="#A80036" points="299.4,322.9125,287.4,327.7125,299.4,332.5125,294.6,327.7125" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="292.2" x2="675" y1="327.7125" y2="327.7125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="306.6" y="321.6334">5</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="66" x="322.2" y="321.6334">CONACK</text><polygon fill="#A80036" points="271.8,357.8719,283.8,362.6719,271.8,367.4719,276.6,362.6719" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="84.6" x2="279" y1="362.6719" y2="362.6719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="93" y="356.5928">6</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="97.2" x="108.6" y="356.5928">sensor value</text><polygon fill="#A80036" points="661.8,392.8313,673.8,397.6312,661.8,402.4313,666.6,397.6312" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="286.2" x2="669" y1="397.6312" y2="397.6312"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="294.6" y="391.5521">7</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="345.6" x="310.2" y="391.5521">PUBLISH("t/$tenant/$deviceId", sensor value)</text><polygon fill="#A80036" points="1191,427.7906,1203,432.5906,1191,437.3906,1195.8,432.5906" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="676.2" x2="1198.2" y1="432.5906" y2="432.5906"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="684.6" y="426.5115">8</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="282" x="700.2" y="426.5115">assert(tenantId, deviceId, gatewayId)</text><path d="M1008,448.1906 L1008,532.1906 L1408.8,532.1906 L1408.8,460.1906 L1396.8,448.1906 L1008,448.1906 " fill="#FBFB77" filter="url(#f1bcnn0h64qkyn)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M1396.8,448.1906 L1396.8,460.1906 L1408.8,460.1906 L1396.8,448.1906 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="76.8" x="1015.2" y="468.6709">verify that</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="202.8" x="1015.2" y="486.8303">- device and gateway exist</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="258" x="1015.2" y="504.9896">- device and gateway are enabled</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="375.6" x="1015.2" y="523.149">- gateway is authorized to act on behalf of device</text><polygon fill="#A80036" points="689.4,564.1875,677.4,568.9875,689.4,573.7875,684.6,568.9875" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 2.0,2.0;" x1="682.2" x2="1210.2" y1="568.9875" y2="568.9875"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="696.6" y="562.9084">9</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="18" x="712.2" y="562.9084">ok</text><polygon fill="#A80036" points="299.4,599.1469,287.4,603.9469,299.4,608.7469,294.6,603.9469" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="292.2" x2="675" y1="603.9469" y2="603.9469"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="21.6" x="306.6" y="597.8678">10</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="63.6" x="333" y="597.8678">PUBACK</text><!--MD5=[718c1b61ecfde72d3a105c4a110973ff]
+@startuml
+autonumber
+scale 1.2
+
+actor "Bluetooth Device" as Device
+participant Gateway
+participant "MQTT Adapter" as Adapter #orange
+participant "Credentials" as Cred #orange
+participant "Device Registration" as Reg #orange
+
+Device -> Gateway : establish connection
+Gateway -> Adapter : CONNECT(tenant, gatewayId, password)
+Adapter -> Cred : get(tenant, gatewayId, "hashed-password")
+activate Cred
+return password hash
+note over Adapter: verify credentials
+Adapter -> Gateway : CONACK
+
+Device -> Gateway : sensor value
+Gateway -> Adapter : PUBLISH("t/$tenant/$deviceId", sensor value)
+Adapter -> Reg : assert(tenantId, deviceId, gatewayId)
+activate Reg
+note over Reg
+  verify that
+  - device and gateway exist
+  - device and gateway are enabled
+  - gateway is authorized to act on behalf of device
+end note
+return ok
+Adapter -> Gateway: PUBACK
+@enduml
+
+PlantUML version 1.2020.02beta5(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/concepts/connecting-devices/device-via-protocol-gw.svg b/docs/1.2/concepts/connecting-devices/device-via-protocol-gw.svg
new file mode 100644
index 0000000..db68514
--- /dev/null
+++ b/docs/1.2/concepts/connecting-devices/device-via-protocol-gw.svg
@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="258px" preserveAspectRatio="none" style="width:860px;height:258px;" version="1.1" viewBox="0 0 860 258" width="860.4px" zoomAndPan="magnify"><defs><filter height="300%" id="f5bukth4lywls" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><!--MD5=[e68735924c73d303307919df3c3a2fc4]
+entity Device1--><ellipse cx="43.2" cy="21" fill="#FEFECE" filter="url(#f5bukth4lywls)" rx="9.6" ry="9.6" style="stroke: #A80036; stroke-width: 1.7999999999999998;"/><path d="M43.2,30.6 L43.2,63 M27.6,40.2 L58.8,40.2 M43.2,63 L27.6,81 M43.2,63 L58.8,81 " fill="none" filter="url(#f5bukth4lywls)" style="stroke: #A80036; stroke-width: 1.7999999999999998;"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="72" x="7.2" y="103.1941">Device 1</text><!--MD5=[edd7c1fe627c3ac5789dce1f3265df01]
+entity Device2--><ellipse cx="43.2" cy="160.2" fill="#FEFECE" filter="url(#f5bukth4lywls)" rx="9.6" ry="9.6" style="stroke: #A80036; stroke-width: 1.7999999999999998;"/><path d="M43.2,169.8 L43.2,202.2 M27.6,179.4 L58.8,179.4 M43.2,202.2 L27.6,220.2 M43.2,202.2 L58.8,220.2 " fill="none" filter="url(#f5bukth4lywls)" style="stroke: #A80036; stroke-width: 1.7999999999999998;"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="72" x="7.2" y="242.3941">Device 2</text><!--MD5=[9eb86c2b3d925a16ba1bdada40016c70]
+entity Internet--><path d="M178.0785,111.9911 C181.1566,104.7471 185.9208,104.0503 191.7318,108.9078 C195.9269,103.1426 202.1208,101.7848 205.6861,109.557 C207.8641,103.1187 213.3368,102.8484 217.4908,107.4427 C221.7612,102.6094 228.6498,102.2137 230.9271,109.6292 C235.0531,103.9014 240.2471,102.523 244.5117,109.4807 C249.9286,102.9128 254.1463,103.5613 258.1011,110.9086 C269.008,114.0621 273.0529,119.26 266.907,130.1982 C273.7444,138.526 268.6192,147.2541 259.1418,148.7547 C256.574,155.2826 251.7863,157.1051 246.1448,152.2706 C242.3298,159.0009 237.1029,159.8808 231.6687,154.1519 C229.8371,161.5003 224.9712,164.7413 218.0647,159.7439 C211.8526,164.5902 207.367,161.9128 205.9568,154.8583 C199.5481,160.1761 194.1249,159.7161 190.723,151.4791 C185.8761,155.7777 180.9386,154.2352 178.9347,148.2274 C168.6822,143.8751 167.7751,135.6856 175.1704,128.0422 C167.7462,121.113 168.3415,115.8111 178.0785,111.9911 " fill="#FEFECE" style="stroke: #000000; stroke-width: 1.7999999999999998;"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="64.8" x="184.8" y="133.7941">Internet</text><!--MD5=[49cbbb1648246ecd0e2d56eda0c19f08]
+entity Gateway--><polygon fill="#FEFECE" filter="url(#f5bukth4lywls)" points="355.2,112.2,367.2,100.2,547.2,100.2,547.2,143.7563,535.2,155.7563,355.2,155.7563,355.2,112.2" style="stroke: #000000; stroke-width: 1.7999999999999998;"/><line style="stroke: #000000; stroke-width: 1.7999999999999998;" x1="535.2" x2="546" y1="112.2" y2="101.4"/><line style="stroke: #000000; stroke-width: 1.7999999999999998;" x1="355.2" x2="535.2" y1="112.2" y2="112.2"/><line style="stroke: #000000; stroke-width: 1.7999999999999998;" x1="535.2" x2="535.2" y1="112.2" y2="155.7563"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="144" x="373.2" y="139.7941">Protocol Gateway</text><!--MD5=[fe0bae4af69ca8947a410fa6d457e8ef]
+entity Adapter--><polygon fill="#FFA500" filter="url(#f5bukth4lywls)" points="667.2,112.2,679.2,100.2,834,100.2,834,143.7563,822,155.7563,667.2,155.7563,667.2,112.2" style="stroke: #000000; stroke-width: 1.7999999999999998;"/><line style="stroke: #000000; stroke-width: 1.7999999999999998;" x1="822" x2="832.8" y1="112.2" y2="101.4"/><line style="stroke: #000000; stroke-width: 1.7999999999999998;" x1="667.2" x2="822" y1="112.2" y2="112.2"/><line style="stroke: #000000; stroke-width: 1.7999999999999998;" x1="822" x2="822" y1="112.2" y2="155.7563"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="685.2" y="139.7941">AMQP Adapter</text><!--MD5=[ce429b18c6ef410867aabdbdbb02d0ad]
+link Device1 to Internet--><path d="M79.54,72.4524 C104.6418,82.6332 138.7572,96.4704 166.596,107.7624 " fill="none" id="Device1-Internet" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="13.2" x="116.4" y="84.6803">IP</text><!--MD5=[9cea91f9ad61bafa4b0fc474e47adbe2]
+link Device2 to Internet--><path d="M79.54,183.1475 C104.6418,172.9662 138.7572,159.1294 166.596,147.8378 " fill="none" id="Device2-Internet" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="13.2" x="116.4" y="157.8803">IP</text><!--MD5=[f00776eec63b04abcec2ff72d8678bc4]
+link Internet to Gateway--><path d="M268.0836,127.8 C293.4708,127.8 325.2324,127.8 355.08,127.8 " fill="none" id="Internet-Gateway" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="13.2" x="304.8" y="123.0803">IP</text><!--MD5=[5afe34a06038127a4abb08f0ae358b6a]
+link Gateway to Adapter--><path d="M547.5984,127.8 C585.9432,127.8 629.7564,127.8 666.738,127.8 " fill="none" id="Gateway-Adapter" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="584.4" y="123.0803">AMQP</text><!--MD5=[603cbc848dece4b801483248f08729a4]
+@startuml
+left to right direction
+scale 1.2
+
+actor "Device 1" as Device1
+actor "Device 2" as Device2
+cloud Internet
+node "Protocol Gateway" as Gateway
+node "AMQP Adapter" as Adapter #orange
+
+Device1 - - Internet : IP
+Device2 - - Internet : IP
+Internet - - Gateway : IP
+Gateway - - Adapter : AMQP
+@enduml
+
+PlantUML version 1.2020.02beta5(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/concepts/connecting-devices/index.html b/docs/1.2/concepts/connecting-devices/index.html
new file mode 100644
index 0000000..83decab
--- /dev/null
+++ b/docs/1.2/concepts/connecting-devices/index.html
@@ -0,0 +1,2605 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Connecting Devices :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Connecting Devices :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Connecting Devices :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/concepts/connecting-devices//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/concepts/connecting-devices/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item active">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/concepts/connecting-devices/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/connecting-devices/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/concepts/connecting-devices/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/concepts/connecting-devices/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/concepts/connecting-devices/index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/concepts/'>Concepts</a> > Connecting Devices
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#connecting-to-a-protocol-adapter-directly">Connecting to a Protocol Adapter directly</a></li>
+<li><a href="#connecting-via-a-device-gateway">Connecting via a Device Gateway</a>
+<ul>
+<li><a href="#gateway-groups">Gateway Groups</a></li>
+</ul></li>
+<li><a href="#connecting-via-a-protocol-gateway">Connecting via a Protocol Gateway</a>
+<ul>
+<li><a href="#example-code">Example Code</a></li>
+</ul></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Connecting Devices</h1>
+          
+
+        
+
+
+
+
+<p>One of the most important features of Eclipse Hono&trade; is to abstract away the specific communication protocols
+used by devices. This page describes the different ways of how devices can be connected to Hono.
+<!-- more --></p>
+
+<p>Before a device can connect to Hono and upload data or receive commands from downstream applications,
+it needs to be <a href="/hono/docs/1.2/concepts/device-provisioning/">provisioned</a> to the system.
+As part of device provisioning, the device is associated with the <em>tenant</em> that it belongs to and gets
+assigned a logical identifier which is unique within the tenant.</p>
+
+<p>Devices can be generally partitioned into two groups: devices which natively support the Internet Protocol
+(IP) for communication and devices that don&rsquo;t.</p>
+
+<p>Devices falling into the former group can connect to Hono directly using any of the IP based protocols supported
+by Hono&rsquo;s protocol adapters. Devices from the latter group often use radio based or serial line communication protocols
+that are limited to a local area and require a <em>gateway</em> in order to connect to one of Hono&rsquo;s protocol
+adapters via IP.</p>
+
+<p>The diagram below shows a device that supports the MQTT protocol and connects directly to Hono&rsquo;s MQTT protocol adapter
+and another device that uses Bluetooth LE for connecting locally to a gateway which then connects to Hono&rsquo;s MQTT adapter.</p>
+
+<figure>
+    <img src="device-types.svg"/> 
+</figure>
+
+
+<h2 id="connecting-to-a-protocol-adapter-directly">Connecting to a Protocol Adapter directly</h2>
+
+<p>The most straight forward scenario is a device connecting to one of Hono&rsquo;s protocol adapters directly via IP based
+network infrastructure. For this to work, the device needs to use a communication protocols supported
+by one of the adapters and needs to be able to use the resource endpoints exposed by that particular protocol adapter
+as described in its <a href="/hono/docs/1.2/user-guide/">user guide</a>.</p>
+
+<p>In this case the connected device&rsquo;s identity will be resolved as part of authentication during connection establishment.
+For this to work, a set of credentials needs to be provisioned for the device which needs to be appropriate for
+usage with one of the adapter&rsquo;s supported authentication schemes.</p>
+
+<h2 id="connecting-via-a-device-gateway">Connecting via a Device Gateway</h2>
+
+<p>In some cases, a device may not be able to directly connect to one of Hono&rsquo;s protocol adapters.
+An example is a device that uses a serial bus or radio waves for local communication.
+Such devices can be connected to a protocol adapter by means of a <em>device gateway</em> which acts on behalf
+of the device(s) when communicating with Hono. A device gateway is often implemented as a (small) hardware box
+close to the devices, running some gateway software which translates hence and forth between the device and one
+of Hono&rsquo;s protocol adapters.</p>
+
+<p>From the perspective of a protocol adapter, the gateway looks just like any other device having its own device
+identity and credentials.</p>
+
+<p>The following diagram illustrates how a gateway publishes data on behalf of a device that uses Bluetooth for local
+communication with the gateway.</p>
+
+<figure>
+    <img src="device-via-gateway-auth.svg"/> 
+</figure>
+
+
+<ol>
+<li>The device establishes a Bluetooth connection with the gateway.</li>
+<li>The gateway sends an MQTT CONNECT packet to Hono&rsquo;s MQTT adapter to establish an MQTT connection.
+The packet contains the gateway&rsquo;s credentials.</li>
+<li>The MQTT adapter determines the tenant from the <em>username</em> contained in the CONNECT packet and retrieves
+the hashed password that is on record for the gateway from the Credentials service.</li>
+<li>The Credentials service returns the hashed password.</li>
+<li>The MQTT adapter checks the password and accepts the connection request.</li>
+<li>The device sends some sensor readings via Bluetooth to the gateway.</li>
+<li>The gateway forwards the sensor data in an MQTT PUBLISH packet to the MQTT adapter.
+The topic name contains the identifier of the device that the gateway acts on behalf of.</li>
+<li>The MQTT adapter invokes the Device Registration service&rsquo;s <em>assert Device Registration</em> operation to
+check if the gateway is authorized to act on behalf of the device.</li>
+<li>The Device Registration service confirms the gateway&rsquo;s authorization.</li>
+<li>The MQTT adapter accepts the sensor data from the gateway and forwards it downstream.</li>
+</ol>
+
+<p>Note that the device itself is not authenticated by the MQTT adapter in this case. The responsibility
+for establishing and verifying the device identity lies with the gateway in this setup.
+It is therefore not necessary to provision credentials for the devices to Hono.</p>
+
+<p>The <a href="/hono/docs/1.2/api/management/">Device Registry Management API</a>&rsquo;s <code>/devices</code> resource can be used to
+register gateways and devices. The gateways that are authorized to act on behalf of a device can be set by means
+of the device&rsquo;s <em>via</em> and <em>viaGroups</em> properties. This is useful in cases where a device may <em>roam</em> among multiple gateways.</p>
+
+<p>When sending commands to a device, Hono needs to determine which of the authorized gateways should be used to forward
+the command message to the device. For this purpose, Hono&rsquo;s protocol adapters keep track of the <em>last known gateway</em>
+which has acted on behalf of each device by means of the <a href="/hono/docs/1.2/api/device-connection/">Device Connection API</a>.</p>
+
+<h3 id="gateway-groups">Gateway Groups</h3>
+
+<p>In larger deployments with many gateways it can become cumbersome to list all possible gateways in the <em>via</em> property
+of each device explicitly. This becomes even more of a burden when gateways are added and/or removed frequently.
+To help with such situations it is possible to define groups of gateways using Hono&rsquo;s Device Registry Management API.</p>
+
+<p>A gateway group can be defined implicitly by means of adding the group&rsquo;s identifier to the list in the <em>memberOf</em>
+property of a (gateway) device that should belong to the group. The gateway group ID can then be added to the <em>viaGroups</em>
+property of those devices that all gateways in the gateway group are authorized to act on behalf of.</p>
+
+<p>Note that the Device Registration API, which is used by protocol adapters to verify if a gateway may act on behalf of a
+device, has no notion of gateway groups. Thus, the response message of the Device Registration API&rsquo;s
+<a href="/hono/docs/1.2/api/device-registration/#assert-device-registration"><em>assert Device Registration</em></a> operation <strong>does
+not</strong> contain the IDs of gateway groups in its <em>via</em> property but instead contains the IDs of all (gateway) devices
+that are a member of any of the authorized gateway groups.</p>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Note</h4>
+    <div>Hono&rsquo;s example device registry does not support nested gateway groups.</div>
+</div>
+
+
+<h2 id="connecting-via-a-protocol-gateway">Connecting via a Protocol Gateway</h2>
+
+<p>Hono already comes with a set of standard protocol adapters which support the most widely used (IP based) IoT protocols
+like HTTP, MQTT and AMQP 1.0. Devices using one of these protocols might be able to directly connect to the corresponding
+adapter as described in the previous section. However, even if the device supports MQTT it might still not be possible
+to connect to the MQTT adapter because the device expects to use a topic structure that differs from the one employed
+by the MQTT adapter. In other cases devices might use a proprietary, highly optimized, binary (IP based) protocol for
+communication with back end infrastructure.</p>
+
+<p>Hono supports connecting such devices to one of the standard protocol adapters by means of a <em>protocol gateway</em>.
+A protocol gateway is a software service which translates hence and forth between the device&rsquo;s proprietary protocol and
+the protocol used by the Hono protocol adapter. This concept is very similar to the <em>device gateway</em> described above.
+The main difference is that a protocol gateway is usually deployed in the back end (close to the protocol adapter) whereas
+a device gateway is usually deployed close to the devices that are connected to the gateway using a mechanism that is
+usually constrained to a local area.</p>
+
+<p>The diagram below illustrates how two devices use a proprietary IP based protocol to connect to a protocol gateway in the
+back end which in turn is connected to Hono&rsquo;s standard AMQP 1.0 protocol adapter.</p>
+
+<figure>
+    <img src="device-via-protocol-gw.svg"/> 
+</figure>
+
+
+<p>The devices publish data to the <em>protocol gateway</em> using the proprietary IP based protocol. The gateway then puts the
+data into AMQP 1.0 messages and forwards them to the Hono AMQP adapter using the AMQP 1.0 protocol.</p>
+
+<p>The requirements and prerequisites for this approach are the same as those for the standard device gateway scenario.
+Authentication and authorization of gateways works in the same way.</p>
+
+<h3 id="example-code">Example Code</h3>
+
+<p>Hono&rsquo;s <a href="https://github.com/eclipse/hono/tree/master/example/protocol-adapter-example"><em>examples</em> module</a> contains code for
+a simple protocol gateway illustrating how devices using a binary TCP based protocol can be connected to Hono&rsquo;s AMQP adapter.</p>
+
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/concepts/connection-events/index.html b/docs/1.2/concepts/connection-events/index.html
new file mode 100644
index 0000000..2c7e75f
--- /dev/null
+++ b/docs/1.2/concepts/connection-events/index.html
@@ -0,0 +1,2492 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Connection Events :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Connection Events :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Connection Events :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/concepts/connection-events//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/concepts/connection-events/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item active">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/concepts/connection-events/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/connection-events/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/concepts/connection-events/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/concepts/connection-events/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/concepts/connection-events/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/concepts/connection-events.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/concepts/'>Concepts</a> > Connection Events
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Connection Events</h1>
+          
+
+        
+
+
+<p>Hono&rsquo;s protocol adapters can use <em>connection events</em> to indicate the connection
+status of a device. In particular, an adapter can notify downstream components
+about a newly established connection with a device or about a device having
+disconnected.
+<!-- more --></p>
+
+<p>The connection status of devices using stateful protocols like MQTT and AMQP can usually
+be determined quite easily because these protocols often require peers to explicitly open
+or close a connection and often also support a kind of heart beat which can be used to
+determine if a connection is still alive. However, for stateless protocols like HTTP
+or CoAP, there is no clear definition of what it actually means that a device is
+<em>connected</em>. It is obvious that a device is connected when it is sending an HTTP request.
+However, the adapter has no way of knowing if the device has gone to sleep after it has
+received the adapter&rsquo;s response to its request.</p>
+
+<p>That said, connection events indicating an established connection with a device can
+usually be taken as face value. However, connection events indicating the disconnection
+of a device may only represent the protocol adapters view of the device&rsquo;s connection
+status. For example, the HTTP adapter might consider a device <em>disconnected</em> because
+it hasn&rsquo;t received any requests from the device for some time. However, the device itself
+might as well be up and running (i.e. not sleeping) and simply have no data worth publishing.</p>
+
+<p>The mechanism of firing connection events is pluggable with the default implementation
+simply forwarding connection status information to the logging framework.
+Hono also comes with an alternative implementation which forwards connection status
+information by means of <a href="/hono/docs/1.2/api/event/#connection-event">Connection Events</a>
+via the <em>Events</em> API.</p>
+
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/concepts/device-identity/index.html b/docs/1.2/concepts/device-identity/index.html
new file mode 100644
index 0000000..63c798d
--- /dev/null
+++ b/docs/1.2/concepts/device-identity/index.html
@@ -0,0 +1,2512 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Device Identity :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Device Identity :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Device Identity :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/concepts/device-identity//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/concepts/device-identity/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item active">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/concepts/device-identity/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/device-identity/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/concepts/device-identity/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/concepts/device-identity/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/concepts/device-identity/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/concepts/device-identity.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/concepts/'>Concepts</a> > Device Identity
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#tenant">Tenant</a></li>
+<li><a href="#device-registration">Device Registration</a></li>
+<li><a href="#device-authentication">Device Authentication</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Device Identity</h1>
+          
+
+        
+
+
+<p>This page describes how devices are represented and identified throughout Hono and its APIs.</p>
+
+<p>The main purpose of Hono is to provide a uniform API for applications to interact with devices,
+regardless of the particular communication protocol the devices natively use.
+In order to do so, Hono uses a unique <em>logical</em> identifier to refer to each device individually.</p>
+
+<p>Hono does not make any assumptions about the format of a device identifier (or <em>device-id</em> for short).
+It basically is a string which is defined at the time a device is being
+<a href="/hono/docs/1.2/concepts/device-provisioning/">provisioned</a>. Once created, the device can be referred
+to by this identifier when using Hono&rsquo;s APIs until the device is being removed from the system.</p>
+
+<h2 id="tenant">Tenant</h2>
+
+<p>Hono supports the logical partitioning of devices into groups called <a href="/hono/docs/1.2/concepts/tenancy/"><em>tenants</em></a>. Each tenant has a unique identifier, a string called the <em>tenant-id</em>, and can be used to provide a logical grouping of devices belonging e.g. to the same application scope or organizational unit. Each device can thus be uniquely identified by the tuple (<em>tenant-id</em>, <em>device-id</em>). This tuple is broadly used throughout Hono&rsquo;s APIs when addressing a particular device.</p>
+
+<h2 id="device-registration">Device Registration</h2>
+
+<p>Hono components use the <a href="/hono/docs/1.2/api/device-registration/">Device Registration API</a> to access device registration information. The API defines the <em>assert Registration</em> operation for verifying a device&rsquo;s registration status.
+In many real world scenarios there will already be a component in place which keeps track of devices and which supports the particular <em>provisioning process</em> being used to bring devices into life. In such cases it makes sense to simply implement the Device Registration API as a <em>facade</em> on top of the existing component.</p>
+
+<p>In addition to that, Hono defines a <a href="/hono/docs/1.2/api/management/">Device Registry Management API</a>, which can be implemented to take advantage of standardized  operations for managing devices and credentials. This API is optional because Hono components do not require it during runtime.</p>
+
+<p>For demonstration purposes, Hono comes with a <a href="/hono/docs/1.2/admin-guide/device-registry-config/">simple default implementation</a> of both APIs which keeps all data in memory only. Therefore it is not supposed to be used in production scenarios. For the future, it is planned that a production-ready Device Registry will be released as part of Hono that implements both APIs.</p>
+
+<h2 id="device-authentication">Device Authentication</h2>
+
+<p>Devices connect to protocol adapters in order to publish telemetry data or events. Downstream applications consuming this data often take particular actions based on the content of the messages. Such actions may include simply updating some statistics, e.g. tracking the average room temperature, but may also trigger more serious activities like shutting down a power plant. It is therefore important that applications can rely on the fact that the messages they process have in fact been produced by the device indicated by a message&rsquo;s source address.</p>
+
+<p>Hono relies on protocol adapters to establish a device&rsquo;s identity before it is allowed to publish downstream data or receive commands. Conceptually, Hono distinguishes between two identities</p>
+
+<ol>
+<li>an identity associated with the authentication credentials (termed the <em>authentication identity</em> or <em>auth-id</em>), and</li>
+<li>an identity to act as (the <em>device identity</em> or <em>device-id</em>).</li>
+</ol>
+
+<p>A device therefore presents an <em>auth-id</em> as part of its credentials during the authentication process which is then resolved to a <em>device identity</em> by the protocol adapter on successful verification of the credentials.</p>
+
+<p>In order to support the protocol adapters in the process of verifying credentials presented by a device, the <a href="/hono/docs/1.2/api/credentials/">Credentials API</a> provides means to look up <em>secrets</em> on record for the device and use this information to verify the credentials.</p>
+
+<p>The Credentials API supports registration of multiple sets of credentials for each device. A set of credentials consists of an <em>auth-id</em> and some sort of <em>secret</em> information. The particular <em>type</em> of secret determines the kind of information kept. Please refer to the <a href="/hono/docs/1.2/api/credentials/#standard-credential-types">Standard Credential Types</a> defined in the Credentials API for details. Based on this approach, a device may be authenticated using different types of secrets, e.g. a <em>hashed password</em> or a <em>pre-shared key</em>, depending on the capabilities of the device and/or protocol adapter.</p>
+
+<p>Once the protocol adapter has resolved the <em>device-id</em> for a device, it uses this identity when referring to the device in all subsequent API invocations, e.g. when forwarding telemetry messages downstream to the AMQP Messaging Network.</p>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/concepts/device-notifications/index.html b/docs/1.2/concepts/device-notifications/index.html
new file mode 100644
index 0000000..dfd5127
--- /dev/null
+++ b/docs/1.2/concepts/device-notifications/index.html
@@ -0,0 +1,2547 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Device Notifications :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Device Notifications :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Device Notifications :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/concepts/device-notifications//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/concepts/device-notifications/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item active">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/device-notifications/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/concepts/device-notifications/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/concepts/device-notifications/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/concepts/device-notifications.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/concepts/'>Concepts</a> > Device Notifications
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#time-until-disconnect-notification">Time until Disconnect Notification</a>
+<ul>
+<li><a href="#determining-a-device-s-connection-status">Determining a Device&rsquo;s Connection Status</a></li>
+<li><a href="#source-of-the-ttd-value">Source of the <em>ttd</em> Value</a></li>
+<li><a href="#hono-s-http-protocol-adapter">Hono&rsquo;s HTTP protocol adapter</a></li>
+<li><a href="#hono-s-mqtt-protocol-adapter">Hono&rsquo;s MQTT protocol adapter</a></li>
+<li><a href="#examples">Examples</a></li>
+</ul></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Device Notifications</h1>
+          
+
+        
+
+
+<p><em>Business Applications</em> need to know when an attempt to send a command to device is feasible, e.g. because the device is then known to be connected to a protocol adapter. <em>Devices</em> and <em>Protocol Adapters</em> can indicate to <em>Business Applications</em> a device&rsquo;s intent to e.g. receive commands using specific <em>notifications</em>.</p>
+
+<h2 id="time-until-disconnect-notification">Time until Disconnect Notification</h2>
+
+<p><em>Devices</em> and <em>Protocol Adapters</em> can notify an application about the fact that a device is connected and ready to receive one or more commands by means of including a <em>time &lsquo;til disconnect</em> (<em>ttd</em>) property in telemetry or event messages.</p>
+
+<p>The <em>ttd</em> property value indicates the time that the device will stay connected to the protocol adapter.
+Using this value together with the <em>creation-time</em> of the message, an application can determine whether an attempt to send a command to the device has a reasonable chance of succeeding.
+The <em>ttd</em> property can be included in any regular telemetry or event message. However, if a device does not have any telemetry data or event to upload to the adapter, it can also use an <a href="/hono/docs/1.2/api/event/#empty-notification">empty notification</a> instead.</p>
+
+<p>Hono includes utility classes that application developers can use to register a callback to be notified when a device sends a <em>ttd</em> notification.
+See Hono&rsquo;s example module for details where such a notification callback is used.
+Please refer to the <a href="/hono/docs/1.2/api/telemetry/">Telemetry API</a> and the <a href="/hono/docs/1.2/api/event/">Event API</a> for further details.</p>
+
+<p>The following table defines the possible values of the <em>ttd</em> property and their semantics:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">TTD</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left">&gt; 0</td>
+<td align="left">The value indicates the number of seconds that the device will stay connected. Devices using a stateless protocol like HTTP will be able to receive a single command only before disconnecting.</td>
+</tr>
+
+<tr>
+<td align="left">-1</td>
+<td align="left">The device is now connected (i.e. available to receive upstream messages) until further notice.</td>
+</tr>
+
+<tr>
+<td align="left">0</td>
+<td align="left">The device is now disconnected (i.e. not available anymore to receive upstream messages).</td>
+</tr>
+</tbody>
+</table>
+
+<h3 id="determining-a-device-s-connection-status">Determining a Device&rsquo;s Connection Status</h3>
+
+<p>An application receiving a downstream message containing a <em>ttd</em> property can check if the device is currently connected
+(and thus ready to receive a command) by</p>
+
+<ul>
+<li>adding the <em>ttd</em> value to the <em>creation-time</em> to determine the <em>expiration</em> time, and then</li>
+<li>comparing the <em>current</em> time with the <em>expiration</em> time</li>
+</ul>
+
+<p>If the <em>current</em> time is <em>after</em> the <em>expiration</em> time, the device should be assumed to already have disconnected again.</p>
+
+<h3 id="source-of-the-ttd-value">Source of the <em>ttd</em> Value</h3>
+
+<p>While it seems to be natural that a device itself indicates when it is ready to receive a command, it may not always be
+possible or desirable to do so.
+A device could e.g. be not capable to specify the value for <em>ttd</em> in it&rsquo;s message, or all devices of a particular setup
+would always use the same value for <em>ttd</em>, so it would not make much sense to provide this value always again.
+Additionally different protocols may or may not let a sender set specific values for a message, so a device using a
+specific protocol may not be able to provide a value for the <em>ttd</em> property at all.
+For these reasons there are (resp. may be) additional ways of setting the value of <em>ttd</em>:</p>
+
+<ul>
+<li>Hono&rsquo;s Tenant and Device Registration APIs support the inclusion of default values for application-properties in the
+AMQP 1.0 message. By these means a device can be configured to always have a specific value for <em>ttd</em>.</li>
+<li>In a future extension there may be a configuration value per tenant and protocol adapter that sets the value of <em>ttd</em>
+if it was not provided by other means already (like provided to the protocol adapter or by setting a default value).
+<br /></li>
+</ul>
+
+<h3 id="hono-s-http-protocol-adapter">Hono&rsquo;s HTTP protocol adapter</h3>
+
+<p>Hono&rsquo;s HTTP protocol adapter supports the setting of the <em>ttd</em> value in requests explicitly - please refer to the
+<a href="/hono/docs/1.2/user-guide/http-adapter/">HTTP Adapter</a> for details.
+Alternatively the default property values for devices from the Device Registry can be used (described above).</p>
+
+<h3 id="hono-s-mqtt-protocol-adapter">Hono&rsquo;s MQTT protocol adapter</h3>
+
+<p>The MQTT protocol adapter automatically sends a <em>Time until disconnect notification</em> with a <em>ttd</em> value of <code>-1</code>
+for a device that subscribes to the appropriate command topic (refer to the <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">MQTT Adapter user guide</a> for details).</p>
+
+<p>When a device unsubscribes again, the adapter automatically sends a <em>Time until disconnect notification</em> with a <em>ttd</em> value of <code>0</code>.</p>
+
+<h3 id="examples">Examples</h3>
+
+<p>The following sequence diagram shows a <em>Time until disconnect notification</em> while sending a telemetry message downstream
+via the HTTP protocol adapter:</p>
+
+<figure>
+    <img src="../device_commandReadinessImplicit.svg"/> <figcaption>
+            <h4>Device command readiness with telemetry data</h4>
+        </figcaption>
+</figure>
+
+
+<p>The following sequence diagram shows a <em>Time until disconnect notification</em> by sending an empty event message downstream
+via the HTTP protocol adapter:</p>
+
+<figure>
+    <img src="../device_commandReadinessExplicit.svg"/> <figcaption>
+            <h4>Device command readiness with explicit event</h4>
+        </figcaption>
+</figure>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/concepts/device-provisioning/auto-provisioning.svg b/docs/1.2/concepts/device-provisioning/auto-provisioning.svg
new file mode 100644
index 0000000..64a6b2f
--- /dev/null
+++ b/docs/1.2/concepts/device-provisioning/auto-provisioning.svg
@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="787.2px" preserveAspectRatio="none" style="width:1238px;height:787px;" version="1.1" viewBox="0 0 1238 787" width="1238.4px" zoomAndPan="magnify"><defs><filter height="300%" id="f10qk0o7i5gq0t" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="769.5" style="stroke: #A80036; stroke-width: 1.2;" width="461.4" x="672" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="138" x="833.7" y="19.2803">Device Registry</text><rect fill="#FFFFFF" filter="url(#f10qk0o7i5gq0t)" height="570.9563" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="273" y="127.0313"/><rect fill="#FFFFFF" filter="url(#f10qk0o7i5gq0t)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="711" y="213.75"/><rect fill="#FFFFFF" filter="url(#f10qk0o7i5gq0t)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="854.4" y="652.2281"/><rect fill="#FFFFFF" filter="url(#f10qk0o7i5gq0t)" height="168.9562" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1065" y="335.4281"/><rect fill="#FFFFFF" filter="url(#f10qk0o7i5gq0t)" height="213.2813" style="stroke: #000000; stroke-width: 2.4;" width="1049.4" x="162.6" y="353.4281"/><rect fill="#FFFFFF" height="52.725" style="stroke: none; stroke-width: 1.2;" width="1049.4" x="162.6" y="513.9844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="48" x2="48" y1="89.6719" y2="708.7875"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="279" x2="279" y1="89.6719" y2="708.7875"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="716.4" x2="716.4" y1="89.6719" y2="708.7875"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="860.4" x2="860.4" y1="89.6719" y2="708.7875"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1071" x2="1071" y1="89.6719" y2="708.7875"/><rect fill="#FEFECE" filter="url(#f10qk0o7i5gq0t)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="9.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="18" y="71.3098">Device</text><rect fill="#FEFECE" filter="url(#f10qk0o7i5gq0t)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="9.6" y="707.5875"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="18" y="731.5816">Device</text><rect fill="#FEFECE" filter="url(#f10qk0o7i5gq0t)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="174.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="183" y="71.3098">Hono Protocol Adapter</text><rect fill="#FEFECE" filter="url(#f10qk0o7i5gq0t)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="174.6" y="707.5875"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="183" y="731.5816">Hono Protocol Adapter</text><rect fill="#FEFECE" filter="url(#f10qk0o7i5gq0t)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="75.6" x="676.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="58.8" x="685.2" y="51.7535">Tenant</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="25.2" x="702" y="71.3098">API</text><rect fill="#FEFECE" filter="url(#f10qk0o7i5gq0t)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="75.6" x="676.8" y="707.5875"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="58.8" x="685.2" y="731.5816">Tenant</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="25.2" x="702" y="751.1379">API</text><rect fill="#FEFECE" filter="url(#f10qk0o7i5gq0t)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="177.6" x="769.2" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="160.8" x="777.6" y="51.7535">Device Registration</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="25.2" x="845.4" y="71.3098">API</text><rect fill="#FEFECE" filter="url(#f10qk0o7i5gq0t)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="177.6" x="769.2" y="707.5875"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="160.8" x="777.6" y="731.5816">Device Registration</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="25.2" x="845.4" y="751.1379">API</text><rect fill="#FEFECE" filter="url(#f10qk0o7i5gq0t)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="110.4" x="1013.4" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="93.6" x="1021.8" y="51.7535">Credentials</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="25.2" x="1056" y="71.3098">API</text><rect fill="#FEFECE" filter="url(#f10qk0o7i5gq0t)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="110.4" x="1013.4" y="707.5875"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="93.6" x="1021.8" y="731.5816">Credentials</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="25.2" x="1056" y="751.1379">API</text><rect fill="#FFFFFF" filter="url(#f10qk0o7i5gq0t)" height="570.9563" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="273" y="127.0313"/><rect fill="#FFFFFF" filter="url(#f10qk0o7i5gq0t)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="711" y="213.75"/><rect fill="#FFFFFF" filter="url(#f10qk0o7i5gq0t)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="854.4" y="652.2281"/><rect fill="#FFFFFF" filter="url(#f10qk0o7i5gq0t)" height="168.9562" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1065" y="335.4281"/><polygon fill="#A80036" points="258.6,122.2312,270.6,127.0313,258.6,131.8312,263.4,127.0313" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="48.6" x2="265.8" y1="127.0313" y2="127.0313"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="201.6" x="57" y="120.9521">connect(X.509 Client Cert)</text><rect fill="#EEEEEE" filter="url(#f10qk0o7i5gq0t)" height="3.6" style="stroke: #EEEEEE; stroke-width: 1.2;" width="1221" x="3.6" y="161.3109"/><line style="stroke: #000000; stroke-width: 1.2;" x1="3.6" x2="1224.6" y1="161.3109" y2="161.3109"/><line style="stroke: #000000; stroke-width: 1.2;" x1="3.6" x2="1224.6" y1="164.9109" y2="164.9109"/><rect fill="#EEEEEE" filter="url(#f10qk0o7i5gq0t)" height="27.7594" style="stroke: #000000; stroke-width: 2.4;" width="140.4" x="543.9" y="148.6313"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="117.6" x="551.1" y="167.9115">Query Tenant</text><polygon fill="#A80036" points="696.6,208.95,708.6,213.75,696.6,218.55,701.4,213.75" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="285" x2="703.8" y1="213.75" y2="213.75"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="403.2" x="293.4" y="207.6709">transfer(subject: "get", body: {"subject-dn": $caDN})</text><polygon fill="#A80036" points="298.2,243.9094,286.2,248.7094,298.2,253.5094,293.4,248.7094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="291" x2="715.8" y1="248.7094" y2="248.7094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="333.6" x="305.4" y="242.6303">transfer(status: "200", ..., body: tenant info)</text><rect fill="#EEEEEE" filter="url(#f10qk0o7i5gq0t)" height="3.6" style="stroke: #EEEEEE; stroke-width: 1.2;" width="1221" x="3.6" y="282.9891"/><line style="stroke: #000000; stroke-width: 1.2;" x1="3.6" x2="1224.6" y1="282.9891" y2="282.9891"/><line style="stroke: #000000; stroke-width: 1.2;" x1="3.6" x2="1224.6" y1="286.5891" y2="286.5891"/><rect fill="#EEEEEE" filter="url(#f10qk0o7i5gq0t)" height="27.7594" style="stroke: #000000; stroke-width: 2.4;" width="181.2" x="523.5" y="270.3094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="158.4" x="530.7" y="289.5896">Query Credentials</text><polygon fill="#A80036" points="1050.6,330.6281,1062.6,335.4281,1050.6,340.2281,1055.4,335.4281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="285" x2="1057.8" y1="335.4281" y2="335.4281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="757.2" x="293.4" y="329.349">transfer(subject: "get", body: {"type": "x509-cert", "auth-id": $subjectDN, "client-certificate": $cert})</text><path d="M162.6,353.4281 L239.4,353.4281 L239.4,361.8281 L227.4,373.8281 L162.6,373.8281 L162.6,353.4281 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="213.2813" style="stroke: #000000; stroke-width: 2.4;" width="1049.4" x="162.6" y="353.4281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="22.8" x="180.6" y="369.1084">alt</text><text fill="#000000" font-family="sans-serif" font-size="13.2" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="88.8" x="257.4" y="368.0807">[First Time]</text><line style="stroke: #A80036; stroke-width: 1.2;" x1="1077" x2="1127.4" y1="453.825" y2="453.825"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1127.4" x2="1127.4" y1="453.825" y2="469.425"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1078.2" x2="1127.4" y1="469.425" y2="469.425"/><polygon fill="#A80036" points="1090.2,464.625,1078.2,469.425,1090.2,474.225,1085.4,469.425" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="51.6" x="1085.4" y="393.2678">Create</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="120" x="1085.4" y="411.4271">Credentials and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="91.2" x="1085.4" y="429.5865">Registration</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="87.6" x="1085.4" y="447.7459">Information</text><path d="M706.8,409.0266 L706.8,439.0266 L1053.6,439.0266 L1053.6,421.0266 L1041.6,409.0266 L706.8,409.0266 " fill="#FBFB77" filter="url(#f10qk0o7i5gq0t)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M1041.6,409.0266 L1041.6,421.0266 L1053.6,421.0266 L1041.6,409.0266 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="321.6" x="714" y="429.5068">If device Registry does not find credentials</text><polygon fill="#A80036" points="298.2,499.5844,286.2,504.3844,298.2,509.1844,293.4,504.3844" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="291" x2="1069.8" y1="504.3844" y2="504.3844"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="343.2" x="305.4" y="498.3053">transfer(status: "201", body: credentials info)</text><line style="stroke: #000000; stroke-width: 1.2; stroke-dasharray: 2.0,2.0;" x1="162.6" x2="1212" y1="515.1844" y2="515.1844"/><text fill="#000000" font-family="sans-serif" font-size="13.2" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="159.6" x="168.6" y="527.4369">[Following requests]</text><polygon fill="#A80036" points="298.2,552.3094,286.2,557.1094,298.2,561.9094,293.4,557.1094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="291" x2="1069.8" y1="557.1094" y2="557.1094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="343.2" x="305.4" y="551.0303">transfer(status: "200", body: credentials info)</text><rect fill="#EEEEEE" filter="url(#f10qk0o7i5gq0t)" height="3.6" style="stroke: #EEEEEE; stroke-width: 1.2;" width="1221" x="3.6" y="599.7891"/><line style="stroke: #000000; stroke-width: 1.2;" x1="3.6" x2="1224.6" y1="599.7891" y2="599.7891"/><line style="stroke: #000000; stroke-width: 1.2;" x1="3.6" x2="1224.6" y1="603.3891" y2="603.3891"/><rect fill="#EEEEEE" filter="url(#f10qk0o7i5gq0t)" height="27.7594" style="stroke: #000000; stroke-width: 2.4;" width="296.4" x="465.9" y="587.1094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="273.6" x="473.1" y="606.3896">Query Registration Information</text><polygon fill="#A80036" points="840,647.4281,852,652.2281,840,657.0281,844.8,652.2281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="285" x2="847.2" y1="652.2281" y2="652.2281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="274.8" x="293.4" y="646.149">transfer(subject: "assert", device-id)</text><polygon fill="#A80036" points="298.2,682.3875,286.2,687.1875,298.2,691.9875,293.4,687.1875" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="291" x2="859.2" y1="687.1875" y2="687.1875"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="391.2" x="305.4" y="681.1084">transfer(status: "200", ..., body: registration status)</text><!--MD5=[5723191dc61232a9f18dcb3faf30bdcb]
+@startuml
+skinparam BoxPadding 10
+scale 1.2
+
+participant "Device"
+participant "Hono Protocol Adapter" as PA
+box "Device Registry" 
+  participant "Tenant\nAPI" as tenant 
+  participant "Device Registration\nAPI" as reg 
+  participant "Credentials\nAPI" as cred 
+end box
+
+Device -> PA++: connect(X.509 Client Cert)
+
+
+== Query Tenant ==
+PA -> tenant++: transfer(subject: "get", body: {"subject-dn": $caDN})
+PA <- tenant- -: transfer(status: "200", ..., body: tenant info)
+
+== Query Credentials ==
+PA -> cred++: transfer(subject: "get", body: {"type": "x509-cert", "auth-id": $subjectDN, "client-certificate": $cert}) 
+
+alt First Time 
+  cred -> cred: Create\nCredentials and \nRegistration\nInformation
+  note left: If device Registry does not find credentials
+
+  PA <- cred- -: transfer(status: "201", body: credentials info)
+else Following requests
+  PA <- cred- -: transfer(status: "200", body: credentials info)
+end
+
+== Query Registration Information ==
+PA -> reg++: transfer(subject: "assert", device-id)
+PA <- reg- -: transfer(status: "200", ..., body: registration status)
+@enduml
+
+PlantUML version 1.2019.13(Tue Dec 10 17:18:29 UTC 2019)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/concepts/device-provisioning/index.html b/docs/1.2/concepts/device-provisioning/index.html
new file mode 100644
index 0000000..8d36a00
--- /dev/null
+++ b/docs/1.2/concepts/device-provisioning/index.html
@@ -0,0 +1,2551 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Device Provisioning :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Device Provisioning :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Device Provisioning :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/concepts/device-provisioning//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/concepts/device-provisioning/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item active">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/concepts/device-provisioning/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/device-provisioning/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/concepts/device-provisioning/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/concepts/device-provisioning/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/concepts/device-provisioning/index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/concepts/'>Concepts</a> > Device Provisioning
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#manual-device-provisioning">Manual Device Provisioning</a></li>
+<li><a href="#automatic-device-provisioning">Automatic Device Provisioning</a>
+<ul>
+<li><a href="#prerequisites">Prerequisites</a></li>
+<li><a href="#sequence-of-steps-in-auto-provisioning">Sequence of steps in Auto-Provisioning</a>
+<ul>
+<li><a href="#step-1-configure-the-tenant">Step 1: Configure the Tenant</a></li>
+<li><a href="#step-2-connect-an-unregistered-device-to-hono">Step 2: Connect an unregistered Device to Hono</a></li>
+</ul></li>
+</ul></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Device Provisioning</h1>
+          
+
+        
+
+
+
+
+<p>This page describes how devices are provisioned in Hono, i.e. how their digital representation is generated.
+For each device, registration information is stored that defines a device identity.
+Each device belongs to exactly one tenant. Each device must have at least one set of credentials that are used to authenticate to Hono.</p>
+
+<p>To get an understanding of what is meant by the terms <em>tenant</em>, <em>device registration</em> and <em>credentials</em>,
+it is recommended to read the <a href="/hono/docs/1.2/concepts/device-identity/">Device Identity</a> page first.</p>
+
+<p>So in order to use a device with Hono, it has to be provisioned.
+This means that registration information and at least one credential record must be stored in the device registry.</p>
+
+<p>There are different ways to perform device provisioning.</p>
+
+<h2 id="manual-device-provisioning">Manual Device Provisioning</h2>
+
+<p>Devices can be provisioned using Hono&rsquo;s <a href="/hono/docs/1.2/api/management/">Device Registry Management API</a> via HTTP.</p>
+
+<p>If the desired <em>tenant</em> does not yet exist, it must be created first.
+How to do this is described in the <a href="/hono/docs/1.2/user-guide/device-registry/#add-a-tenant">User Guide</a>
+of the Device Registry.</p>
+
+<p>The actual Device Provisioning is then performed as described under
+<a href="/hono/docs/1.2/user-guide/device-registry/#register-device">Register Device</a>.
+This creates both a device identity and an (empty) credentials record. The last step is to add real credentials
+as described in <a href="/hono/docs/1.2/user-guide/device-registry/#update-credentials-for-a-device">Update Credentials for a Device</a>.</p>
+
+<h2 id="automatic-device-provisioning">Automatic Device Provisioning</h2>
+
+<p>The term <em>Auto-Provisioning</em> denotes a feature of Hono where the Device Registry automatically generates
+the credentials and registration information for a device the first time it connects.
+Auto-Provisioning is supported by Hono&rsquo;s protocol adapters for devices that authenticate with client certificates.
+The feature can be enabled per certificate authority (CA) at the tenant.</p>
+
+<h3 id="prerequisites">Prerequisites</h3>
+
+<p>Hono does not require a specific Device Registry implementation, but only specifies a set of APIs that must be provided by a compatible implementation.
+Since the main part of the <em>Auto-Provisioning</em> has to be done by the Device Registry, the used implementation must explicitly support this feature.</p>
+
+<h3 id="sequence-of-steps-in-auto-provisioning">Sequence of steps in Auto-Provisioning</h3>
+
+<p><em>Auto-Provisioning</em> consists of two steps.</p>
+
+<h4 id="step-1-configure-the-tenant">Step 1: Configure the Tenant</h4>
+
+<p>The CA to be used by the devices needs to be configured. The following tasks must be performed:</p>
+
+<ol>
+<li>Create tenant</li>
+<li>Configure the trusted CA for the tenant</li>
+<li>Enable the feature for the CA</li>
+</ol>
+
+<p>If the Device Registry implementation provides the <a href="/hono/docs/1.2/api/management/">Management API</a>, this could be done in a single step.
+For details refer to the <a href="/hono/docs/1.2/api/tenant/#trusted-ca-format">Tenant API specification</a>.</p>
+
+<h4 id="step-2-connect-an-unregistered-device-to-hono">Step 2: Connect an unregistered Device to Hono</h4>
+
+<figure>
+    <img src="auto-provisioning.svg"
+         alt="A unregistered device connects to a protocol adapter which uses the Credentials API to provision it"/> <figcaption>
+            <h4>Automatic Provisioning of a Device</h4>
+        </figcaption>
+</figure>
+
+
+<p>Hono&rsquo;s protocol adapters query the APIs of the Device Registry during <a href="/hono/docs/1.2/concepts/device-identity/">Device Authentication</a>.
+First, the Tenant API is queried. If the Tenant configuration returned contains the CA used for authentication and the
+feature is switched on for this CA, the protocol adapter assumes that automatic provisioning must be performed.
+It puts the device&rsquo;s certificate into the query to enable the device registry to do the provisioning.</p>
+
+<p>If the Device Registry does not find any credentials for the device, it takes the information from the client
+certificate to create both credentials and device registration data for it.</p>
+
+<p>The Device Registry is expected to perform the following steps:</p>
+
+<ol>
+<li>Generate a unique device-id</li>
+<li>Create device</li>
+<li>Create credentials</li>
+<li>Optional: Provision device in external systems</li>
+</ol>
+
+<p>The newly created credentials are returned to the protocol adapter in the response as if they had been present before.</p>
+
+<p>The following query of the Device Registration API returns the previously generated registration data.</p>
+
+<p>The provisioning is, of course, a one-time action, on subsequent connections the APIs simply return the stored records.</p>
+
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/concepts/device_commandReadinessExplicit.svg b/docs/1.2/concepts/device_commandReadinessExplicit.svg
new file mode 100644
index 0000000..f51d1e5
--- /dev/null
+++ b/docs/1.2/concepts/device_commandReadinessExplicit.svg
@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="711.6px" preserveAspectRatio="none" style="width:1803px;height:711px;" version="1.1" viewBox="0 0 1803 711" width="1803.6px" zoomAndPan="magnify"><defs><filter height="300%" id="f1r9pxs4xq39he" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="48" x2="48" y1="45.9563" y2="663.3844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="789" x2="789" y1="45.9563" y2="663.3844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1253.4" x2="1253.4" y1="45.9563" y2="663.3844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1527.6" x2="1527.6" y1="45.9563" y2="663.3844"/><rect fill="#FEFECE" filter="url(#f1r9pxs4xq39he)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="18" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#f1r9pxs4xq39he)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="9.6" y="662.1844"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="18" y="686.1785">Device</text><rect fill="#FEFECE" filter="url(#f1r9pxs4xq39he)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="684.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="693" y="27.5941">HTTP Protocol Adapter</text><rect fill="#FEFECE" filter="url(#f1r9pxs4xq39he)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="684.6" y="662.1844"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="693" y="686.1785">HTTP Protocol Adapter</text><rect fill="#FEFECE" filter="url(#f1r9pxs4xq39he)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="1165.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="1174.2" y="27.5941">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#f1r9pxs4xq39he)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="1165.8" y="662.1844"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="1174.2" y="686.1785">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#f1r9pxs4xq39he)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="198" x="1426.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="181.2" x="1435.2" y="27.5941">Consumer Application</text><rect fill="#FEFECE" filter="url(#f1r9pxs4xq39he)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="198" x="1426.8" y="662.1844"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="181.2" x="1435.2" y="686.1785">Consumer Application</text><path d="M54,63.9563 L54,111.9563 L476.4,111.9563 L476.4,75.9563 L464.4,63.9563 L54,63.9563 " fill="#FBFB77" filter="url(#f1r9pxs4xq39he)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M464.4,63.9563 L464.4,75.9563 L476.4,75.9563 L464.4,63.9563 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="397.2" x="61.2" y="84.4365">sending explicit event to signal command readiness</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="181.2" x="61.2" y="102.5959">for the next 60 seconds</text><path d="M54,129.075 L54,177.075 L493.2,177.075 L493.2,141.075 L481.2,129.075 L54,129.075 " fill="#FBFB77" filter="url(#f1r9pxs4xq39he)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M481.2,129.075 L481.2,141.075 L493.2,141.075 L481.2,129.075 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="414" x="61.2" y="149.5553">The HTTP specific header "hono-ttd" is used to provide</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="270" x="61.2" y="167.7146">the value for ttd by the device itself</text><polygon fill="#A80036" points="774.6,208.7531,786.6,213.5531,774.6,218.3531,779.4,213.5531" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="48.6" x2="781.8" y1="213.5531" y2="213.5531"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="711.6" x="57" y="207.474">POST event(hono-ttd="60", Content-Type="application/vnd.eclipse-hono-empty-notification")</text><path d="M608.4,229.1531 L608.4,331.1531 L963.6,331.1531 L963.6,241.1531 L951.6,229.1531 L608.4,229.1531 " fill="#FBFB77" filter="url(#f1r9pxs4xq39he)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M951.6,229.1531 L951.6,241.1531 L963.6,241.1531 L951.6,229.1531 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="193.2" x="615.6" y="249.6334">Set AMQP 1.0 properties:</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="615.6" y="267.7928">tenant-id: "TENANT",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="615.6" y="285.9521">device-id: "4711",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="330" x="615.6" y="304.1115">creation-time: NOW (in epoch milliseconds)</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="615.6" y="322.2709">ttd: value from http-ttd</text><polygon fill="#A80036" points="1239,363.3094,1251,368.1094,1239,372.9094,1243.8,368.1094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="789" x2="1246.2" y1="368.1094" y2="368.1094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="435.6" x="797.4" y="362.0303">1.0 transfer("event/TENANT", "4711", , creation-time, ttd)</text><polygon fill="#A80036" points="1513.8,398.2688,1525.8,403.0687,1513.8,407.8688,1518.6,403.0687" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1253.4" x2="1521" y1="403.0687" y2="403.0687"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="246" x="1261.8" y="396.9896">1.2 transfer("event/TENANT", ...)</text><polygon fill="#A80036" points="1266.6,433.2281,1254.6,438.0281,1266.6,442.8281,1261.8,438.0281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1259.4" x2="1527" y1="438.0281" y2="438.0281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="1273.8" y="431.949">2.0 disposition("accepted")</text><polygon fill="#A80036" points="802.2,468.1875,790.2,472.9875,802.2,477.7875,797.4,472.9875" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="795" x2="1252.2" y1="472.9875" y2="472.9875"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="809.4" y="466.9084">2.0 disposition("accepted")</text><polygon fill="#A80036" points="61.8,503.1469,49.8,507.9469,61.8,512.7469,57,507.9469" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="54.6" x2="787.8" y1="507.9469" y2="507.9469"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="69" y="501.8678">HTTP/1.1 202 Accepted</text><line style="stroke: #A80036; stroke-width: 1.2;" x1="1528.2" x2="1578.6" y1="542.9063" y2="542.9063"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1578.6" x2="1578.6" y1="542.9063" y2="558.5063"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1529.4" x2="1578.6" y1="558.5063" y2="558.5063"/><polygon fill="#A80036" points="1541.4,553.7063,1529.4,558.5063,1541.4,563.3063,1536.6,558.5063" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="253.2" x="1536.6" y="536.8271">callbackIfValid(creation-time, ttd)</text><path d="M1314,574.1062 L1314,640.1062 L1736.4,640.1062 L1736.4,586.1062 L1724.4,574.1062 L1314,574.1062 " fill="#FBFB77" filter="url(#f1r9pxs4xq39he)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M1724.4,574.1062 L1724.4,586.1062 L1736.4,586.1062 L1724.4,574.1062 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="397.2" x="1321.2" y="594.5865">React if message indicates that currently the device</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="237.6" x="1321.2" y="612.7459">is ready to receive a command</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="271.2" x="1321.2" y="630.9053">(e.g. by trying to send a command)</text><!--
+@startuml
+scale 1.2
+
+participant Device
+
+participant "HTTP Protocol Adapter"
+participant "AMQP 1.0 Network"
+participant "Consumer Application"
+
+note right of Device
+sending explicit event to signal command readiness
+for the next 60 seconds
+end note
+note right of Device
+The HTTP specific header "hono-ttd" is used to provide
+the value for ttd by the device itself
+end note
+
+Device -> "HTTP Protocol Adapter": POST event(hono-ttd="60", Content-Type="application/vnd.eclipse-hono-empty-notification")
+
+note over "HTTP Protocol Adapter"
+Set AMQP 1.0 properties:
+tenant-id: "TENANT",
+device-id: "4711",
+creation-time: NOW (in epoch milliseconds)
+ttd: value from http-ttd
+end note
+
+"HTTP Protocol Adapter" -> "AMQP 1.0 Network": 1.0 transfer("event/TENANT", "4711", , creation-time, ttd)
+"AMQP 1.0 Network" -> "Consumer Application": 1.2 transfer("event/TENANT", ...)
+"Consumer Application" -> "AMQP 1.0 Network": 2.0 disposition("accepted")
+"AMQP 1.0 Network" -> "HTTP Protocol Adapter": 2.0 disposition("accepted")
+
+
+"HTTP Protocol Adapter" -> Device: HTTP/1.1 202 Accepted
+
+"Consumer Application" -> "Consumer Application": callbackIfValid(creation-time, ttd)
+note over "Consumer Application"
+React if message indicates that currently the device
+is ready to receive a command
+(e.g. by trying to send a command)
+end note
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/concepts/device_commandReadinessImplicit.svg b/docs/1.2/concepts/device_commandReadinessImplicit.svg
new file mode 100644
index 0000000..836a06a
--- /dev/null
+++ b/docs/1.2/concepts/device_commandReadinessImplicit.svg
@@ -0,0 +1,61 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="740.4px" preserveAspectRatio="none" style="width:1734px;height:740px;" version="1.1" viewBox="0 0 1734 740" width="1734px" zoomAndPan="magnify"><defs><filter height="300%" id="fnzp9xyiux0bi" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="361.2" x2="361.2" y1="45.9563" y2="692.1844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="657" x2="657" y1="45.9563" y2="692.1844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1152.6" x2="1152.6" y1="45.9563" y2="692.1844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1458" x2="1458" y1="45.9563" y2="692.1844"/><rect fill="#FEFECE" filter="url(#fnzp9xyiux0bi)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="322.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="331.2" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#fnzp9xyiux0bi)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="322.8" y="690.9844"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="331.2" y="714.9785">Device</text><rect fill="#FEFECE" filter="url(#fnzp9xyiux0bi)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="552.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="561" y="27.5941">HTTP Protocol Adapter</text><rect fill="#FEFECE" filter="url(#fnzp9xyiux0bi)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="552.6" y="690.9844"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="561" y="714.9785">HTTP Protocol Adapter</text><rect fill="#FEFECE" filter="url(#fnzp9xyiux0bi)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="1065" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="1073.4" y="27.5941">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#fnzp9xyiux0bi)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="1065" y="690.9844"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="1073.4" y="714.9785">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#fnzp9xyiux0bi)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="198" x="1357.2" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="181.2" x="1365.6" y="27.5941">Consumer Application</text><rect fill="#FEFECE" filter="url(#fnzp9xyiux0bi)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="198" x="1357.2" y="690.9844"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="181.2" x="1365.6" y="714.9785">Consumer Application</text><path d="M9.6,63.9563 L9.6,111.9563 L351.6,111.9563 L351.6,75.9563 L339.6,63.9563 L9.6,63.9563 " fill="#FBFB77" filter="url(#fnzp9xyiux0bi)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M339.6,63.9563 L339.6,75.9563 L351.6,75.9563 L339.6,63.9563 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="316.8" x="16.8" y="84.4365">sending telemetry data with explicit value</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="188.4" x="16.8" y="102.5959">for ttd set to 60 seconds</text><polygon fill="#A80036" points="642.6,143.6344,654.6,148.4344,642.6,153.2344,647.4,148.4344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="361.8" x2="649.8" y1="148.4344" y2="148.4344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="266.4" x="370.2" y="142.3553">telemetry(hono-ttd="60", payload)</text><path d="M139.2,164.0344 L139.2,212.0344 L578.4,212.0344 L578.4,176.0344 L566.4,164.0344 L139.2,164.0344 " fill="#FBFB77" filter="url(#fnzp9xyiux0bi)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M566.4,164.0344 L566.4,176.0344 L578.4,176.0344 L566.4,164.0344 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="414" x="146.4" y="184.5146">The HTTP specific header "hono-ttd" is used to provide</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="270" x="146.4" y="202.674">the value for ttd by the device itself</text><path d="M476.4,229.1531 L476.4,313.1531 L831.6,313.1531 L831.6,241.1531 L819.6,229.1531 L476.4,229.1531 " fill="#FBFB77" filter="url(#fnzp9xyiux0bi)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M819.6,229.1531 L819.6,241.1531 L831.6,241.1531 L819.6,229.1531 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="193.2" x="483.6" y="249.6334">Set AMQP 1.0 properties:</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="483.6" y="267.7928">tenant-id: "TENANT",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="483.6" y="285.9521">device-id: "4711",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="330" x="483.6" y="304.1115">creation-time: NOW (in epoch milliseconds)</text><polygon fill="#A80036" points="1138.2,345.15,1150.2,349.95,1138.2,354.75,1143,349.95" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="657" x2="1145.4" y1="349.95" y2="349.95"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="466.8" x="665.4" y="343.8709">1.0 transfer("telemetry/TENANT", "4711", , creation-time, ttd)</text><polygon fill="#A80036" points="1444.2,380.1094,1456.2,384.9094,1444.2,389.7094,1449,384.9094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1152.6" x2="1451.4" y1="384.9094" y2="384.9094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="277.2" x="1161" y="378.8303">1.2 transfer("telemetry/TENANT", ...)</text><polygon fill="#A80036" points="1165.8,415.0687,1153.8,419.8688,1165.8,424.6688,1161,419.8688" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1158.6" x2="1457.4" y1="419.8688" y2="419.8688"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="1173" y="413.7896">2.0 disposition("accepted")</text><polygon fill="#A80036" points="670.2,450.0281,658.2,454.8281,670.2,459.6281,665.4,454.8281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="663" x2="1151.4" y1="454.8281" y2="454.8281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="677.4" y="448.749">2.0 disposition("accepted")</text><polygon fill="#A80036" points="375,484.9875,363,489.7875,375,494.5875,370.2,489.7875" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="367.8" x2="655.8" y1="489.7875" y2="489.7875"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="382.2" y="483.7084">HTTP/1.1 202 Accepted</text><path d="M1324.8,505.3875 L1324.8,535.3875 L1586.4,535.3875 L1586.4,517.3875 L1574.4,505.3875 L1324.8,505.3875 " fill="#FBFB77" filter="url(#fnzp9xyiux0bi)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M1574.4,505.3875 L1574.4,517.3875 L1586.4,517.3875 L1574.4,505.3875 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="236.4" x="1332" y="525.8678">Processing the telemetry data.</text><line style="stroke: #A80036; stroke-width: 1.2;" x1="1458.6" x2="1509" y1="571.7063" y2="571.7063"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1509" x2="1509" y1="571.7063" y2="587.3063"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1459.8" x2="1509" y1="587.3063" y2="587.3063"/><polygon fill="#A80036" points="1471.8,582.5063,1459.8,587.3063,1471.8,592.1062,1467,587.3063" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="253.2" x="1467" y="565.6271">callbackIfValid(creation-time, ttd)</text><path d="M1244.4,602.9063 L1244.4,668.9063 L1666.8,668.9063 L1666.8,614.9063 L1654.8,602.9063 L1244.4,602.9063 " fill="#FBFB77" filter="url(#fnzp9xyiux0bi)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M1654.8,602.9063 L1654.8,614.9063 L1666.8,614.9063 L1654.8,602.9063 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="397.2" x="1251.6" y="623.3865">React if message indicates that currently the device</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="237.6" x="1251.6" y="641.5459">is ready to receive a command</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="271.2" x="1251.6" y="659.7053">(e.g. by trying to send a command)</text><!--
+@startuml
+scale 1.2
+
+participant Device
+
+participant "HTTP Protocol Adapter"
+participant "AMQP 1.0 Network"
+participant "Consumer Application"
+
+note left of Device
+sending telemetry data with explicit value
+for ttd set to 60 seconds
+end note
+
+Device -> "HTTP Protocol Adapter": telemetry(hono-ttd="60", payload)
+note over Device
+The HTTP specific header "hono-ttd" is used to provide
+the value for ttd by the device itself
+end note
+
+
+
+note over "HTTP Protocol Adapter"
+Set AMQP 1.0 properties:
+tenant-id: "TENANT",
+device-id: "4711",
+creation-time: NOW (in epoch milliseconds)
+end note
+
+"HTTP Protocol Adapter" -> "AMQP 1.0 Network": 1.0 transfer("telemetry/TENANT", "4711", , creation-time, ttd)
+"AMQP 1.0 Network" -> "Consumer Application": 1.2 transfer("telemetry/TENANT", ...)
+"Consumer Application" -> "AMQP 1.0 Network": 2.0 disposition("accepted")
+"AMQP 1.0 Network" -> "HTTP Protocol Adapter": 2.0 disposition("accepted")
+
+"HTTP Protocol Adapter" -> Device: HTTP/1.1 202 Accepted
+
+note over "Consumer Application"
+Processing the telemetry data.
+end note
+
+
+
+"Consumer Application" -> "Consumer Application": callbackIfValid(creation-time, ttd)
+note over "Consumer Application"
+React if message indicates that currently the device
+is ready to receive a command
+(e.g. by trying to send a command)
+end note
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/1.2/concepts/index.html b/docs/1.2/concepts/index.html
new file mode 100644
index 0000000..d2ef3a5
--- /dev/null
+++ b/docs/1.2/concepts/index.html
@@ -0,0 +1,2451 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Concepts :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Concepts :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Concepts :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/concepts//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/concepts/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        parent
+        active
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/concepts/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/concepts/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/concepts/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/concepts/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/concepts/_index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > Concepts
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+              </div>
+            </div>
+            
+
+        
+          <div id="chapter">
+        
+        <div id="body-inner">
+          
+
+        
+
+
+
+
+<h1 id="concepts">Concepts</h1>
+
+<p>Understand the concepts behind Eclipse Hono&trade;.</p>
+
+
+<footer class=" footline" >
+	
+</footer>
+
+        
+            </div> 
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
diff --git a/docs/1.2/concepts/index.xml b/docs/1.2/concepts/index.xml
new file mode 100644
index 0000000..2aa49a7
--- /dev/null
+++ b/docs/1.2/concepts/index.xml
@@ -0,0 +1,89 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>Concepts on Eclipse Hono&amp;trade; Vers.: 1.2</title>
+    <link>https://www.eclipse.org/hono/docs/1.2/concepts/</link>
+    <description>Recent content in Concepts on Eclipse Hono&amp;trade; Vers.: 1.2</description>
+    <generator>Hugo -- gohugo.io</generator>
+    <language>en-us</language>
+    
+	<atom:link href="https://www.eclipse.org/hono/docs/1.2/concepts/index.xml" rel="self" type="application/rss+xml" />
+    
+    
+    <item>
+      <title>Device Identity</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/concepts/device-identity/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/concepts/device-identity/</guid>
+      <description>&lt;p&gt;This page describes how devices are represented and identified throughout Hono and its APIs.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Multi-Tenancy</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/concepts/tenancy/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/concepts/tenancy/</guid>
+      <description>Hono is designed to structure the set of all internally managed data and data streams into strictly isolated subsets. This includes the registration data and credentials of devices, internal users that are used for authentication, and the Business Applications that are part of such subsets as well.
+This way of strict isolation is generally known as multi-tenancy, where a tenant is the term for such a subset. Such an isolation is essential for enabling a scalable distributed architecture to handle independent subsets as if each subset had its own installation (which would be much harder to maintain and would not benefit from runtime cost sharing).</description>
+    </item>
+    
+    <item>
+      <title>Device Provisioning</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/concepts/device-provisioning/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/concepts/device-provisioning/</guid>
+      <description>This page describes how devices are provisioned in Hono, i.e. how their digital representation is generated. For each device, registration information is stored that defines a device identity. Each device belongs to exactly one tenant. Each device must have at least one set of credentials that are used to authenticate to Hono.
+To get an understanding of what is meant by the terms tenant, device registration and credentials, it is recommended to read the Device Identity page first.</description>
+    </item>
+    
+    <item>
+      <title>Connecting Devices</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/concepts/connecting-devices/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/concepts/connecting-devices/</guid>
+      <description>One of the most important features of Eclipse Hono&amp;trade; is to abstract away the specific communication protocols used by devices. This page describes the different ways of how devices can be connected to Hono. Before a device can connect to Hono and upload data or receive commands from downstream applications, it needs to be provisioned to the system. As part of device provisioning, the device is associated with the tenant that it belongs to and gets assigned a logical identifier which is unique within the tenant.</description>
+    </item>
+    
+    <item>
+      <title>Device Notifications</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/concepts/device-notifications/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/concepts/device-notifications/</guid>
+      <description>&lt;p&gt;&lt;em&gt;Business Applications&lt;/em&gt; need to know when an attempt to send a command to device is feasible, e.g. because the device is then known to be connected to a protocol adapter. &lt;em&gt;Devices&lt;/em&gt; and &lt;em&gt;Protocol Adapters&lt;/em&gt; can indicate to &lt;em&gt;Business Applications&lt;/em&gt; a device&amp;rsquo;s intent to e.g. receive commands using specific &lt;em&gt;notifications&lt;/em&gt;.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Command &amp; Control</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/concepts/command-and-control/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/concepts/command-and-control/</guid>
+      <description>&lt;p&gt;&lt;em&gt;Business applications&lt;/em&gt; can send commands to devices following the &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/command-and-control/&#34;&gt;Command &amp;amp; Control API&lt;/a&gt;. This concept page describes how this API is used by applications to send commands and describes how Hono&amp;rsquo;s protocol adapters process the commands so that they reach their target device.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Resource limits</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/concepts/resource-limits/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/concepts/resource-limits/</guid>
+      <description>Resource limits such as the maximum number of device connections allowed per tenant or the allowed data volume of the messages over a period of time per tenant can be set in Hono.
+Hono specifies an API ResourceLimitChecks that is used by the protocol adapters for the verification of the configured resource limits. A default implementation of this API is shipped with Hono. This default implementation uses the live metrics data retrieved from a Prometheus server to verify the resource-limits, if configured.</description>
+    </item>
+    
+    <item>
+      <title>Connection Events</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/concepts/connection-events/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/concepts/connection-events/</guid>
+      <description>Hono&amp;rsquo;s protocol adapters can use connection events to indicate the connection status of a device. In particular, an adapter can notify downstream components about a newly established connection with a device or about a device having disconnected. The connection status of devices using stateful protocols like MQTT and AMQP can usually be determined quite easily because these protocols often require peers to explicitly open or close a connection and often also support a kind of heart beat which can be used to determine if a connection is still alive.</description>
+    </item>
+    
+  </channel>
+</rss>
\ No newline at end of file
diff --git a/docs/1.2/concepts/protocol_gateway.png b/docs/1.2/concepts/protocol_gateway.png
new file mode 100644
index 0000000..1aaeb53
--- /dev/null
+++ b/docs/1.2/concepts/protocol_gateway.png
Binary files differ
diff --git a/docs/1.2/concepts/resource-limits/index.html b/docs/1.2/concepts/resource-limits/index.html
new file mode 100644
index 0000000..f93bfe1
--- /dev/null
+++ b/docs/1.2/concepts/resource-limits/index.html
@@ -0,0 +1,2556 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Resource limits :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Resource limits :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Resource limits :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/concepts/resource-limits//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/concepts/resource-limits/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item active">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/concepts/resource-limits/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/resource-limits/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/concepts/resource-limits/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/concepts/resource-limits/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/concepts/resource-limits/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/concepts/resource-limits.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/concepts/'>Concepts</a> > Resource limits
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#connections-limit">Connections Limit</a></li>
+<li><a href="#connection-duration-limit">Connection Duration Limit</a></li>
+<li><a href="#messages-limit">Messages Limit</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Resource limits</h1>
+          
+
+        
+
+
+
+
+<p>Resource limits such as the maximum number of device connections allowed per tenant or the allowed data volume of the messages over a period of time per tenant can be set in Hono.</p>
+
+<p>Hono specifies an API <code>ResourceLimitChecks</code> that is used by the protocol adapters for the verification of the configured resource limits. A default implementation of this API is shipped with Hono. This default implementation uses the live metrics data retrieved from a Prometheus server to verify the resource-limits, if configured. To enable and use this default implementation, please refer to the protocol adapter admin guides. Based on the requirements, a custom version of the above API can be implemented and used. The resource-limits for a tenant can be set using the tenant configuration. Please refer to the <a href="/hono/docs/1.2/api/tenant/#tenant-information-format">Tenant API</a> for more details.</p>
+
+<h2 id="connections-limit">Connections Limit</h2>
+
+<p>Before accepting a new connection request from a device, the number of existing connections is checked against the configured limit by the protocol adapters. The connection request is declined if the limit is exceeded.</p>
+
+<p>The MQTT and AMQP protocol adapters keep the connections longer opened than their counterparts such as HTTP. Thereby the MQTT and AMQP adapters are enabled to check the connection limits before accepting any new connection to a device.</p>
+
+<h2 id="connection-duration-limit">Connection Duration Limit</h2>
+
+<p>Before accepting a new connection request from a device, the overall amount of time that the devices have already been connected to protocol adapters for that tenant is checked against the configured limit by the protocol adapters. The connection request is declined if the connection duration limit has been already reached. This limit is only supported by protocol adapters that maintain <em>connection state</em> with authenticated devices. In particular, the HTTP adapter does not support this metric.</p>
+
+<p>The default Prometheus based implementation uses connection duration as the factor to limit the connections. This default implementation supports two modes of connection duration limit calculation namely <code>days</code> and <code>monthly</code>. For more details on how to set the mode refer to the <a href="/hono/docs/1.2/api/tenant/#resource-limits-period-configuration-format">Tenant API</a>. If the period is not set explicitly, then the mode is assumed as <em>monthly</em> in the default implementation.</p>
+
+<p>In the <code>monthly</code> mode, further device connections are only allowed, if the overall amount of time that the devices have already been connected from the beginning till the end of the current (Gregorian) calendar month does not exceed the configured <em>max-minutes</em> value. But for the first month, on which the connection duration limit became effective, the <em>effective connection duration limit</em> is calculated based on the <em>max-minutes</em> with respect to the remaining days in that month from the <em>effective-since</em> date.</p>
+
+<p>Below is a sample resource limit configuration for a tenant, where it has been defined that the connection duration limit became effective on 10.Jul.2019 and the maximum connection duration limit for every month is 50,000 minutes. It means that from August 2019, the connection limit check ensures that no more connections are allowed for that tenant, if that limit of 50,000 minutes is already reached. But in case of July 2019, the month on which the message limit became effective, the <em>effective connection duration limit</em> is calculated by finding the average limit for a day from the configured <em>max-minutes</em> and then multiplying it with the number of days from the <em>effective-since</em> date till the end of that month. In this case it is calculated as <em>(50,000 minutes / 31 days) x  22 days</em>, which is 35,483 minutes. It means that for the month of July 2019, no more new connections are allowed, if the limit of 35,843 minutes is already reached.</p>
+
+<pre><code class="language-json">&quot;resource-limits&quot;: {
+  &quot;connection-duration&quot;: {
+    &quot;effective-since&quot;: &quot;2019-07-10T14:30:00Z&quot;,
+    &quot;max-minutes&quot;: 50000,
+    &quot;period&quot;: {
+      &quot;mode&quot;: &quot;monthly&quot;
+    }
+  }
+}
+
+</code></pre>
+
+<p>In the <code>days</code> mode, further device connections are only allowed, if the overall amount of time that the devices have already been connected for the configured <em>no-of-days</em> does not exceed the <em>max-minutes</em> value. In the below sample configuration, the mode is configured as <code>days</code> and the accounting duration as 30 days. In this case the connection duration limit check ensures that new connections are accepted, only if the connection duration usage for every 30 days from 10.Jul.2019 (<code>effective-since</code>) does not exceed the 50,000 minutes limit.</p>
+
+<pre><code class="language-json">&quot;resource-limits&quot;: {
+  &quot;connection-duration&quot;: {
+    &quot;effective-since&quot;: &quot;2019-07-10T14:30:00Z&quot;,
+    &quot;max-minutes&quot;: 50000,
+    &quot;period&quot;: {
+      &quot;mode&quot;: &quot;days&quot;,
+      &quot;no-of-days&quot;: 30
+    }
+  }
+}
+</code></pre>
+
+<h2 id="messages-limit">Messages Limit</h2>
+
+<p>Hono supports limiting the number of messages that devices and north bound applications of a tenant can publish to Hono during a given time interval. Before accepting any telemetry or event or command messages from devices or north bound applications, it is checked by the protocol adapters that if the message limit is exceeded or not. The incoming message is discarded if the limit is exceeded.</p>
+
+<p>The default Prometheus based implementation uses data volume as the factor to limit the messages. The data volume already consumed by a tenant over the given time interval is compared with the configured message limit before accepting any messages. The default implementation supports two modes of message limits calculation namely <code>days</code> and <code>monthly</code>. For more details on how to set the mode refer to the <a href="/hono/docs/1.2/api/tenant/#resource-limits-period-configuration-format">Tenant API</a>. If the period is not set explicitly, then the mode is assumed as <em>monthly</em> in the default implementation.</p>
+
+<p>In the <code>monthly</code> mode, the message limit check ensures that the data usage from the beginning till the end of a (Gregorian) calendar month does not exceed the <em>max-bytes</em> value. But for the first month on which the message limit became effective, the <em>effective max-bytes</em> are calculated based on the <em>max-bytes</em> with respect to the remaining days in that month from the <em>effective-since</em> date.</p>
+
+<p>Below is a sample resource limit configuration for a tenant and it has been defined that the message limit became effective on 10.Jul.2019 and the maximum bytes allowed for a month is 2 GB. It means that from August 2019, the message limit check ensures that the data usage in a month does not exceed 2 GB. But in case of July 2019, the month on which the message limit became effective, the <em>effective max-bytes</em> is calculated by finding the average limit for a day from the <em>max-bytes</em> and multiplying it with the number of days from the <em>effective-since</em> date till the end of that month. In this case it is calculated as <em>(2 GB / 31 days) x  22 days</em> which is 1.4 GB. It means that for the month of July 2019, the data usage should not exceed 1.4GB.</p>
+
+<pre><code class="language-json">&quot;resource-limits&quot;: {
+  &quot;data-volume&quot;: {
+    &quot;effective-since&quot;: &quot;2019-07-10T14:30:00Z&quot;,
+    &quot;max-bytes&quot;: 2147483648,
+    &quot;period&quot;: {
+      &quot;mode&quot;: &quot;monthly&quot;
+    }
+  }
+}
+</code></pre>
+
+<p>In the <code>days</code> mode, the message limit check ensures that the data usage for the defined <em>no-of-days</em> does not exceed the <em>max-bytes</em> value. In the below sample configuration, the mode is configured as <code>days</code> and the accounting duration as 30 days. In this case the message limit check ensures that the data usage for every 30 days from 10.Jul.2019 (<code>effective-since</code>) does not exceed the 2GB limit.</p>
+
+<pre><code class="language-json">&quot;resource-limits&quot;: {
+  &quot;data-volume&quot;: {
+    &quot;effective-since&quot;: &quot;2019-07-10T14:30:00Z&quot;,
+    &quot;max-bytes&quot;: 2147483648,
+    &quot;period&quot;: {
+      &quot;mode&quot;: &quot;days&quot;,
+      &quot;no-of-days&quot;: 30
+    }
+  }
+}
+</code></pre>
+
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/concepts/tenancy/index.html b/docs/1.2/concepts/tenancy/index.html
new file mode 100644
index 0000000..359934c
--- /dev/null
+++ b/docs/1.2/concepts/tenancy/index.html
@@ -0,0 +1,2585 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Multi-Tenancy :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Multi-Tenancy :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Multi-Tenancy :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/concepts/tenancy//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/concepts/tenancy/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item active">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/tenancy/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/concepts/tenancy/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/concepts/tenancy/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/concepts/tenancy.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/concepts/'>Concepts</a> > Multi-Tenancy
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#the-tenant-api">The Tenant API</a></li>
+<li><a href="#protocol-adapters-respect-the-tenant-api">Protocol Adapters respect the Tenant API</a></li>
+<li><a href="#protocol-adapter-configuration">Protocol Adapter Configuration</a></li>
+<li><a href="#amqp-1-0-endpoints">AMQP 1.0 Endpoints</a></li>
+<li><a href="#devices-and-tenants">Devices and Tenants</a></li>
+<li><a href="#tenant-based-flow-control">Tenant based Flow Control</a></li>
+<li><a href="#authorization-at-tenant-level">Authorization at Tenant Level</a></li>
+<li><a href="#business-applications-and-tenants">Business Applications and Tenants</a></li>
+<li><a href="#separation-of-tenants">Separation of Tenants</a></li>
+<li><a href="#hints-for-production">Hints for Production</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Multi-Tenancy</h1>
+          
+
+        
+
+
+
+
+<p>Hono is designed to structure the set of all internally managed data and data streams into strictly isolated subsets.
+This includes the registration data and credentials of devices, internal users that are used for authentication,
+and the <em>Business Applications</em> that are part of such subsets as well.</p>
+
+<p>This way of <em>strict</em> isolation is generally known as multi-tenancy, where a <strong>tenant</strong> is the term for such a subset.
+Such an isolation is essential for enabling a scalable distributed architecture to handle independent subsets as if each subset had its
+own installation (which would be much harder to maintain and would not benefit from runtime cost sharing).</p>
+
+<p>Hono&rsquo;s multi-tenancy concept is based on handling tenants as own <em>entities</em>. All functionality of Hono is
+provided in the context of a previously created tenant - except the creation of a tenant itself.</p>
+
+<p>In the following the different aspects of multi-tenancy in Hono are addressed and a full overview of the concept is given.</p>
+
+<h2 id="the-tenant-api">The Tenant API</h2>
+
+<p>By means of the <a href="/hono/docs/1.2/api/tenant/">Tenant API</a> Hono handles tenants as own <em>entities</em>.
+The API defines how to <em>retrieve</em> the details of a specific tenant. This offers the possibility to handle arbitrary
+properties on the level of a tenant (see e.g. <a href="#protocol-adapter-configuration">Protocol adapter configuration</a>).
+For convenience, there are CRUD operations for the handling of tenants, which can be found in the
+<a href="/hono/docs/1.2/user-guide/device-registry/#managing-tenants">Device Registry</a>.</p>
+
+<h2 id="protocol-adapters-respect-the-tenant-api">Protocol Adapters respect the Tenant API</h2>
+
+<p>When a device connects to one of Hono&rsquo;s protocol adapters, the adapter determines the tenant this device belongs to.
+How this is done is described in the User Guide.
+After the tenant is determined, the adapter retrieves the details of the determined tenant by means of the Tenant API.
+Only if the tenant exists and is enabled the adapter further processes the data of the device that is connecting. Otherwise
+the connection will be closed.</p>
+
+<h2 id="protocol-adapter-configuration">Protocol Adapter Configuration</h2>
+
+<p>Protocol adapters retrieve parts of their configuration on a tenant level by using the details of the determined tenant.
+This includes e.g. if a specific protocol adapter is enabled at all for this tenant, allowing to define tenants with
+only a subset of Hono&rsquo;s functionality. This feature is foreseen to be especially important for production setups.</p>
+
+<p><em>Example</em>: a tenant that</p>
+
+<ul>
+<li>can use the MQTT protocol adapter</li>
+<li>but is not allowed to use the HTTP protocol adapter</li>
+</ul>
+
+<p>Please refer to the <a href="/hono/docs/1.2/api/tenant/">Tenant API</a> to find out which protocol adapter properties
+can be configured at the tenant level.</p>
+
+<h2 id="amqp-1-0-endpoints">AMQP 1.0 Endpoints</h2>
+
+<p>The AMQP 1.0 endpoints for all APIs of Hono are scoped to a tenant, by using the scheme <code>&lt;api-name&gt;/TENANT/...</code>.</p>
+
+<p><em>Examples</em>:</p>
+
+<ul>
+<li><code>telemetry/TENANT</code></li>
+<li><code>registration/TENANT</code></li>
+</ul>
+
+<p>etc.</p>
+
+<p>This separates the AMQP endpoints from each other on a tenant level.</p>
+
+<p>The only exception to this is the <a href="/hono/docs/1.2/api/tenant/">Tenant API</a>, which does not follow this scheme since it
+is addressing the tenants themselves.</p>
+
+<h2 id="devices-and-tenants">Devices and Tenants</h2>
+
+<p>A physical device will usually be represented in Hono as an entity in the device registry, having a unique identity
+and belonging to exactly one tenant. All data sent from a device, as well as from the application to the device,
+is therefore treated as belonging to the corresponding tenant.</p>
+
+<p>The following diagram shows the relation between tenants, devices and their credentials:</p>
+
+<figure>
+    <img src="../Tenants_Devices_Credentials.png"/> <figcaption>
+            <h4>Tenants, Devices and Credentials</h4>
+        </figcaption>
+</figure>
+
+
+<h2 id="tenant-based-flow-control">Tenant based Flow Control</h2>
+
+<p>An important detail in Hono&rsquo;s architecture is that data sent downstream is transported via the tenant
+scoped AMQP 1.0 links from the protocol adapters to the AMQP 1.0 network.
+Each tenant has its own pair of AMQP 1.0 links and is treated
+independently from other tenants regarding the back pressure mechanism that AMQP 1.0 offers.
+This enables a <em>Business application</em> to limit the rate at which it consumes AMQP 1.0 messages per tenant.</p>
+
+<p>For the other direction, when commands are sent from the application to the device, the rate is also limited per tenant.</p>
+
+<h2 id="authorization-at-tenant-level">Authorization at Tenant Level</h2>
+
+<p>Hono&rsquo;s components authenticate each other by means of the <a href="/hono/docs/1.2/api/authentication/">Authentication API</a>.
+The returned token for a successful authentication contains authorization information that is addressing the AMQP 1.0
+endpoints. Since the endpoints (as outlined above) are scoped to a tenant, this enables to configure tenants that are
+authorized to only a subset of Hono&rsquo;s full functionality.</p>
+
+<p><em>Example</em>: a tenant (defined by means of authorization configuration) that</p>
+
+<ul>
+<li>is allowed to send telemetry data downstream</li>
+<li>but is not allowed to send event data</li>
+</ul>
+
+<p>This is done by not including the event endpoint in the authorization token for these tenants.</p>
+
+<h2 id="business-applications-and-tenants">Business Applications and Tenants</h2>
+
+<p>The northbound <em>Business applications</em> are always connecting to the AMQP 1.0 endpoints of Hono.
+By means of the authentication and authorization setup and the fact that the endpoints are scoped to a tenant, the
+<em>Business application</em> is only acting in the context of one tenant.</p>
+
+<h2 id="separation-of-tenants">Separation of Tenants</h2>
+
+<p>Tenants are separated from each other in all of Hono&rsquo;s components.
+Here is a summary of how this is implemented:</p>
+
+<ul>
+<li>the registration of devices are strictly scoped to a tenant</li>
+<li>the credentials of devices are strictly scoped to a tenant</li>
+<li>protocol adapters can be enabled/disabled for a tenant</li>
+<li>the downstream data flow is isolated for every tenant</li>
+<li>the upstream data flow (<a href="/hono/docs/1.2/concepts/command-and-control/">Command &amp; Control</a>) is isolated for every tenant</li>
+<li><em>Business applications</em> need to authenticate to the AMQP 1.0 network and are by that mechanism scoped to their tenant</li>
+</ul>
+
+<h2 id="hints-for-production">Hints for Production</h2>
+
+<p>To be flexible for the different needs of production setups, Hono tries to make as few assumptions about the combination
+of the different APIs as possible.
+This means e.g. that the Device Registry does not enforce referential integrity of the APIs:</p>
+
+<ul>
+<li>devices can be created for a tenant that is not existing (yet)</li>
+<li>credentials can be created for a tenant and/or a device that is not existing (yet)</li>
+<li>tenants can be deleted and leave their scoped devices and credentials still in the configuration (which may not be usable
+anymore, since the tenant is missing)</li>
+</ul>
+
+<p>These are points that production setups may want to implement differently.</p>
+
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/deployment/create-kubernetes-cluster/index.html b/docs/1.2/deployment/create-kubernetes-cluster/index.html
new file mode 100644
index 0000000..ea1579f
--- /dev/null
+++ b/docs/1.2/deployment/create-kubernetes-cluster/index.html
@@ -0,0 +1,2632 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Setting up a Kubernetes Cluster :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Setting up a Kubernetes Cluster :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Setting up a Kubernetes Cluster :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/deployment/create-kubernetes-cluster//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item active">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/deployment/create-kubernetes-cluster/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/create-kubernetes-cluster/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/deployment/create-kubernetes-cluster/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/deployment/create-kubernetes-cluster/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/deployment/create-kubernetes-cluster/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/deployment/create-kubernetes-cluster.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/deployment/'>Deployment</a> > Setting up a Kubernetes Cluster
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#setting-up-a-local-development-environment">Setting up a local Development Environment</a></li>
+<li><a href="#setting-up-a-production-environment">Setting up a Production Environment</a></li>
+<li><a href="#setting-up-an-environment-on-microsoft-azure">Setting up an Environment on Microsoft Azure</a>
+<ul>
+<li><a href="#prerequisites">Prerequisites</a></li>
+<li><a href="#setup">Setup</a></li>
+<li><a href="#monitoring">Monitoring</a></li>
+<li><a href="#cleaning-up">Cleaning up</a></li>
+</ul></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Setting up a Kubernetes Cluster</h1>
+          
+
+        
+
+
+<p>This guide describes how to set up a Kubernetes cluster which can be used to run Eclipse Hono&trade;.</p>
+
+<p>Hono can be deployed to any Kubernetes cluster running version 1.11 or newer. This includes <a href="https://www.okd.io/">OpenShift (Origin)</a> which is built on top of Kubernetes.</p>
+
+<p>The <a href="https://kubernetes.io/docs/setup/">Kubernetes web site</a> provides instructions for setting up a (local) cluster on bare metal and/or virtual infrastructure from scratch or for provisioning a managed Kubernetes cluster from one of the popular cloud providers.</p>
+
+<p><a name="Local Development"></a></p>
+
+<h2 id="setting-up-a-local-development-environment">Setting up a local Development Environment</h2>
+
+<p>The easiest option is to set up a single-node cluster running on a local VM using the <a href="https://minikube.sigs.k8s.io/">Minikube</a> project.
+This kind of setup is sufficient for evaluation and development purposes.
+Please refer to Minikube&rsquo;s <a href="https://minikube.sigs.k8s.io/docs/start/">getting started guide</a> for instructions on how to set up a cluster locally.</p>
+
+<p>The recommended settings for a Minikube VM used for running Hono&rsquo;s example setup are as follows:</p>
+
+<ul>
+<li><strong>cpus</strong>: 2</li>
+<li><strong>memory</strong>: 8192 (MB)</li>
+</ul>
+
+<p>The command to start the VM will look something like this:</p>
+
+<pre><code class="language-sh">minikube start --cpus 2 --memory 8192
+</code></pre>
+
+<p>After the Minikube VM has started successfully, the <code>minikube tunnel</code> command should be run in order to support Hono&rsquo;s services being deployed using the <em>LoadBalancer</em> type. Please refer to the <a href="https://minikube.sigs.k8s.io/docs/tasks/loadbalancer/">Minikube Loadbalancer docs</a> for details.</p>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Setting Kubernetes Version</h4>
+    <div>Minikube will use the most recent Kubernetes version that was available when it has been compiled by default.
+Hono <em>should</em> run on any version of Kubernetes starting with 1.13.6. However, it has been tested with several
+specific versions only. The most recent version known to work is 1.15.4 so if you experience any issues with
+running Hono on another version, please try to deploy to 1.15.4 before raising an issue.
+You can use Minikube&rsquo;s <code>--kubernetes-version</code> command line switch to set a particular version.</div>
+</div>
+
+
+<h2 id="setting-up-a-production-environment">Setting up a Production Environment</h2>
+
+<p>Setting up a multi-node Kubernetes cluster is a more advanced topic. Please follow the corresponding links provided in the <a href="https://kubernetes.io/docs/setup/#production-environment">Kubernetes documentation</a>.</p>
+
+<h2 id="setting-up-an-environment-on-microsoft-azure">Setting up an Environment on Microsoft Azure</h2>
+
+<p>This chapter describes how Hono can be deployed on Microsoft Azure. It includes:</p>
+
+<ul>
+<li><a href="https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-overview">Azure Resource Manager (ARM)</a>
+templates for an automated infrastructure deployment.</li>
+<li>Helm based deployment of Hono to <a href="https://docs.microsoft.com/en-us/azure/aks/intro-kubernetes">Azure Kubernetes Service (AKS)</a>.</li>
+<li>Push Hono docker images to an <a href="https://azure.microsoft.com/en-us/services/container-registry/">Azure Container Registry (ACR)</a>.</li>
+<li>Optional <a href="https://docs.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-overview">Azure Service Bus</a> as
+broker for the <a href="/hono/docs/1.2/architecture/component-view/#amqp-1-0-messaging-network">Hono AMQP 1.0 Messaging Network</a>
+instead of a self hosted ActiveMQ Artemis.</li>
+<li><a href="https://docs.microsoft.com/en-us/azure/virtual-network/virtual-network-service-endpoints-overview">Virtual Network (VNet) service endpoints</a>
+ensure protected communication between AKS and Azure Service Bus.</li>
+</ul>
+
+<div class="alert alert-warning">
+    <h4 class="alert-heading"><i class="fas fa-exclamation-triangle"></i> Use for demos only</h4>
+    <div>This deployment model is not meant for productive use but rather for evaluation as well as demonstration purposes or as a baseline to evolve a production grade <a href="https://docs.microsoft.com/en-us/azure/architecture/guide/">Application architecture</a> out of it which includes Hono.</div>
+</div>
+
+
+<h3 id="prerequisites">Prerequisites</h3>
+
+<ul>
+<li>An <a href="https://azure.microsoft.com/en-us/get-started/">Azure subscription</a>.</li>
+<li><a href="https://docs.microsoft.com/en-us/cli/azure/install-azure-cli">Azure CLI</a> installed to setup the infrastructure.</li>
+<li><a href="https://kubernetes.io/docs/tasks/tools/install-kubectl/">kubectl</a> and <a href="https://helm.sh/docs/using_helm/#installing-helm">helm</a>
+installed to deploy Hono into <a href="https://docs.microsoft.com/en-us/azure/aks/intro-kubernetes">Azure Kubernetes Service (AKS)</a></li>
+</ul>
+
+<h3 id="setup">Setup</h3>
+
+<p>As described <a href="https://docs.microsoft.com/en-gb/azure/aks/kubernetes-service-principal">here</a> we will create an explicit service principal. Later we add roles to this principal to access the <a href="https://docs.microsoft.com/en-us/azure/container-registry/container-registry-intro">Azure Container Registry (ACR)</a>.</p>
+
+<pre><code class="language-bash"># Create service principal
+service_principal=`az ad sp create-for-rbac --name http://honoServicePrincipal --skip-assignment --output tsv`
+app_id_principal=`echo $service_principal | cut -f1 -d ' '`
+password_principal=`echo $service_principal | cut -f4 -d ' '`
+object_id_principal=`az ad sp show --id $app_id_principal --query objectId --output tsv`
+</code></pre>
+
+<p>Note: it might take a few seconds until the principal is available for the next steps.</p>
+
+<p>Now we create the Azure Container Registry instance and provide read access to the service principal.</p>
+
+<pre><code class="language-bash"># Resource group where the ACR is deployed.
+acr_resourcegroupname={YOUR_ACR_RG}
+# Name of your ACR.
+acr_registry_name={YOUR_ACR_NAME}
+# Full name of the ACR.
+acr_login_server=$acr_registry_name.azurecr.io
+
+az acr create --resource-group $acr_resourcegroupname --name $acr_registry-name  --sku Basic
+acr_id_access_registry=`az acr show --resource-group $acr_resourcegroupname --name $acr_registry_name --query &quot;id&quot; --output tsv`
+az role assignment create --assignee $app_id_principal --scope $acr_id_access_registry --role Reader
+</code></pre>
+
+<p>With the next command we will use the provided <a href="https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-overview">Azure Resource Manager (ARM)</a> templates to setup the AKS cluster. This might take a while.</p>
+
+<pre><code class="language-bash">resourcegroup_name=hono
+az group create --name $resourcegroup_name --location &quot;westeurope&quot;
+unique_solution_prefix=myprefix
+cd deploy/src/main/deploy/azure/
+az group deployment create --name HonoBasicInfrastructure --resource-group $resourcegroup_name --template-file arm/honoInfrastructureDeployment.json --parameters uniqueSolutionPrefix=$unique_solution_prefix servicePrincipalObjectId=$object_id_principal servicePrincipalClientId=$app_id_principal servicePrincipalClientSecret=$password_principal
+</code></pre>
+
+<p>Notes:</p>
+
+<ul>
+<li>add the following parameter in case you want to opt for the Azure Service Bus as broker in the
+<a href="/hono/docs/1.2/architecture/component-view/#amqp-1-0-messaging-network">Hono AMQP 1.0 Messaging Network</a> instead of
+deploying a (self-hosted) ActiveMQ Artemis into AKS: <em>serviceBus=true</em></li>
+<li>add the following parameter to define the k8s version of the AKS cluster. The default as defined in the
+template <a href="https://docs.microsoft.com/en-us/azure/aks/supported-kubernetes-versions">might not be supported</a> in your
+target Azure region, e.g. <em>kubernetesVersion=1.14.6</em></li>
+</ul>
+
+<p>After the deployment is complete you can set your cluster in <em>kubectl</em>.</p>
+
+<pre><code class="language-bash">az aks get-credentials --resource-group $resourcegroup_name --name $aks_cluster_name
+</code></pre>
+
+<p>Next create retain storage for the device registry.</p>
+
+<pre><code class="language-bash">kubectl apply -f managed-premium-retain.yaml
+</code></pre>
+
+<p>Now Hono can be installed to the AKS cluster as describe in the <a href="/hono/docs/1.2/deployment/helm-based-deployment/">Helm based installation</a>
+guide.</p>
+
+<h3 id="monitoring">Monitoring</h3>
+
+<p>You can monitor your cluster using
+<a href="https://docs.microsoft.com/en-us/azure/azure-monitor/insights/container-insights-overview">Azure Monitor for containers</a>.</p>
+
+<p>Navigate to <a href="https://portal.azure.com">https://portal.azure.com</a> -&gt; your resource group -&gt; your kubernetes cluster</p>
+
+<p>On an overview tab you fill find an information about your cluster (status, location, version, etc.). Also, here
+you will find a <em>Monitor Containers</em> link. Navigate to <em>Monitor Containers</em> and explore metrics and statuses of
+your Cluster, Nodes, Controllers and Containers.</p>
+
+<h3 id="cleaning-up">Cleaning up</h3>
+
+<p>Use the following command to delete all created resources once they are no longer needed:</p>
+
+<pre><code class="language-sh">az group delete --name $resourcegroup_name --yes --no-wait
+</code></pre>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/deployment/helm-based-deployment/index.html b/docs/1.2/deployment/helm-based-deployment/index.html
new file mode 100644
index 0000000..97859fe
--- /dev/null
+++ b/docs/1.2/deployment/helm-based-deployment/index.html
@@ -0,0 +1,2702 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Helm based Deployment :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Helm based Deployment :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Helm based Deployment :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/deployment/helm-based-deployment//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/deployment/helm-based-deployment/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item active">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/deployment/helm-based-deployment/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/helm-based-deployment/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/deployment/helm-based-deployment/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/deployment/helm-based-deployment/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/deployment/helm-based-deployment/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/deployment/helm-based-deployment.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/deployment/'>Deployment</a> > Helm based Deployment
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#installing-hono">Installing Hono</a></li>
+<li><a href="#deploying-custom-container-images">Deploying custom Container Images</a>
+<ul>
+<li><a href="#deploying-via-a-private-registry">Deploying via a private Registry</a></li>
+<li><a href="#deploying-to-minikube">Deploying to Minikube</a></li>
+<li><a href="#using-jaeger-tracing">Using Jaeger Tracing</a></li>
+<li><a href="#deploying-to-azure-kubernetes-service-aks">Deploying to Azure Kubernetes Service (AKS)</a></li>
+</ul></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Helm based Deployment</h1>
+          
+
+        
+
+
+<p>Eclipse Hono&trade;&rsquo;s components are provided as container images which can be run on arbitrary container orchestration platforms.
+This page describes the steps necessary to deploy Hono to a <a href="https://kubernetes.io">Kubernetes</a> cluster using the
+<a href="https://helm.sh">Helm package manager</a>.</p>
+
+<h2 id="installing-hono">Installing Hono</h2>
+
+<p>Hono&rsquo;s Helm chart is available from the <a href="https://www.eclipse.org/packages/repository/">Eclipse IoT Packages chart repository</a>.
+Please refer to the <a href="https://github.com/eclipse/packages/blob/master/charts/hono/README.md">chart&rsquo;s README</a> for
+instructions regarding installation and configuration.</p>
+
+<h2 id="deploying-custom-container-images">Deploying custom Container Images</h2>
+
+<p>The chart by default installs Hono&rsquo;s pre-built container images. In some cases it might be desirable to build Hono
+from source, e.g. in order to use a different metrics back end or to <a href="#using-jaeger-tracing">use Jaeger tracing</a>.</p>
+
+<p>The container images created as part of the build process need to be made available to the Kubernetes cluster that
+Hono should be installed to. This usually requires the images to be pushed to a (private) container registry that
+the cluster can pull them from. Please refer to the documentation of the employed Kubernetes service provider for
+details regarding the setup and configuration of a private container registry.</p>
+
+<h3 id="deploying-via-a-private-registry">Deploying via a private Registry</h3>
+
+<p>The first step is getting the source code of Hono. Please refer to <a href="/hono/docs/1.2/dev-guide/building_hono/">Building from Source</a> for details.
+Once the source code has been retrieved, the build process can be started using the following command:</p>
+
+<pre><code class="language-sh"># in base directory of Hono working tree:
+mvn clean install -Pbuild-docker-image,metrics-prometheus
+</code></pre>
+
+<p>After the build process has finished, the custom container images need to be pushed to the registry so that the
+Kubernetes cluster can pull them from there during deployment.
+Assuming that the images should be tagged with <code>1.0.3-CUSTOM</code> and the container registry name is <code>my.registry.io</code>,
+the following command can be used to tag the locally built images and push them to the registry:</p>
+
+<pre><code class="language-sh"># in base directory of Hono working tree:
+./push_hono_images.sh 1.0.3-CUSTOM my.registry.io
+</code></pre>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Note</h4>
+    <div>You may need to log in to the (private) container registry before pushing the images.</div>
+</div>
+
+
+<p>The image names that Hono should use for starting up containers can be configured in a YAML file:</p>
+
+<pre><code class="language-yaml">deviceRegistryExample:
+  imageName: &quot;my.registry.io/eclipse/hono-service-device-registry-file:1.0.3-CUSTOM&quot;
+authServer:
+  imageName: &quot;my.registry.io/eclipse/hono-service-auth:1.0.3-CUSTOM&quot;
+deviceConnectionService:
+  imageName: &quot;my.registry.io/eclipse/hono-service-device-connection:1.0.3-CUSTOM&quot;
+adapters:
+  amqp:
+    imageName: &quot;my.registry.io/eclipse/hono-adapter-amqp-vertx:1.0.3-CUSTOM&quot;
+  mqtt:
+    imageName: &quot;my.registry.io/eclipse/hono-adapter-mqtt-vertx:1.0.3-CUSTOM&quot;
+  http:
+    imageName: &quot;my.registry.io/eclipse/hono-adapter-http-vertx:1.0.3-CUSTOM&quot;
+</code></pre>
+
+<p>Assuming that the YAML file is called <code>imageNames.yaml</code>, installation can then be done using:</p>
+
+<pre><code class="language-sh">helm install --dependency-update -n hono -f imageNames.yaml eclipse-hono eclipse-iot/hono
+</code></pre>
+
+<h3 id="deploying-to-minikube">Deploying to Minikube</h3>
+
+<p>When using Minikube as the deployment target, things are a little easier. Minikube comes with an
+embedded Docker daemon which can be used to build the container images instead of using a local
+Docker daemon, thus eliminating the need to push the images to a registry altogether.
+In order to use Minikube&rsquo;s Docker daemon, the following command needs to be run:</p>
+
+<pre><code class="language-sh">eval $(minikube docker-env)
+</code></pre>
+
+<p>This will set the Docker environment variables to point to Minikube&rsquo;s Docker daemon which can then be
+used for building the container images and storing them locally in the Minikube VM.</p>
+
+<p>In any case the build process can be started using the following command:</p>
+
+<pre><code class="language-sh"># in base directory of Hono working tree:
+mvn clean install -Pbuild-docker-image,metrics-prometheus
+</code></pre>
+
+<p>The newly built images can then be deployed using Helm:</p>
+
+<pre><code class="language-sh">helm install --dependency-update -n hono eclipse-hono eclipse-iot/hono
+</code></pre>
+
+<h3 id="using-jaeger-tracing">Using Jaeger Tracing</h3>
+
+<p>Hono&rsquo;s components are instrumented using OpenTracing to allow tracking of the distributed processing of messages flowing through the system.
+The Hono chart can be configured to report tracing information to the <a href="https://www.jaegertracing.io/">Jaeger tracing system</a>. The <em>Spans</em> reported
+by the components can then be viewed in a web browser.</p>
+
+<p>In order for Hono&rsquo;s components to use the Jaeger client for reporting tracing information, the container images need to be built
+with the <code>jaeger</code> Maven profile. Please refer to <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/#configuring-usage-of-jaeger-tracing-included-in-docker-images">Monitoring &amp; Tracing</a> for details.
+The newly built images also need to be made available to the target Kubernetes cluster as described in the two previous sections.</p>
+
+<p>The chart can be configured to deploy and use an example Jaeger back end by means of setting the <em>jaegerBackendExample.enabled</em> property
+to <code>true</code> when running Helm:</p>
+
+<pre><code class="language-sh">helm install --dependency-update -n hono --set jaegerBackendExample.enabled=true eclipse-hono eclipse-iot/hono
+</code></pre>
+
+<p>This will create a Jaeger back end instance suitable for testing purposes and will configure all deployed Hono components to use the
+Jaeger back end.</p>
+
+<p>The following command can then be used to return the IP address with which the Jaeger UI can be accessed in a
+browser (ensure <code>minikube tunnel</code> is running when using minikube):</p>
+
+<pre><code class="language-sh">kubectl get service hono-jaeger-query --output='jsonpath={.status.loadBalancer.ingress[0].ip}' -n hono
+</code></pre>
+
+<p>If no example Jaeger back end should be deployed but instead an existing Jaeger installation should be used,
+the chart&rsquo;s <em>jaegerAgentConf</em> property can be set to environment variables which are passed in to
+the Jaeger Agent that is deployed with each of Hono&rsquo;s components.</p>
+
+<pre><code class="language-sh">helm install --dependency-update -n hono --set jaegerAgentConf.REPORTER_TYPE=tchannel --set jaegerAgentConf.REPORTER_TCHANNEL_HOST_PORT=my-jaeger-collector:14267 eclipse-hono eclipse-iot/hono
+</code></pre>
+
+<h3 id="deploying-to-azure-kubernetes-service-aks">Deploying to Azure Kubernetes Service (AKS)</h3>
+
+<p>The following chapter describes how to use Azure Kubernetes Service (AKS) as a deployment target that has
+been set up as described in the <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">Setting up a Kubernetes Cluster guide</a>.</p>
+
+<p>First we build the docker images and push them into the ACR. Note that if you define a custom image tag
+you have to provide the helm with the image tags as described in the chapters above.</p>
+
+<pre><code class="language-bash"># Resource group where the ACR is deployed.
+acr_resourcegroupname={YOUR_ACR_RG}
+# Name of your ACR.
+acr_registry_name={YOUR_ACR_NAME}
+# Full name of the ACR.
+acr_login_server=$acr_registry_name.azurecr.io
+# Authenticate your docker daemon with the ACR.
+az acr login --name $ACR_NAME
+# Build images.
+cd hono
+mvn install -Pbuild-docker-image -Ddocker.registry=$acr_login_server
+# Push images to ACR.
+./push_hono_images.sh 1.0.0-SNAPSHOT $acr_login_server
+</code></pre>
+
+<p>Now we can retrieve settings from the deployment for the following steps:</p>
+
+<pre><code class="language-bash"># Resource group of the AKS deployment
+resourcegroup_name=hono
+
+aks_cluster_name=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.aksClusterName.value -o tsv`
+http_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.httpPublicIPAddress.value -o tsv`
+amqp_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.amqpPublicIPAddress.value -o tsv`
+mqtt_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.mqttPublicIPAddress.value -o tsv`
+registry_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.registryPublicIPAddress.value -o tsv`
+network_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.networkPublicIPAddress.value -o tsv`
+</code></pre>
+
+<p>Note: add the following lines in case you opted for the Azure Service Bus variant:</p>
+
+<pre><code class="language-bash">service_bus_namespace=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.serviceBusNamespaceName.value -o tsv`
+service_bus_key_name=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.serviceBusKeyName.value -o tsv`
+service_bus_key=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.serviceBusKey.value -o tsv`
+</code></pre>
+
+<p>Next we prepare the k8s environment:</p>
+
+<pre><code class="language-bash">k8s_namespace=honons
+kubectl create namespace $k8s_namespace
+</code></pre>
+
+<p>Finally install Hono. Leveraging the <em>managed-premium-retain</em> storage in combination with <em>deviceRegistry.resetFiles=false</em> parameter is optional but ensures that Device registry storage will retain future update deployments.</p>
+
+<pre><code class="language-bash"># in Hono working tree directory: hono/deploy
+helm install target/deploy/helm/eclipse-hono/ \
+    --dep-up \
+    --name hono \
+    --namespace $k8s_namespace \
+    --set adapters.mqtt.svc.annotations.&quot;service\.beta\.kubernetes\.io/azure-load-balancer-resource-group&quot;=$resourcegroup_name \
+    --set adapters.http.svc.annotations.&quot;service\.beta\.kubernetes\.io/azure-load-balancer-resource-group&quot;=$resourcegroup_name \
+    --set adapters.amqp.svc.annotations.&quot;service\.beta\.kubernetes\.io/azure-load-balancer-resource-group&quot;=$resourcegroup_name \
+    --set deviceRegistryExample.svc.annotations.&quot;service\.beta\.kubernetes\.io/azure-load-balancer-resource-group&quot;=$resourcegroup_name \
+    --set amqpMessagingNetworkExample.dispatchRouter.svc.annotations.&quot;service\.beta\.kubernetes\.io/azure-load-balancer-resource-group&quot;=$resourcegroup_name \
+    --set deviceRegistryExample.storageClass=managed-premium-retain \
+    --set deviceRegistryExample.resetFiles=false \
+    --set adapters.mqtt.svc.loadBalancerIP=$mqtt_ip_address \
+    --set adapters.http.svc.loadBalancerIP=$http_ip_address \
+    --set adapters.amqp.svc.loadBalancerIP=$amqp_ip_address \
+    --set deviceRegistryExample.svc.loadBalancerIP=$registry_ip_address \
+    --set amqpMessagingNetworkExample.dispatchRouter.svc.loadBalancerIP=$network_ip_address
+</code></pre>
+
+<p>Note: add the following lines in case you opted for the Azure Service Bus variant:</p>
+
+<pre><code class="language-bash">    # Router update required to work together with Azure Service Bus
+    --set amqpMessagingNetworkExample.dispatchRouter.imageName=quay.io/enmasse/qdrouterd-base:1.8.0 \
+    --set amqpMessagingNetworkExample.broker.type=servicebus \
+    --set amqpMessagingNetworkExample.broker.servicebus.saslUsername=$service_bus_key_name \
+    --set amqpMessagingNetworkExample.broker.servicebus.saslPassword=$service_bus_key \
+    --set amqpMessagingNetworkExample.broker.servicebus.host=$service_bus_namespace.servicebus.windows.net \
+</code></pre>
+
+<p>Have fun with Hono on Microsoft Azure!</p>
+
+<p>Next steps:</p>
+
+<p>You can follow the steps as described in the <a href="https://www.eclipse.org/hono/getting-started/
+">Getting Started</a> guide with the following differences:</p>
+
+<p>Compared to a plain k8s deployment Azure provides us DNS names with static IPs for the Hono endpoints. To retrieve them:</p>
+
+<pre><code class="language-bash">HTTP_ADAPTER_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.httpPublicIPFQDN.value -o tsv`
+AMQP_ADAPTER_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.amqpPublicIPFQDN.value -o tsv`
+MQTT_ADAPTER_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.mqttPublicIPFQDN.value -o tsv`
+REGISTRY_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.registryPublicIPFQDN.value -o tsv`
+AMQP_NETWORK_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.networkPublicIPFQDN.value -o tsv`
+</code></pre>
+
+<p>As Azure Service Bus does not support auto creation of queues you have to create a queue per tenant (ID), e.g. after you have created your tenant run:</p>
+
+<pre><code class="language-bash">az servicebus queue create --resource-group $resourcegroup_name \
+    --namespace-name $service_bus_namespace \
+    --name $MY_TENANT
+</code></pre>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/deployment/index.html b/docs/1.2/deployment/index.html
new file mode 100644
index 0000000..e4fdaa8
--- /dev/null
+++ b/docs/1.2/deployment/index.html
@@ -0,0 +1,2454 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Deployment :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Deployment :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Deployment :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/deployment//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/deployment/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        parent
+        active
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/deployment/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/deployment/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/deployment/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/deployment/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/deployment/_index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > Deployment
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+              </div>
+            </div>
+            
+
+        
+          <div id="chapter">
+        
+        <div id="body-inner">
+          
+
+        
+
+
+
+
+<h1 id="deployment">Deployment</h1>
+
+<p>Learn how to deploy Eclipse Hono&trade; to various container orchestration platforms.</p>
+
+
+<footer class=" footline" >
+	
+</footer>
+
+        
+            </div> 
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
diff --git a/docs/1.2/deployment/index.xml b/docs/1.2/deployment/index.xml
new file mode 100644
index 0000000..c1ed22e
--- /dev/null
+++ b/docs/1.2/deployment/index.xml
@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>Deployment on Eclipse Hono&amp;trade; Vers.: 1.2</title>
+    <link>https://www.eclipse.org/hono/docs/1.2/deployment/</link>
+    <description>Recent content in Deployment on Eclipse Hono&amp;trade; Vers.: 1.2</description>
+    <generator>Hugo -- gohugo.io</generator>
+    <language>en-us</language>
+    
+	<atom:link href="https://www.eclipse.org/hono/docs/1.2/deployment/index.xml" rel="self" type="application/rss+xml" />
+    
+    
+    <item>
+      <title>Helm based Deployment</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/deployment/helm-based-deployment/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/deployment/helm-based-deployment/</guid>
+      <description>&lt;p&gt;Eclipse Hono&amp;trade;&amp;rsquo;s components are provided as container images which can be run on arbitrary container orchestration platforms.
+This page describes the steps necessary to deploy Hono to a &lt;a href=&#34;https://kubernetes.io&#34;&gt;Kubernetes&lt;/a&gt; cluster using the
+&lt;a href=&#34;https://helm.sh&#34;&gt;Helm package manager&lt;/a&gt;.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>OpenShift / OKD</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/deployment/openshift/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/deployment/openshift/</guid>
+      <description>In Hono version 1.0 we dropped the OpenShift specific deployment using the source-to-image (S2I) model, in favor of the Helm charts and the Eclipse IoT Packages project.
+You can still deploy to OpenShift and OKD, using the Helm charts. And you can also use routes to expose services. Deploying using S2I is also still possible, however the Hono project simply no longer provides out-of-the box scripts for doing so.</description>
+    </item>
+    
+    <item>
+      <title>Setting up a Kubernetes Cluster</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/deployment/create-kubernetes-cluster/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/deployment/create-kubernetes-cluster/</guid>
+      <description>&lt;p&gt;This guide describes how to set up a Kubernetes cluster which can be used to run Eclipse Hono&amp;trade;.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Limiting Resource Usage</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/deployment/resource-limitation/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/deployment/resource-limitation/</guid>
+      <description>&lt;p&gt;Deploying Eclipse Hono&amp;trade; to a container orchestration platform is easy thanks to the provided Docker images. This page provides some guidance for configuring the resource consumption of these containers in order to make sure that they get enough memory and CPU to run properly, but to also make sure that individual containers do not use up all the resources causing other containers to starve.&lt;/p&gt;</description>
+    </item>
+    
+  </channel>
+</rss>
\ No newline at end of file
diff --git a/docs/1.2/deployment/openshift/index.html b/docs/1.2/deployment/openshift/index.html
new file mode 100644
index 0000000..108cd32
--- /dev/null
+++ b/docs/1.2/deployment/openshift/index.html
@@ -0,0 +1,2476 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>OpenShift / OKD :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="OpenShift / OKD :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="OpenShift / OKD :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/deployment/openshift//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/deployment/openshift/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item active">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/deployment/openshift/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/openshift/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/deployment/openshift/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/deployment/openshift/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/deployment/openshift/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/deployment/openshift.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/deployment/'>Deployment</a> > OpenShift / OKD
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>OpenShift / OKD</h1>
+          
+
+        
+
+
+<p>In Hono version 1.0 we dropped the OpenShift specific deployment using the
+source-to-image (S2I) model, in favor of the Helm charts and the
+Eclipse IoT Packages project.</p>
+
+<p>You can still deploy to OpenShift and OKD, using the Helm charts. And you can
+also use <em>routes</em> to expose services.
+Deploying using S2I is also still possible, however the Hono project simply no
+longer provides out-of-the box scripts for doing so.</p>
+
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/deployment/resource-limitation/index.html b/docs/1.2/deployment/resource-limitation/index.html
new file mode 100644
index 0000000..8c6f7ad
--- /dev/null
+++ b/docs/1.2/deployment/resource-limitation/index.html
@@ -0,0 +1,2560 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Limiting Resource Usage :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Limiting Resource Usage :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Limiting Resource Usage :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/deployment/resource-limitation//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/deployment/resource-limitation/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item active">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/deployment/resource-limitation/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/resource-limitation/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/deployment/resource-limitation/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/deployment/resource-limitation/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/deployment/resource-limitation/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/deployment/resource-limitation.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/deployment/'>Deployment</a> > Limiting Resource Usage
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#java-s-view-of-the-world">Java&rsquo;s View of the World</a></li>
+<li><a href="#limiting-a-component-s-memory-consumption">Limiting a Component&rsquo;s Memory Consumption</a>
+<ul>
+<li><a href="#kubernetes">Kubernetes</a></li>
+</ul></li>
+<li><a href="#limiting-the-number-of-device-connections">Limiting the Number of Device Connections</a></li>
+<li><a href="#limiting-the-overall-connection-time">Limiting the Overall Connection Time</a></li>
+<li><a href="#limiting-the-data-volume">Limiting the Data Volume</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Limiting Resource Usage</h1>
+          
+
+        
+
+
+<p>Deploying Eclipse Hono&trade; to a container orchestration platform is easy thanks to the provided Docker images. This page provides some guidance for configuring the resource consumption of these containers in order to make sure that they get enough memory and CPU to run properly, but to also make sure that individual containers do not use up all the resources causing other containers to starve.</p>
+
+<p>Docker itself provides means to limit a container&rsquo;s consumption of memory and CPU resources by means of command line options that can be set when starting up a container. Both Kubernetes and OpenShift leverage this mechanism when defining resource limits of a <em>pod</em>. Please refer to the corresponding documentation of Docker, Kubernetes and OpenShift for details regarding the particular syntax to be used.</p>
+
+<h2 id="java-s-view-of-the-world">Java&rsquo;s View of the World</h2>
+
+<p>Hono&rsquo;s service components are implemented in Java. When the corresponding Docker container for such a service is started, the only process being run inside the container is therefore a Java virtual machine (JVM). On startup, the JVM tries to determine the amount of memory and the number of CPU cores that it can use to execute workloads. By default the JVM queries the operating system for the corresponding parameters and adjusts its runtime parameters accordingly, e.g. it will by default limit the size of its heap memory to a quarter of the total memory available in order to leave enough memory for other processes running on the same system.</p>
+
+<p>This is a reasonable approach when running on <em>bare metal</em> or a VM where other processes are expected to be running on the same machine, thus competing for the same computing resources. However, containers are usually configured to run a single process only so that it makes more sense to dedicate almost all of the available resources to running that process, leaving the (small) rest for the operating system itself.</p>
+
+<p>As described above, a Docker container can easily be configured with a limit for memory and CPU resources that it may use during runtime. These limits are set and enforced using Linux <em>CGroups</em>.</p>
+
+<h2 id="limiting-a-component-s-memory-consumption">Limiting a Component&rsquo;s Memory Consumption</h2>
+
+<p>Starting with Java 9, the JVM will correctly determine the total memory and number of CPUs available when running inside of a container. All of the Docker images provided by Hono run with OpenJDK 11 by default, thus ensuring that the JVM considers any memory limits configured for the container when configuring its heap during startup. However, the default algorithm will still only allocate a quarter of the (limited) amount of memory, thus leaving a lot of memory available to the container unused.</p>
+
+<p>The following JVM options can be used in Java 9 and later in order to change this behavior:</p>
+
+<ul>
+<li><code>-XX:MinRAMPercentage</code>, <code>-XX:MaxRAMPercentage</code> and <code>-XX:InitialRAMPercentage</code> can be used to set the (minimum, maximum and initial) percentage of total memory that may be allocated for the heap. A value of 70-80% should work if no other processes are running in the same container.</li>
+</ul>
+
+<h3 id="kubernetes">Kubernetes</h3>
+
+<p>In Kubernetes (and OpenShift) the resource limits for a <em>pod</em>, and thus the container(s) that are part of the pod, can be configured in the corresponding <em>PodSpec</em>. The following example from the HTTP adapter&rsquo;s Kubernetes <em>Deployment</em> resource descriptor illustrates the mechanism:</p>
+
+<pre><code class="language-json">apiVersion: apps/v1beta1
+kind: Deployment
+metadata:
+  name: hono-adapter-http-vertx
+spec:
+  template:
+    metadata:
+      labels:
+        app: hono-adapter-http-vertx
+        version: &quot;${project.version}&quot;
+        group: ${project.groupId}
+    spec:
+      containers:
+      - image: eclipse/hono-adapter-http-vertx:${project.version}
+        name: eclipse-hono-adapter-http-vertx
+        resources:
+          limits:
+            memory: &quot;256Mi&quot;
+        ports:
+        - containerPort: 8080
+          protocol: TCP
+        env:
+        - name: SPRING_CONFIG_LOCATION
+          value: file:///etc/hono/
+        - name: SPRING_PROFILES_ACTIVE
+          value: dev
+        - name: LOGGING_CONFIG
+          value: classpath:logback-spring.xml
+        - name: _JAVA_OPTIONS
+          value: &quot;-XX:MinRAMPercentage=80 -XX:MaxRAMPercentage=80&quot;
+        volumeMounts:
+        - mountPath: /etc/hono
+          name: conf
+          readOnly: true
+      volumes:
+      - name: conf
+        secret:
+          secretName: hono-adapter-http-vertx-conf
+</code></pre>
+
+<p>The <code>resources</code> property defines the overall limit of 256 MB of memory that the pod may use. The <code>_JAVA_OPTIONS</code> environment variable is again used to configure the JVM to use 80% of the total memory for its heap.</p>
+
+<h2 id="limiting-the-number-of-device-connections">Limiting the Number of Device Connections</h2>
+
+<p>Hono supports limiting the overall number of simultaneously connected devices per tenant. Please refer to the <a href="/hono/docs/1.2/concepts/resource-limits/#connections-limit">connections limit concept</a> for more information. The limit needs to be configured at the tenant level using the <em>resource-limits</em> configuration property. Please refer to the <a href="/hono/docs/1.2/api/tenant/#tenant-information-format">Tenant API</a> for configuration details.</p>
+
+<h2 id="limiting-the-overall-connection-time">Limiting the Overall Connection Time</h2>
+
+<p>Hono supports configuring limits based on the overall amount of time that the devices have already been connected to protocol adapters for a tenant. Please refer to the <a href="/hono/docs/1.2/concepts/resource-limits/#connection-duration-limit">connection duration limit</a> for more information. Before accepting any connection requests from the devices, the protocol adapters verify that the configured connection duration limit is not exceeded. If the limit has been already reached, then the connection request is rejected. The limit needs to be configured at the tenant level using the <em>resource-limits</em> configuration property. Please refer to the <a href="/hono/docs/1.2/api/tenant/#tenant-information-format">Tenant API</a> for configuration details.</p>
+
+<h2 id="limiting-the-data-volume">Limiting the Data Volume</h2>
+
+<p>Hono supports limiting the amount of data that devices of a tenant can publish to Hono during a given time interval. Please refer to the <a href="/hono/docs/1.2/concepts/resource-limits/#messages-limit">messages limit concept</a> for more information. The limit needs to be configured at the tenant level using the <em>resource-limits</em> configuration property. Please refer to the <a href="/hono/docs/1.2/api/tenant/#tenant-information-format">Tenant API</a> for configuration details.</p>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/dev-guide/amqp_adapter_client/index.html b/docs/1.2/dev-guide/amqp_adapter_client/index.html
new file mode 100644
index 0000000..3adfda6
--- /dev/null
+++ b/docs/1.2/dev-guide/amqp_adapter_client/index.html
@@ -0,0 +1,2490 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>AMQP Adapter Client for Java :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="AMQP Adapter Client for Java :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="AMQP Adapter Client for Java :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/dev-guide/amqp_adapter_client//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item active">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/dev-guide/amqp_adapter_client/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/amqp_adapter_client/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/dev-guide/amqp_adapter_client/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/dev-guide/amqp_adapter_client.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/dev-guide/'>Developer Guide</a> > AMQP Adapter Client for Java
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#usage-in-a-gateway">Usage in a Gateway</a></li>
+<li><a href="#tracing">Tracing</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>AMQP Adapter Client for Java</h1>
+          
+
+        
+
+
+
+
+<p>Eclipse Hono&trade; comes with a Java client for the AMQP adapter. It is intended for the implementation of
+(prototype) devices, (protocol) gateways or (end-to-end) tests. The client is based on Eclipse Vert.x.</p>
+
+<p>The starting point is the class <code>AmqpAdapterClientFactory</code>.</p>
+
+<p>The factory provides methods to get a receiver for receiving commands and a sender for each of the following actions:</p>
+
+<ul>
+<li>send a telemetry message</li>
+<li>send an event message</li>
+<li>send a response to a previously received command</li>
+</ul>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Do not re-use sender instances</h4>
+    <div>The senders manage the underlying AMQP sender links, which are restored after temporary interruption of the connection
+(<code>HonoConnection</code> manages the automatic reconnection). To achieve this, a caching mechanism is used, so that
+defective links are replaced by new ones. The sender must be always retrieved from the factory when sending
+because otherwise the link might no longer exist.
+So, do not hold references to sender objects and re-use them for subsequent send operations!</div>
+</div>
+
+
+<p>For examples of how to use the client, see the example implementation in the <code>AmqpExampleDevice</code> class.</p>
+
+<h2 id="usage-in-a-gateway">Usage in a Gateway</h2>
+
+<p>There are two ways to subscribe to commands for use in a gateway:</p>
+
+<ol>
+<li>Gateway subscribing for commands for a specific device:
+The gateway subscribes individually for each connected device by creating a command consumer for the specific device.</li>
+<li>Gateway subscribing for commands for all its devices:
+The gateway subscribes for commands sent to all the different devices that the gateway acts on behalf of by
+creating a command consumer that is not scoped on a specific device.</li>
+</ol>
+
+<p>Subscribing for all devices does not work if multiple instances of the gateway are running at the same time,
+because a command is only sent to one receiver, and this may be an instance that has no connection to the device.
+On the other hand, subscribing for a specific device once it connects to the gateway instance
+(and closing the subscription once it disconnects) may not work for device-oriented protocols that are not connection-based.</p>
+
+<h2 id="tracing">Tracing</h2>
+
+<p>The AMQP Adapter Client supports tracing of the messages with <a href="https://opentracing.io/">OpenTracing</a>. To use tracing, each of the
+senders returned by the factory can be cast to an interface with the same name and the prefix &ldquo;Traceable&rdquo;
+(e.g. cast <code>TelemetrySender</code> to <code>TraceableTelemetrySender</code>).
+The traceable interfaces provide <em>send</em> methods with an additional <code>SpanContext</code> parameter.</p>
+
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/dev-guide/building_hono/index.html b/docs/1.2/dev-guide/building_hono/index.html
new file mode 100644
index 0000000..b4a085a
--- /dev/null
+++ b/docs/1.2/dev-guide/building_hono/index.html
@@ -0,0 +1,2550 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Building from Source :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Building from Source :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Building from Source :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/dev-guide/building_hono//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/dev-guide/building_hono/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item active">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/dev-guide/building_hono/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/building_hono/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/dev-guide/building_hono/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/dev-guide/building_hono/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/dev-guide/building_hono/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/dev-guide/building_hono.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/dev-guide/'>Developer Guide</a> > Building from Source
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#prerequisites-for-building-hono">Prerequisites for building Hono</a>
+<ul>
+<li>
+<ul>
+<li><a href="#docker">Docker</a></li>
+<li><a href="#java">Java</a></li>
+<li><a href="#maven">Maven</a></li>
+<li><a href="#git">Git</a></li>
+</ul></li>
+</ul></li>
+<li><a href="#getting-the-hono-source-code">Getting the Hono Source Code</a></li>
+<li><a href="#starting-the-hono-build-process">Starting the Hono Build Process</a></li>
+<li><a href="#perform-the-integration-tests">Perform the integration tests</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Building from Source</h1>
+          
+
+        
+
+
+
+
+<p>Hono can be deployed using the pre-built Docker images available from our <a href="https://hub.docker.com/u/eclipse/">Docker Hub repositories</a>. However, customizing and/or extending Hono&rsquo;s functionality requires building the images from source code.</p>
+
+<p>This page provides step by step instructions for getting the source code and building the Hono&rsquo;s Docker images from it.</p>
+
+<h2 id="prerequisites-for-building-hono">Prerequisites for building Hono</h2>
+
+<h4 id="docker">Docker</h4>
+
+<p>Creating Hono&rsquo;s container images using the Hono build process requires a <a href="http://www.docker.com">Docker</a> daemon running either locally or on another host you have access to. Please follow the instructions on the <a href="http://www.docker.com">Docker web site</a> to install Docker on your platform.</p>
+
+<h4 id="java">Java</h4>
+
+<p>Hono is written in Java and therefore requires a Java Development Kit (JDK) version 11 or higher installed on your computer. Please follow the JDK vendor&rsquo;s instructions for installing Java on your operating system.</p>
+
+<h4 id="maven">Maven</h4>
+
+<p>Hono&rsquo;s build process is based on <a href="https://maven.apache.org">Apache Maven</a>. You need at least Maven 3.5 in order to build Hono.
+Please follow the <a href="https://maven.apache.org/">installation instructions on the Maven home page</a>.</p>
+
+<h4 id="git">Git</h4>
+
+<p>A Git client is required if you want to contribute changes/improvements to the Hono project. It is not necessary for simply building Hono locally.
+Please refer to the <a href="https://git-scm.com/downloads">Git Downloads page</a> for installation instructions.</p>
+
+<h2 id="getting-the-hono-source-code">Getting the Hono Source Code</h2>
+
+<p>Either</p>
+
+<ul>
+<li>download the latest <a href="https://github.com/eclipse/hono/releases">release archive</a> and extract the archive to a local folder or</li>
+<li>clone the Hono source code repository from GitHub:
+<code>
+git clone https://github.com/eclipse/hono.git
+</code>
+This will create a <code>hono</code> folder in the current working directory and clone the whole repository into that folder.</li>
+</ul>
+
+<h2 id="starting-the-hono-build-process">Starting the Hono Build Process</h2>
+
+<p>Run the following from the source folder:</p>
+
+<pre><code class="language-sh"># in the &quot;hono&quot; folder containing the source code
+mvn clean install -Ddocker.host=tcp://${host}:${port} -Pbuild-docker-image,metrics-prometheus
+</code></pre>
+
+<p>with <code>${host}</code> and <code>${port}</code> reflecting the name/IP address and port of the host where Docker is running on. This will build all libraries, Docker images and example code. If you are running on Linux and Docker is installed locally or you have set the <code>DOCKER_HOST</code> environment variable, you can omit the <code>-Ddocker.host</code> property definition.</p>
+
+<p>If you plan to build the Docker images more frequently, e.g. because you want to extend or improve the Hono code, then you should define the <code>docker.host</code> property in your Maven <code>settings.xml</code> file containing the very same value as you would use on the command line as indicated above. The file is usually located in the <code>.m2</code> folder in your user&rsquo;s home directory. This way you can simply do a <code>mvn clean install</code> later on and the Docker images will be built automatically as well because the <code>build-docker-image</code> profile is activated automatically if the Maven property <code>docker.host</code> is set.</p>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Be patient</h4>
+    <div>The first build might take several minutes because Docker will need to download all the base images that Hono is relying on. However, most of these will be cached by Docker so that subsequent builds will be running much faster.</div>
+</div>
+
+
+<h2 id="perform-the-integration-tests">Perform the integration tests</h2>
+
+<p>The source code for Hono comes with a test suite for integration testing. To trigger these tests, change to the <code>tests</code> folder and execute:</p>
+
+<pre><code># in the &quot;hono/tests&quot; folder containing the test suite
+mvn verify -Prun-tests
+</code></pre>
+
+<p>The tests are executed against the Docker images of the Hono components. Because of that, it is necessary to build the respective images as described above before the execution of the tests. The respective <code>Readme.md</code> file in the folder <code>hono/tests</code> contains more information regarding the test suite.</p>
+
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/dev-guide/custom_http_adapter/index.html b/docs/1.2/dev-guide/custom_http_adapter/index.html
new file mode 100644
index 0000000..54ded90
--- /dev/null
+++ b/docs/1.2/dev-guide/custom_http_adapter/index.html
@@ -0,0 +1,2587 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Implement a Custom Hono HTTP Protocol Adapter :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Implement a Custom Hono HTTP Protocol Adapter :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Implement a Custom Hono HTTP Protocol Adapter :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/dev-guide/custom_http_adapter//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item active">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/dev-guide/custom_http_adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/custom_http_adapter/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/dev-guide/custom_http_adapter/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/dev-guide/custom_http_adapter/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/dev-guide/custom_http_adapter/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/dev-guide/custom_http_adapter.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/dev-guide/'>Developer Guide</a> > Implement a Custom Hono HTTP Protocol Adapter
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#prerequisites">Prerequisites</a></li>
+<li><a href="#the-standard-http-adapter">The standard HTTP Adapter</a></li>
+<li><a href="#anatomy-of-the-standard-http-adapter">Anatomy of the standard HTTP Adapter</a></li>
+<li><a href="#derive-a-custom-http-protocol-adapter">Derive a custom HTTP Protocol Adapter</a>
+<ul>
+<li><a href="#adding-routes">Adding Routes</a></li>
+</ul></li>
+<li><a href="#build-and-run-the-custom-http-protocol-adapter">Build and run the custom HTTP Protocol Adapter</a></li>
+<li><a href="#using-the-custom-http-protocol-adapter">Using the custom HTTP Protocol Adapter</a></li>
+<li><a href="#further-extend-the-custom-http-protocol-adapter">Further extend the custom HTTP Protocol Adapter</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Implement a Custom Hono HTTP Protocol Adapter</h1>
+          
+
+        
+
+
+<p>Eclipse Hono&trade; comes with a default <em>HTTP Adapter</em> which can be used to interact with devices via HTTP.
+The default HTTP Adapter also serves as a blueprint for implementing a <em>custom</em> HTTP protocol adapter.</p>
+
+<p>This section will guide you through the steps to build your own custom HTTP protocol adapter.</p>
+
+<h2 id="prerequisites">Prerequisites</h2>
+
+<p>You should be familiar with the setup and start of Hono. Refer to the
+<a href="https://www.eclipse.org/hono/getting-started/
+">Getting Started</a> guide.</p>
+
+<h2 id="the-standard-http-adapter">The standard HTTP Adapter</h2>
+
+<p>Hono&rsquo;s HTTP Adapter supports telemetry and event data processing. Please refer to the <a href="/hono/docs/1.2/user-guide/http-adapter/">HTTP Adapter User Guide</a> and <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">HTTP Adapter Admin Guide</a> for details regarding the usage and configuration of the HTTP Adapter.</p>
+
+<p>You can find the source of the HTTP Adapter at <a href="https://github.com/eclipse/hono/tree/master/adapters/http-vertx">https://github.com/eclipse/hono/tree/master/adapters/http-vertx</a>.</p>
+
+<h2 id="anatomy-of-the-standard-http-adapter">Anatomy of the standard HTTP Adapter</h2>
+
+<p>Like many other Hono components, the HTTP Adapter is built on top of the <a href="https://vertx.io">Vert.x</a> framework.</p>
+
+<p>The HTTP Adapter&rsquo;s <code>VertxBasedHttpProtocolAdapter</code> class is derived from an abstract base class. This base class implements the standard functionality for component initialization, receiving HTTP requests from devices or external clients, and forwarding of data to the downstream <em>AMQP Messaging Network</em>.</p>
+
+<h2 id="derive-a-custom-http-protocol-adapter">Derive a custom HTTP Protocol Adapter</h2>
+
+<p>Use the standard HTTP Adapter as a blueprint.</p>
+
+<h3 id="adding-routes">Adding Routes</h3>
+
+<p>In Vert.x, a <em>route</em> is a mapping of an HTTP request to a <em>handler</em>. Inside a route, Vert.x provides a <code>RoutingContext</code>
+instance which gives access to the HTTP request (and response) object containing the HTTP headers.</p>
+
+<p>The standard HTTP Adapter overrides the abstract method <code>addRoutes()</code>, provided by the base class, and adds routes for processing telemetry data and events.</p>
+
+<pre><code class="language-java">// route for uploading telemetry data
+router.route(HttpMethod.PUT, String.format(&quot;/telemetry/:%s/:%s&quot;, PARAM_TENANT, PARAM_DEVICE_ID))
+    .handler(ctx -&gt; uploadTelemetryMessage(ctx, getTenantParam(ctx), getDeviceIdParam(ctx)));
+</code></pre>
+
+<p>The route for telemetry data parses the HTTP request, extracts the <em>tenant</em> and <em>deviceId</em> parameters from the
+request URL path, and forwards the message payload to the method <code>uploadTelemetryMessage()</code>, provided by the base class.</p>
+
+<p><strong>NB</strong> Note the Vert.x place holder indicators <code>:</code> inside the URL path pattern <code>/telemetry/:%s/:%s</code>. Vert.x makes matching
+place holders available as request parameters. See <a href="http://vertx.io/docs/vertx-web/java/#_capturing_path_parameters">Capturing path parameters</a> in the Vert.x documentation.</p>
+
+<p>The route for events looks very similar to the route for telemetry data. It forwards the event message payload to the <code>uploadEventMessage()</code> method.</p>
+
+<p>Please refer to the <a href="/hono/docs/1.2/api/telemetry/">Telemetry API</a> and <a href="/hono/docs/1.2/api/event/">Event API</a>
+for details about the different Hono APIs.</p>
+
+<p>In the custom HTTP protocol adapter adapt the routes according to your needs.</p>
+
+<h2 id="build-and-run-the-custom-http-protocol-adapter">Build and run the custom HTTP Protocol Adapter</h2>
+
+<p>If you have Hono running, you can launch your custom HTTP protocol adapter as a Docker Container or a Spring Boot application.</p>
+
+<p>You may adopt the Maven profile <code>build-docker-image</code> from the Maven POM file of the standard HTTP Adapter into your
+custom adapter&rsquo;s Maven POM file.</p>
+
+<p>Follow the guidelines for running the HTTP Adapter in <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">HTTP Adapter</a>. Don&rsquo;t forget to configure the custom protocol adapter to bind to a different port than the standard HTTP Adapter if you intend to run them both at the same time. See the <a href="/hono/docs/1.2/admin-guide/http-adapter-config/#port-configuration">Port Configuration section</a> of the HTTP Adapter documentation for details.</p>
+
+<h2 id="using-the-custom-http-protocol-adapter">Using the custom HTTP Protocol Adapter</h2>
+
+<p>Now that you have your custom HTTP protocol adapter up and running, you can use any HTTP client, like <code>curl</code> or
+<code>HTTPie</code>, to publish data to your custom adapter.</p>
+
+<p>Note that before publishing data to your custom HTTP protocol adapter, you need to start a <em>consumer</em> for the tenant you intend to publish data for.
+Otherwise you will not be able to successfully send data. For this purpose, you may use the example consumer as described in the <a href="https://www.eclipse.org/hono/getting-started/
+">Getting Started</a> guide.</p>
+
+<h2 id="further-extend-the-custom-http-protocol-adapter">Further extend the custom HTTP Protocol Adapter</h2>
+
+<p>The abstract base class includes additional hooks which you may use to <em>plug into</em> the adapter&rsquo;s life cycle:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Hook</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>preStartup()</code></td>
+<td align="left">called before start of adapter&rsquo;s HTTP server</td>
+</tr>
+
+<tr>
+<td align="left"><code>onStartupSuccess()</code></td>
+<td align="left">called after successful start of adapter</td>
+</tr>
+
+<tr>
+<td align="left"><code>preShutdown()</code></td>
+<td align="left">called before stop of adapter&rsquo;s HTTP server</td>
+</tr>
+
+<tr>
+<td align="left"><code>postShutdown</code></td>
+<td align="left">called after successful stop of adapter</td>
+</tr>
+</tbody>
+</table>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/dev-guide/index.html b/docs/1.2/dev-guide/index.html
new file mode 100644
index 0000000..ee6b68d
--- /dev/null
+++ b/docs/1.2/dev-guide/index.html
@@ -0,0 +1,2454 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Developer Guide :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Developer Guide :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Developer Guide :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/dev-guide//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/dev-guide/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        parent
+        active
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/dev-guide/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/dev-guide/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/dev-guide/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/dev-guide/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/dev-guide/_index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > Developer Guide
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+              </div>
+            </div>
+            
+
+        
+          <div id="chapter">
+        
+        <div id="body-inner">
+          
+
+        
+
+
+
+
+<h1 id="developer-guide">Developer Guide</h1>
+
+<p>Learn how to build Eclipse Hono&trade; and how to integrate your custom components with it.</p>
+
+
+<footer class=" footline" >
+	
+</footer>
+
+        
+            </div> 
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
diff --git a/docs/1.2/dev-guide/index.xml b/docs/1.2/dev-guide/index.xml
new file mode 100644
index 0000000..ec3b7b8
--- /dev/null
+++ b/docs/1.2/dev-guide/index.xml
@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>Developer Guide on Eclipse Hono&amp;trade; Vers.: 1.2</title>
+    <link>https://www.eclipse.org/hono/docs/1.2/dev-guide/</link>
+    <description>Recent content in Developer Guide on Eclipse Hono&amp;trade; Vers.: 1.2</description>
+    <generator>Hugo -- gohugo.io</generator>
+    <language>en-us</language>
+    
+	<atom:link href="https://www.eclipse.org/hono/docs/1.2/dev-guide/index.xml" rel="self" type="application/rss+xml" />
+    
+    
+    <item>
+      <title>Building from Source</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/dev-guide/building_hono/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/dev-guide/building_hono/</guid>
+      <description>Hono can be deployed using the pre-built Docker images available from our Docker Hub repositories. However, customizing and/or extending Hono&amp;rsquo;s functionality requires building the images from source code.
+This page provides step by step instructions for getting the source code and building the Hono&amp;rsquo;s Docker images from it.
+Prerequisites for building Hono Docker Creating Hono&amp;rsquo;s container images using the Hono build process requires a Docker daemon running either locally or on another host you have access to.</description>
+    </item>
+    
+    <item>
+      <title>AMQP Adapter Client for Java</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/dev-guide/amqp_adapter_client/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/dev-guide/amqp_adapter_client/</guid>
+      <description>Eclipse Hono&amp;trade; comes with a Java client for the AMQP adapter. It is intended for the implementation of (prototype) devices, (protocol) gateways or (end-to-end) tests. The client is based on Eclipse Vert.x.
+The starting point is the class AmqpAdapterClientFactory.
+The factory provides methods to get a receiver for receiving commands and a sender for each of the following actions:
+ send a telemetry message send an event message send a response to a previously received command   Do not re-use sender instances The senders manage the underlying AMQP sender links, which are restored after temporary interruption of the connection (HonoConnection manages the automatic reconnection).</description>
+    </item>
+    
+    <item>
+      <title>Consuming Messages from Java</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/dev-guide/java_client_consumer/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/dev-guide/java_client_consumer/</guid>
+      <description>To illustrate how Eclipse Hono&amp;trade; can be integrated with Java code, a simple application is provided that consumes telemetry and event data for devices belonging to the default tenant.
+It also includes support for Command and Control:
+if indicated by a received downstream message that contains a ttd value (refer to Device notifications for details) it tries to send a command to the device. If the value of ttd indicates that the device stays connected for an unlimited time (ttd == -1), the application will periodically repeat to send a command until notified the device is disconnected again (ttd == 0).</description>
+    </item>
+    
+    <item>
+      <title>Implement a Custom Hono HTTP Protocol Adapter</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/dev-guide/custom_http_adapter/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/dev-guide/custom_http_adapter/</guid>
+      <description>&lt;p&gt;Eclipse Hono&amp;trade; comes with a default &lt;em&gt;HTTP Adapter&lt;/em&gt; which can be used to interact with devices via HTTP.
+The default HTTP Adapter also serves as a blueprint for implementing a &lt;em&gt;custom&lt;/em&gt; HTTP protocol adapter.&lt;/p&gt;</description>
+    </item>
+    
+  </channel>
+</rss>
\ No newline at end of file
diff --git a/docs/1.2/dev-guide/java_client_consumer/index.html b/docs/1.2/dev-guide/java_client_consumer/index.html
new file mode 100644
index 0000000..93f4afe
--- /dev/null
+++ b/docs/1.2/dev-guide/java_client_consumer/index.html
@@ -0,0 +1,2557 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Consuming Messages from Java :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Consuming Messages from Java :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Consuming Messages from Java :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/dev-guide/java_client_consumer//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/dev-guide/java_client_consumer/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item active">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/dev-guide/java_client_consumer/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/java_client_consumer/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/dev-guide/java_client_consumer/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/dev-guide/java_client_consumer/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/dev-guide/java_client_consumer/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/dev-guide/java_client_consumer.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/dev-guide/'>Developer Guide</a> > Consuming Messages from Java
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#configure-the-example">Configure the example</a></li>
+<li><a href="#run-the-example">Run the example</a>
+<ul>
+<li><a href="#telemetry-and-event-messages">Telemetry and Event messages</a></li>
+<li><a href="#command-and-control">Command and Control</a></li>
+<li><a href="#encryption-of-communication">Encryption of communication</a></li>
+</ul></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Consuming Messages from Java</h1>
+          
+
+        
+
+
+
+
+<p>To illustrate how Eclipse Hono&trade; can be integrated with Java code, a simple application is provided that consumes telemetry and event data
+for devices belonging to the default tenant.</p>
+
+<p>It also includes support for Command and Control:</p>
+
+<p>if indicated by a received downstream message that contains a <code>ttd</code> value (refer to <a href="/hono/docs/1.2/concepts/device-notifications/">Device notifications</a> for details) it tries to send a command to the device.
+If the value of <code>ttd</code> indicates that the device stays connected for an unlimited time (<code>ttd == -1</code>), the application will periodically repeat to send a command until
+notified the device is disconnected again (<code>ttd == 0</code>).</p>
+
+<p>This application shall serve as a blueprint to integrate your existing java source code with Hono.
+Its code is found in the <a href="https://github.com/eclipse/hono/tree/master/example">example</a> module in the package <a href="https://github.com/eclipse/hono/tree/master/example/src/main/java/org/eclipse/hono/vertx/example">org.eclipse.hono.vertx.example</a>.</p>
+
+<p>The provided classes are kept as simple as possible (in the tradition of a classical &ldquo;Hello World&rdquo; implementation) while still
+covering the most relevant messaging patterns (downstream and upstream messages).
+For this purpose they make use of simple constant definitions and deal with exceptions as rarely as possible.
+You may want to change the level of detail that should be logged to the console by editing the contained <code>resources/logback.xml</code> file.</p>
+
+<p>Please refer to the javadoc of the classes for details.</p>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Note</h4>
+    <div>Note that production ready code likely has to think more about error handling and logging than this simple blueprint.</div>
+</div>
+
+
+<h2 id="configure-the-example">Configure the example</h2>
+
+<p>For simplicity, all configurations are defined as Java constants inside the class <a href="https://github.com/eclipse/hono/blob/master/example/src/main/java/org/eclipse/hono/vertx/example/base/HonoExampleConstants.java">HonoExampleConstants</a>.</p>
+
+<p>If you have Hono running in Docker under <code>localhost</code>, the example should work out of the box.</p>
+
+<p>Some configuration values can be overridden by providing them as property to the application.</p>
+
+<p>This includes the <code>host</code> and the <code>port</code> of the AMQP network.
+In the standard setup of Hono they should be configured to the <a href="https://qpid.apache.org/components/dispatch-router/index.html">qdrouter</a> from the Apache Qpid project.
+In production scenarios this might be a large setup of AMQP routers, brokers, etc.</p>
+
+<p>Please refer to the class <code>HonoExampleConstants</code> to find out which part of the application can be configured by properties.</p>
+
+<h2 id="run-the-example">Run the example</h2>
+
+<p>The application waits for messages until you press any key or kill it.</p>
+
+<p>It is started by</p>
+
+<pre><code class="language-sh"># in directory: hono/example/
+mvn exec:java -Dexec.mainClass=org.eclipse.hono.vertx.example.HonoExampleApplication
+</code></pre>
+
+<p>or &mdash; if e.g. the host of the AMQP network should be changed &mdash;</p>
+
+<pre><code class="language-sh">mvn exec:java -Dexec.mainClass=org.eclipse.hono.vertx.example.HonoExampleApplication -Dconsumer.host=192.168.99.100
+</code></pre>
+
+<h3 id="telemetry-and-event-messages">Telemetry and Event messages</h3>
+
+<p>Depending on the logger configuration, all received downstream messages are printed to the console.</p>
+
+<p>Please note that consumers do not connect with Hono directly, but rather with an AMQP router network.</p>
+
+<h3 id="command-and-control">Command and Control</h3>
+
+<p>By using a helper class provided by Hono, a callback in the application code is invoked when a downstream message was received
+that signals the device will stay connected to the protocol adapter for some time (see <a href="/hono/docs/1.2/concepts/device-notifications/">Device notifications</a> for details).</p>
+
+<p>Inside this callback an arbitrary simple command is sent down to the device (once or periodically) and the response is logged to the console.</p>
+
+<h3 id="encryption-of-communication">Encryption of communication</h3>
+
+<p>For the encrypted communication with Hono, the necessary truststore is already installed and used by the Hono client.</p>
+
+<p>If you want to integrate the code with your own software, please copy the provided truststore (<code>hono/demo-certs/certs/trusted-certs.pem</code>)
+from the Hono project to the <code>resources</code> directory of your project
+and adopt the code pointing to the file location.</p>
+
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/index.html b/docs/1.2/index.html
new file mode 100644
index 0000000..d9ab2f4
--- /dev/null
+++ b/docs/1.2/index.html
@@ -0,0 +1,2407 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Documentation :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Documentation :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Documentation :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+
+        
+          <div id="chapter">
+        
+        <div id="body-inner">
+          
+
+        
+
+<span id="sidebar-toggle-span">
+<a href="#" id="sidebar-toggle" data-sidebar-toggle=""><i class="fas fa-bars"></i> navigation</a>
+</span>
+
+ 
+
+
+<h1 id="documentation">Documentation</h1>
+
+<p>Learn about Eclipse Hono&trade; and look up details.</p>
+	
+  
+        
+            </div> 
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/index.json b/docs/1.2/index.json
new file mode 100644
index 0000000..358b2ee
--- /dev/null
+++ b/docs/1.2/index.json
@@ -0,0 +1,407 @@
+[
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/",
+	"title": "Documentation",
+	"tags": [],
+	"description": "",
+	"content": " Documentation Learn about Eclipse Hono\u0026trade; and look up details.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/concepts/",
+	"title": "Concepts",
+	"tags": [],
+	"description": "",
+	"content": " Concepts Understand the concepts behind Eclipse Hono\u0026trade;.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/concepts/device-identity/",
+	"title": "Device Identity",
+	"tags": [],
+	"description": "",
+	"content": "This page describes how devices are represented and identified throughout Hono and its APIs.\nThe main purpose of Hono is to provide a uniform API for applications to interact with devices, regardless of the particular communication protocol the devices natively use. In order to do so, Hono uses a unique logical identifier to refer to each device individually.\nHono does not make any assumptions about the format of a device identifier (or device-id for short). It basically is a string which is defined at the time a device is being provisioned. Once created, the device can be referred to by this identifier when using Hono\u0026rsquo;s APIs until the device is being removed from the system.\nTenant Hono supports the logical partitioning of devices into groups called tenants. Each tenant has a unique identifier, a string called the tenant-id, and can be used to provide a logical grouping of devices belonging e.g. to the same application scope or organizational unit. Each device can thus be uniquely identified by the tuple (tenant-id, device-id). This tuple is broadly used throughout Hono\u0026rsquo;s APIs when addressing a particular device.\nDevice Registration Hono components use the Device Registration API to access device registration information. The API defines the assert Registration operation for verifying a device\u0026rsquo;s registration status. In many real world scenarios there will already be a component in place which keeps track of devices and which supports the particular provisioning process being used to bring devices into life. In such cases it makes sense to simply implement the Device Registration API as a facade on top of the existing component.\nIn addition to that, Hono defines a Device Registry Management API, which can be implemented to take advantage of standardized operations for managing devices and credentials. This API is optional because Hono components do not require it during runtime.\nFor demonstration purposes, Hono comes with a simple default implementation of both APIs which keeps all data in memory only. Therefore it is not supposed to be used in production scenarios. For the future, it is planned that a production-ready Device Registry will be released as part of Hono that implements both APIs.\nDevice Authentication Devices connect to protocol adapters in order to publish telemetry data or events. Downstream applications consuming this data often take particular actions based on the content of the messages. Such actions may include simply updating some statistics, e.g. tracking the average room temperature, but may also trigger more serious activities like shutting down a power plant. It is therefore important that applications can rely on the fact that the messages they process have in fact been produced by the device indicated by a message\u0026rsquo;s source address.\nHono relies on protocol adapters to establish a device\u0026rsquo;s identity before it is allowed to publish downstream data or receive commands. Conceptually, Hono distinguishes between two identities\n an identity associated with the authentication credentials (termed the authentication identity or auth-id), and an identity to act as (the device identity or device-id).  A device therefore presents an auth-id as part of its credentials during the authentication process which is then resolved to a device identity by the protocol adapter on successful verification of the credentials.\nIn order to support the protocol adapters in the process of verifying credentials presented by a device, the Credentials API provides means to look up secrets on record for the device and use this information to verify the credentials.\nThe Credentials API supports registration of multiple sets of credentials for each device. A set of credentials consists of an auth-id and some sort of secret information. The particular type of secret determines the kind of information kept. Please refer to the Standard Credential Types defined in the Credentials API for details. Based on this approach, a device may be authenticated using different types of secrets, e.g. a hashed password or a pre-shared key, depending on the capabilities of the device and/or protocol adapter.\nOnce the protocol adapter has resolved the device-id for a device, it uses this identity when referring to the device in all subsequent API invocations, e.g. when forwarding telemetry messages downstream to the AMQP Messaging Network.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/concepts/tenancy/",
+	"title": "Multi-Tenancy",
+	"tags": [],
+	"description": "",
+	"content": " Hono is designed to structure the set of all internally managed data and data streams into strictly isolated subsets. This includes the registration data and credentials of devices, internal users that are used for authentication, and the Business Applications that are part of such subsets as well.\nThis way of strict isolation is generally known as multi-tenancy, where a tenant is the term for such a subset. Such an isolation is essential for enabling a scalable distributed architecture to handle independent subsets as if each subset had its own installation (which would be much harder to maintain and would not benefit from runtime cost sharing).\nHono\u0026rsquo;s multi-tenancy concept is based on handling tenants as own entities. All functionality of Hono is provided in the context of a previously created tenant - except the creation of a tenant itself.\nIn the following the different aspects of multi-tenancy in Hono are addressed and a full overview of the concept is given.\nThe Tenant API By means of the Tenant API Hono handles tenants as own entities. The API defines how to retrieve the details of a specific tenant. This offers the possibility to handle arbitrary properties on the level of a tenant (see e.g. Protocol adapter configuration). For convenience, there are CRUD operations for the handling of tenants, which can be found in the Device Registry.\nProtocol Adapters respect the Tenant API When a device connects to one of Hono\u0026rsquo;s protocol adapters, the adapter determines the tenant this device belongs to. How this is done is described in the User Guide. After the tenant is determined, the adapter retrieves the details of the determined tenant by means of the Tenant API. Only if the tenant exists and is enabled the adapter further processes the data of the device that is connecting. Otherwise the connection will be closed.\nProtocol Adapter Configuration Protocol adapters retrieve parts of their configuration on a tenant level by using the details of the determined tenant. This includes e.g. if a specific protocol adapter is enabled at all for this tenant, allowing to define tenants with only a subset of Hono\u0026rsquo;s functionality. This feature is foreseen to be especially important for production setups.\nExample: a tenant that\n can use the MQTT protocol adapter but is not allowed to use the HTTP protocol adapter  Please refer to the Tenant API to find out which protocol adapter properties can be configured at the tenant level.\nAMQP 1.0 Endpoints The AMQP 1.0 endpoints for all APIs of Hono are scoped to a tenant, by using the scheme \u0026lt;api-name\u0026gt;/TENANT/....\nExamples:\n telemetry/TENANT registration/TENANT  etc.\nThis separates the AMQP endpoints from each other on a tenant level.\nThe only exception to this is the Tenant API, which does not follow this scheme since it is addressing the tenants themselves.\nDevices and Tenants A physical device will usually be represented in Hono as an entity in the device registry, having a unique identity and belonging to exactly one tenant. All data sent from a device, as well as from the application to the device, is therefore treated as belonging to the corresponding tenant.\nThe following diagram shows the relation between tenants, devices and their credentials:\n  Tenants, Devices and Credentials   Tenant based Flow Control An important detail in Hono\u0026rsquo;s architecture is that data sent downstream is transported via the tenant scoped AMQP 1.0 links from the protocol adapters to the AMQP 1.0 network. Each tenant has its own pair of AMQP 1.0 links and is treated independently from other tenants regarding the back pressure mechanism that AMQP 1.0 offers. This enables a Business application to limit the rate at which it consumes AMQP 1.0 messages per tenant.\nFor the other direction, when commands are sent from the application to the device, the rate is also limited per tenant.\nAuthorization at Tenant Level Hono\u0026rsquo;s components authenticate each other by means of the Authentication API. The returned token for a successful authentication contains authorization information that is addressing the AMQP 1.0 endpoints. Since the endpoints (as outlined above) are scoped to a tenant, this enables to configure tenants that are authorized to only a subset of Hono\u0026rsquo;s full functionality.\nExample: a tenant (defined by means of authorization configuration) that\n is allowed to send telemetry data downstream but is not allowed to send event data  This is done by not including the event endpoint in the authorization token for these tenants.\nBusiness Applications and Tenants The northbound Business applications are always connecting to the AMQP 1.0 endpoints of Hono. By means of the authentication and authorization setup and the fact that the endpoints are scoped to a tenant, the Business application is only acting in the context of one tenant.\nSeparation of Tenants Tenants are separated from each other in all of Hono\u0026rsquo;s components. Here is a summary of how this is implemented:\n the registration of devices are strictly scoped to a tenant the credentials of devices are strictly scoped to a tenant protocol adapters can be enabled/disabled for a tenant the downstream data flow is isolated for every tenant the upstream data flow (Command \u0026amp; Control) is isolated for every tenant Business applications need to authenticate to the AMQP 1.0 network and are by that mechanism scoped to their tenant  Hints for Production To be flexible for the different needs of production setups, Hono tries to make as few assumptions about the combination of the different APIs as possible. This means e.g. that the Device Registry does not enforce referential integrity of the APIs:\n devices can be created for a tenant that is not existing (yet) credentials can be created for a tenant and/or a device that is not existing (yet) tenants can be deleted and leave their scoped devices and credentials still in the configuration (which may not be usable anymore, since the tenant is missing)  These are points that production setups may want to implement differently.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/concepts/device-provisioning/",
+	"title": "Device Provisioning",
+	"tags": [],
+	"description": "",
+	"content": " This page describes how devices are provisioned in Hono, i.e. how their digital representation is generated. For each device, registration information is stored that defines a device identity. Each device belongs to exactly one tenant. Each device must have at least one set of credentials that are used to authenticate to Hono.\nTo get an understanding of what is meant by the terms tenant, device registration and credentials, it is recommended to read the Device Identity page first.\nSo in order to use a device with Hono, it has to be provisioned. This means that registration information and at least one credential record must be stored in the device registry.\nThere are different ways to perform device provisioning.\nManual Device Provisioning Devices can be provisioned using Hono\u0026rsquo;s Device Registry Management API via HTTP.\nIf the desired tenant does not yet exist, it must be created first. How to do this is described in the User Guide of the Device Registry.\nThe actual Device Provisioning is then performed as described under Register Device. This creates both a device identity and an (empty) credentials record. The last step is to add real credentials as described in Update Credentials for a Device.\nAutomatic Device Provisioning The term Auto-Provisioning denotes a feature of Hono where the Device Registry automatically generates the credentials and registration information for a device the first time it connects. Auto-Provisioning is supported by Hono\u0026rsquo;s protocol adapters for devices that authenticate with client certificates. The feature can be enabled per certificate authority (CA) at the tenant.\nPrerequisites Hono does not require a specific Device Registry implementation, but only specifies a set of APIs that must be provided by a compatible implementation. Since the main part of the Auto-Provisioning has to be done by the Device Registry, the used implementation must explicitly support this feature.\nSequence of steps in Auto-Provisioning Auto-Provisioning consists of two steps.\nStep 1: Configure the Tenant The CA to be used by the devices needs to be configured. The following tasks must be performed:\n Create tenant Configure the trusted CA for the tenant Enable the feature for the CA  If the Device Registry implementation provides the Management API, this could be done in a single step. For details refer to the Tenant API specification.\nStep 2: Connect an unregistered Device to Hono   Automatic Provisioning of a Device   Hono\u0026rsquo;s protocol adapters query the APIs of the Device Registry during Device Authentication. First, the Tenant API is queried. If the Tenant configuration returned contains the CA used for authentication and the feature is switched on for this CA, the protocol adapter assumes that automatic provisioning must be performed. It puts the device\u0026rsquo;s certificate into the query to enable the device registry to do the provisioning.\nIf the Device Registry does not find any credentials for the device, it takes the information from the client certificate to create both credentials and device registration data for it.\nThe Device Registry is expected to perform the following steps:\n Generate a unique device-id Create device Create credentials Optional: Provision device in external systems  The newly created credentials are returned to the protocol adapter in the response as if they had been present before.\nThe following query of the Device Registration API returns the previously generated registration data.\nThe provisioning is, of course, a one-time action, on subsequent connections the APIs simply return the stored records.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/concepts/connecting-devices/",
+	"title": "Connecting Devices",
+	"tags": [],
+	"description": "",
+	"content": " One of the most important features of Eclipse Hono\u0026trade; is to abstract away the specific communication protocols used by devices. This page describes the different ways of how devices can be connected to Hono. Before a device can connect to Hono and upload data or receive commands from downstream applications, it needs to be provisioned to the system. As part of device provisioning, the device is associated with the tenant that it belongs to and gets assigned a logical identifier which is unique within the tenant.\nDevices can be generally partitioned into two groups: devices which natively support the Internet Protocol (IP) for communication and devices that don\u0026rsquo;t.\nDevices falling into the former group can connect to Hono directly using any of the IP based protocols supported by Hono\u0026rsquo;s protocol adapters. Devices from the latter group often use radio based or serial line communication protocols that are limited to a local area and require a gateway in order to connect to one of Hono\u0026rsquo;s protocol adapters via IP.\nThe diagram below shows a device that supports the MQTT protocol and connects directly to Hono\u0026rsquo;s MQTT protocol adapter and another device that uses Bluetooth LE for connecting locally to a gateway which then connects to Hono\u0026rsquo;s MQTT adapter.\n  Connecting to a Protocol Adapter directly The most straight forward scenario is a device connecting to one of Hono\u0026rsquo;s protocol adapters directly via IP based network infrastructure. For this to work, the device needs to use a communication protocols supported by one of the adapters and needs to be able to use the resource endpoints exposed by that particular protocol adapter as described in its user guide.\nIn this case the connected device\u0026rsquo;s identity will be resolved as part of authentication during connection establishment. For this to work, a set of credentials needs to be provisioned for the device which needs to be appropriate for usage with one of the adapter\u0026rsquo;s supported authentication schemes.\nConnecting via a Device Gateway In some cases, a device may not be able to directly connect to one of Hono\u0026rsquo;s protocol adapters. An example is a device that uses a serial bus or radio waves for local communication. Such devices can be connected to a protocol adapter by means of a device gateway which acts on behalf of the device(s) when communicating with Hono. A device gateway is often implemented as a (small) hardware box close to the devices, running some gateway software which translates hence and forth between the device and one of Hono\u0026rsquo;s protocol adapters.\nFrom the perspective of a protocol adapter, the gateway looks just like any other device having its own device identity and credentials.\nThe following diagram illustrates how a gateway publishes data on behalf of a device that uses Bluetooth for local communication with the gateway.\n   The device establishes a Bluetooth connection with the gateway. The gateway sends an MQTT CONNECT packet to Hono\u0026rsquo;s MQTT adapter to establish an MQTT connection. The packet contains the gateway\u0026rsquo;s credentials. The MQTT adapter determines the tenant from the username contained in the CONNECT packet and retrieves the hashed password that is on record for the gateway from the Credentials service. The Credentials service returns the hashed password. The MQTT adapter checks the password and accepts the connection request. The device sends some sensor readings via Bluetooth to the gateway. The gateway forwards the sensor data in an MQTT PUBLISH packet to the MQTT adapter. The topic name contains the identifier of the device that the gateway acts on behalf of. The MQTT adapter invokes the Device Registration service\u0026rsquo;s assert Device Registration operation to check if the gateway is authorized to act on behalf of the device. The Device Registration service confirms the gateway\u0026rsquo;s authorization. The MQTT adapter accepts the sensor data from the gateway and forwards it downstream.  Note that the device itself is not authenticated by the MQTT adapter in this case. The responsibility for establishing and verifying the device identity lies with the gateway in this setup. It is therefore not necessary to provision credentials for the devices to Hono.\nThe Device Registry Management API\u0026rsquo;s /devices resource can be used to register gateways and devices. The gateways that are authorized to act on behalf of a device can be set by means of the device\u0026rsquo;s via and viaGroups properties. This is useful in cases where a device may roam among multiple gateways.\nWhen sending commands to a device, Hono needs to determine which of the authorized gateways should be used to forward the command message to the device. For this purpose, Hono\u0026rsquo;s protocol adapters keep track of the last known gateway which has acted on behalf of each device by means of the Device Connection API.\nGateway Groups In larger deployments with many gateways it can become cumbersome to list all possible gateways in the via property of each device explicitly. This becomes even more of a burden when gateways are added and/or removed frequently. To help with such situations it is possible to define groups of gateways using Hono\u0026rsquo;s Device Registry Management API.\nA gateway group can be defined implicitly by means of adding the group\u0026rsquo;s identifier to the list in the memberOf property of a (gateway) device that should belong to the group. The gateway group ID can then be added to the viaGroups property of those devices that all gateways in the gateway group are authorized to act on behalf of.\nNote that the Device Registration API, which is used by protocol adapters to verify if a gateway may act on behalf of a device, has no notion of gateway groups. Thus, the response message of the Device Registration API\u0026rsquo;s assert Device Registration operation does not contain the IDs of gateway groups in its via property but instead contains the IDs of all (gateway) devices that are a member of any of the authorized gateway groups.\n Note Hono\u0026rsquo;s example device registry does not support nested gateway groups.  Connecting via a Protocol Gateway Hono already comes with a set of standard protocol adapters which support the most widely used (IP based) IoT protocols like HTTP, MQTT and AMQP 1.0. Devices using one of these protocols might be able to directly connect to the corresponding adapter as described in the previous section. However, even if the device supports MQTT it might still not be possible to connect to the MQTT adapter because the device expects to use a topic structure that differs from the one employed by the MQTT adapter. In other cases devices might use a proprietary, highly optimized, binary (IP based) protocol for communication with back end infrastructure.\nHono supports connecting such devices to one of the standard protocol adapters by means of a protocol gateway. A protocol gateway is a software service which translates hence and forth between the device\u0026rsquo;s proprietary protocol and the protocol used by the Hono protocol adapter. This concept is very similar to the device gateway described above. The main difference is that a protocol gateway is usually deployed in the back end (close to the protocol adapter) whereas a device gateway is usually deployed close to the devices that are connected to the gateway using a mechanism that is usually constrained to a local area.\nThe diagram below illustrates how two devices use a proprietary IP based protocol to connect to a protocol gateway in the back end which in turn is connected to Hono\u0026rsquo;s standard AMQP 1.0 protocol adapter.\n  The devices publish data to the protocol gateway using the proprietary IP based protocol. The gateway then puts the data into AMQP 1.0 messages and forwards them to the Hono AMQP adapter using the AMQP 1.0 protocol.\nThe requirements and prerequisites for this approach are the same as those for the standard device gateway scenario. Authentication and authorization of gateways works in the same way.\nExample Code Hono\u0026rsquo;s examples module contains code for a simple protocol gateway illustrating how devices using a binary TCP based protocol can be connected to Hono\u0026rsquo;s AMQP adapter.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/concepts/device-notifications/",
+	"title": "Device Notifications",
+	"tags": [],
+	"description": "",
+	"content": "Business Applications need to know when an attempt to send a command to device is feasible, e.g. because the device is then known to be connected to a protocol adapter. Devices and Protocol Adapters can indicate to Business Applications a device\u0026rsquo;s intent to e.g. receive commands using specific notifications.\nTime until Disconnect Notification Devices and Protocol Adapters can notify an application about the fact that a device is connected and ready to receive one or more commands by means of including a time \u0026lsquo;til disconnect (ttd) property in telemetry or event messages.\nThe ttd property value indicates the time that the device will stay connected to the protocol adapter. Using this value together with the creation-time of the message, an application can determine whether an attempt to send a command to the device has a reasonable chance of succeeding. The ttd property can be included in any regular telemetry or event message. However, if a device does not have any telemetry data or event to upload to the adapter, it can also use an empty notification instead.\nHono includes utility classes that application developers can use to register a callback to be notified when a device sends a ttd notification. See Hono\u0026rsquo;s example module for details where such a notification callback is used. Please refer to the Telemetry API and the Event API for further details.\nThe following table defines the possible values of the ttd property and their semantics:\n   TTD Description     \u0026gt; 0 The value indicates the number of seconds that the device will stay connected. Devices using a stateless protocol like HTTP will be able to receive a single command only before disconnecting.   -1 The device is now connected (i.e. available to receive upstream messages) until further notice.   0 The device is now disconnected (i.e. not available anymore to receive upstream messages).    Determining a Device\u0026rsquo;s Connection Status An application receiving a downstream message containing a ttd property can check if the device is currently connected (and thus ready to receive a command) by\n adding the ttd value to the creation-time to determine the expiration time, and then comparing the current time with the expiration time  If the current time is after the expiration time, the device should be assumed to already have disconnected again.\nSource of the ttd Value While it seems to be natural that a device itself indicates when it is ready to receive a command, it may not always be possible or desirable to do so. A device could e.g. be not capable to specify the value for ttd in it\u0026rsquo;s message, or all devices of a particular setup would always use the same value for ttd, so it would not make much sense to provide this value always again. Additionally different protocols may or may not let a sender set specific values for a message, so a device using a specific protocol may not be able to provide a value for the ttd property at all. For these reasons there are (resp. may be) additional ways of setting the value of ttd:\n Hono\u0026rsquo;s Tenant and Device Registration APIs support the inclusion of default values for application-properties in the AMQP 1.0 message. By these means a device can be configured to always have a specific value for ttd. In a future extension there may be a configuration value per tenant and protocol adapter that sets the value of ttd if it was not provided by other means already (like provided to the protocol adapter or by setting a default value).   Hono\u0026rsquo;s HTTP protocol adapter Hono\u0026rsquo;s HTTP protocol adapter supports the setting of the ttd value in requests explicitly - please refer to the HTTP Adapter for details. Alternatively the default property values for devices from the Device Registry can be used (described above).\nHono\u0026rsquo;s MQTT protocol adapter The MQTT protocol adapter automatically sends a Time until disconnect notification with a ttd value of -1 for a device that subscribes to the appropriate command topic (refer to the MQTT Adapter user guide for details).\nWhen a device unsubscribes again, the adapter automatically sends a Time until disconnect notification with a ttd value of 0.\nExamples The following sequence diagram shows a Time until disconnect notification while sending a telemetry message downstream via the HTTP protocol adapter:\n  Device command readiness with telemetry data   The following sequence diagram shows a Time until disconnect notification by sending an empty event message downstream via the HTTP protocol adapter:\n  Device command readiness with explicit event  "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/concepts/command-and-control/",
+	"title": "Command &amp; Control",
+	"tags": [],
+	"description": "",
+	"content": "Business applications can send commands to devices following the Command \u0026amp; Control API. This concept page describes how this API is used by applications to send commands and describes how Hono\u0026rsquo;s protocol adapters process the commands so that they reach their target device.\nCommands can be sent following a request/response or a one-way pattern. For Request/Response commands, there is always a response expected from the device.\nGeneral concept The following sequence diagram gives an overview of a device indicating its availability for receiving commands, of a business application sending a command to the device and of the device sending back a command response.\nThe application and the adapter connect to the AMQP Network, which forwards the transfer - for clarity this is not shown in the diagram below.\n  Request/Response Command overview   In (1) the device subscribes for commands (if connecting to the AMQP or MQTT adapter) or indicates that it will stay connected for a given amount of time to receive a command (if connecting to the HTTP adapter), using the ttd (\u0026ldquo;time till disconnect\u0026rdquo;) parameter.\nThe protocol adapter will then create the necessary AMQP consumer link with the AMQP messaging network if it doesn\u0026rsquo;t exist already (for more details see below) and will send a notification to the application that the device is ready to receive commands (2).\nAfter having created a sender link on the command/TENANT address, the application can then send commands, with the target device given in the AMQP message to address command/TENANT/4711 (3). If a command response is expected, the command response address command_response/TENANT/${replyId} (with replyId being an arbitrary identifier chosen by the application) is to be set as reply-to property in the command message and a corresponding receiver link is to be opened by the application. For one-way commands, both is to be omitted.\nAfter receiving the command, the protocol adapter instance will forward the command to the device (4) and send a disposition update back to the application (5).\nIn case of a Request/Response command, the device can then send a command response (6) that will be forwarded by the protocol adapter back to the application (7).\nCommand \u0026amp; Control involving a gateway Hono has special support for sending commands to devices that are connected via a gateway to Hono. Such devices are configured in the Hono device registration service in such a way, that certain gateways may act on behalf of the device.\nWhen sending commands, the northbound applications do not have to know to which gateway the command target device is connected to. The application sends the command with the device address and Hono will direct the command to a gateway that has subscribed for such commands and that is configured to act on behalf of the command target device. If there are multiple matching gateways, the one that the command target device was last connected to is chosen. The information about which gateways are subscribed and which gateway a device has last communicated by is managed via the device connection service.\nCommand consumer links in the protocol adapter The protocol adapter opens 2 kinds of consumer links to receive commands.\n A tenant-scoped link on the address command/${tenant}.\nThis is the link address used by applications to send commands. Upon receiving a command message on this link, the protocol adapter checks whether the command target device id needs to be mapped to a gateway. Furthermore it is checked to which particular protocol adapter instance the target device (or mapped gateway) is actually connected. Since this kind of link is opened from all protocol adapter instances receiving commands for the tenant, a command message is first received by any one of these protocol adapter instances. Therefore, if necessary, the command will be delegated to the adapter instance that is connected to the target device or to the gateway receiving commands for the device. That is done by forwarding the command to the AMQP messaging network on a link with the address command_internal/${adapterInstanceId} (see below).\n A link per protocol adapter instance on the address command_internal/${adapterInstanceId}.\nOn this link, commands will be received that have been forwarded from another protocol adapter instance. This link address is only used for communication between protocol adapter instances, so attaching to this link address should not be enabled for applications.\n  Example with multiple adapters involved The following diagrams show the message flow if the command message is first received on a protocol adapter instance that the target device is not connected to.\n  Command subscription   In the scenario here there is a protocol adapter instance #2 through which a command subscription for the example tenant was already made (0).\nThe device subscribes for commands (1) and the protocol adapter creates the receiver link (2) on the tenant-scoped link. The protocol adapter then updates the command-handling protocol adapter instance for device information (3), assigning the device 4711 to adapter instance id #1. Following that, the notification about the device subscription is sent to the application via the AMQP messaging network (4).\n  Command handling   Upon receiving the notification, the application prepares sender and command response receiver links (1,2) and sends the command message to the AMQP messaging network. Here it is received by protocol adapter instance #2. The protocol adapter then queries the command-handling protocol adapter instances information for the device id of the command message (4). In this case here, the protocol adapter instance #1 is returned (5). The command then gets forwarded to the AMQP messaging network on the address for adapter instance #1 (6). The protocol adapter instance #1 will receive the message (7) and forward it to the device (8). As the last step, an \u0026ldquo;accepted\u0026rdquo; disposition will be sent back to the application (9).\n  Command response handling   The command response message is sent back to the application from the protocol adapter via the AMQP messaging network.\nGateway subscriptions Gateway subscribing for commands for a particular device The following sequence diagrams show the different steps involved in having a gateway subscribe for commands of a particular device.\n  Command subscription   The gateway \u0026ldquo;gw-1\u0026rdquo; is connected to a protocol adapter and subscribes to commands for a device 4711 (1). This device has to be configured so that the gateway may act on its behalf (see Configuring Gateway Devices for details).\nThe protocol adapter creates the tenant-scoped consumer link on the command/TENANT address (if it doesn\u0026rsquo;t already exist) (2) and then updates the command-handling protocol adapter instance for device information (3), assigning the device 4711 to adapter instance id #1.\nJust like it is done when a protocol adapter handles any kind of message from a gateway acting on behalf of a device, the protocol adapter updates the last-known gateway information here, sending a request to the device connection service (4). The notification event is then sent containing the device id 4711 (5)\n  Command handling   After the application has prepared the sender and consumer links (1,2), it sends the command message on the command/TENANT link with the AMQP message to property set to command/TENANT/4711 and reply-to set to the address of the command response consumer link (command_response/TENANT/${replyId} with replyId being an arbitrary identifier chosen by the application) (3). After receiving the command message, the protocol adapter determines the command-handling protocol adapter instances information for the device id of the command message (4). In this case here, the protocol adapter instance #1 is returned (5), meaning that the command is already at the right adapter instance. As the subscription for commands to device 4711 was done by gateway \u0026ldquo;gw-1\u0026rdquo;, the command gets forwarded to that gateway (6). It is then the responsibility of the gateway to forward the command to the device 4711. After the gateway has acknowledged the command message, an \u0026ldquo;accepted\u0026rdquo; disposition will be sent back to the application (7).\n  Command response handling   When the device sends a command response via the gateway (1), the protocol adapter forwards the command message on the command_response/TENANT/${replyId} link to the application (2).\nGateway subscribing for commands for all its devices A gateway may also subscribe for commands sent to all the different devices that the gateway acts on behalf of. Such a scenario is shown in the following sequence diagram.\n  Command subscription   The gateway subscribes for commands just like a normal device would, only using its id gw-1 (1). The protocol adapter creates the tenant-scoped consumer link on the command/TENANT address (if it doesn\u0026rsquo;t already exist) (2) and then updates the command-handling protocol adapter instance for device information (3), assigning the device \u0026lsquo;gw-1\u0026rsquo; to adapter instance id #1. The subscription notification sent to the application contains the gateway id gw-1. That means that either the application has to know about the gateway, or that it just assumes that the devices it sends commands to (and that are connected to the gateway) are always available for receiving commands. This may especially be the case for long-lasting command subscriptions (with the MQTT or AMQP adapter).\n  Command handling   After the application has prepared the sender and consumer links (1,2), it sends the command message on the command/TENANT link with the AMQP message to property set to command/TENANT/4711 and reply-to set to the address of the command response consumer link (command_response/TENANT/${replyId} with replyId being an arbitrary identifier chosen by the application) (3). After receiving the command message, the protocol adapter determines the command-handling protocol adapter instances information for the device id of the command message (4).\nIn the example above, there is no adapter instance associated with the device 4711. Therefore it is checked whether there are adapter instances handling commands for the gateways, configured to possibly act on behalf of the device. If there is an adapter instance associated with the last known gateway of the device, that instance is returned as the result. Otherwise, and in the example above, the command handling adapter instance for any of these gateways is returned (the choice being random if there are multiple instances). In the above example that is the instance #1 associated with gateway gw-1 (5).\nThen the command gets forwarded to that gateway (6). It is the responsibility of the gateway to forward the command to the device 4711. After the gateway has acknowledged the command message, an \u0026ldquo;accepted\u0026rdquo; disposition will be sent back to the application (7).\nHandling of the command response is done in the same way as shown in the chapter above for a gateway subscribing for a particular device and is therefore omitted here.\nIf a gateway has already subscribed for commands for all its device, it may still subscribe for commands for a particular device (and the other way around). The particular device subscription has precedence then in choosing over which subscription protocol/channel to send the command to the gateway.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/concepts/resource-limits/",
+	"title": "Resource limits",
+	"tags": [],
+	"description": "",
+	"content": " Resource limits such as the maximum number of device connections allowed per tenant or the allowed data volume of the messages over a period of time per tenant can be set in Hono.\nHono specifies an API ResourceLimitChecks that is used by the protocol adapters for the verification of the configured resource limits. A default implementation of this API is shipped with Hono. This default implementation uses the live metrics data retrieved from a Prometheus server to verify the resource-limits, if configured. To enable and use this default implementation, please refer to the protocol adapter admin guides. Based on the requirements, a custom version of the above API can be implemented and used. The resource-limits for a tenant can be set using the tenant configuration. Please refer to the Tenant API for more details.\nConnections Limit Before accepting a new connection request from a device, the number of existing connections is checked against the configured limit by the protocol adapters. The connection request is declined if the limit is exceeded.\nThe MQTT and AMQP protocol adapters keep the connections longer opened than their counterparts such as HTTP. Thereby the MQTT and AMQP adapters are enabled to check the connection limits before accepting any new connection to a device.\nConnection Duration Limit Before accepting a new connection request from a device, the overall amount of time that the devices have already been connected to protocol adapters for that tenant is checked against the configured limit by the protocol adapters. The connection request is declined if the connection duration limit has been already reached. This limit is only supported by protocol adapters that maintain connection state with authenticated devices. In particular, the HTTP adapter does not support this metric.\nThe default Prometheus based implementation uses connection duration as the factor to limit the connections. This default implementation supports two modes of connection duration limit calculation namely days and monthly. For more details on how to set the mode refer to the Tenant API. If the period is not set explicitly, then the mode is assumed as monthly in the default implementation.\nIn the monthly mode, further device connections are only allowed, if the overall amount of time that the devices have already been connected from the beginning till the end of the current (Gregorian) calendar month does not exceed the configured max-minutes value. But for the first month, on which the connection duration limit became effective, the effective connection duration limit is calculated based on the max-minutes with respect to the remaining days in that month from the effective-since date.\nBelow is a sample resource limit configuration for a tenant, where it has been defined that the connection duration limit became effective on 10.Jul.2019 and the maximum connection duration limit for every month is 50,000 minutes. It means that from August 2019, the connection limit check ensures that no more connections are allowed for that tenant, if that limit of 50,000 minutes is already reached. But in case of July 2019, the month on which the message limit became effective, the effective connection duration limit is calculated by finding the average limit for a day from the configured max-minutes and then multiplying it with the number of days from the effective-since date till the end of that month. In this case it is calculated as (50,000 minutes / 31 days) x 22 days, which is 35,483 minutes. It means that for the month of July 2019, no more new connections are allowed, if the limit of 35,843 minutes is already reached.\n\u0026quot;resource-limits\u0026quot;: { \u0026quot;connection-duration\u0026quot;: { \u0026quot;effective-since\u0026quot;: \u0026quot;2019-07-10T14:30:00Z\u0026quot;, \u0026quot;max-minutes\u0026quot;: 50000, \u0026quot;period\u0026quot;: { \u0026quot;mode\u0026quot;: \u0026quot;monthly\u0026quot; } } }  In the days mode, further device connections are only allowed, if the overall amount of time that the devices have already been connected for the configured no-of-days does not exceed the max-minutes value. In the below sample configuration, the mode is configured as days and the accounting duration as 30 days. In this case the connection duration limit check ensures that new connections are accepted, only if the connection duration usage for every 30 days from 10.Jul.2019 (effective-since) does not exceed the 50,000 minutes limit.\n\u0026quot;resource-limits\u0026quot;: { \u0026quot;connection-duration\u0026quot;: { \u0026quot;effective-since\u0026quot;: \u0026quot;2019-07-10T14:30:00Z\u0026quot;, \u0026quot;max-minutes\u0026quot;: 50000, \u0026quot;period\u0026quot;: { \u0026quot;mode\u0026quot;: \u0026quot;days\u0026quot;, \u0026quot;no-of-days\u0026quot;: 30 } } }  Messages Limit Hono supports limiting the number of messages that devices and north bound applications of a tenant can publish to Hono during a given time interval. Before accepting any telemetry or event or command messages from devices or north bound applications, it is checked by the protocol adapters that if the message limit is exceeded or not. The incoming message is discarded if the limit is exceeded.\nThe default Prometheus based implementation uses data volume as the factor to limit the messages. The data volume already consumed by a tenant over the given time interval is compared with the configured message limit before accepting any messages. The default implementation supports two modes of message limits calculation namely days and monthly. For more details on how to set the mode refer to the Tenant API. If the period is not set explicitly, then the mode is assumed as monthly in the default implementation.\nIn the monthly mode, the message limit check ensures that the data usage from the beginning till the end of a (Gregorian) calendar month does not exceed the max-bytes value. But for the first month on which the message limit became effective, the effective max-bytes are calculated based on the max-bytes with respect to the remaining days in that month from the effective-since date.\nBelow is a sample resource limit configuration for a tenant and it has been defined that the message limit became effective on 10.Jul.2019 and the maximum bytes allowed for a month is 2 GB. It means that from August 2019, the message limit check ensures that the data usage in a month does not exceed 2 GB. But in case of July 2019, the month on which the message limit became effective, the effective max-bytes is calculated by finding the average limit for a day from the max-bytes and multiplying it with the number of days from the effective-since date till the end of that month. In this case it is calculated as (2 GB / 31 days) x 22 days which is 1.4 GB. It means that for the month of July 2019, the data usage should not exceed 1.4GB.\n\u0026quot;resource-limits\u0026quot;: { \u0026quot;data-volume\u0026quot;: { \u0026quot;effective-since\u0026quot;: \u0026quot;2019-07-10T14:30:00Z\u0026quot;, \u0026quot;max-bytes\u0026quot;: 2147483648, \u0026quot;period\u0026quot;: { \u0026quot;mode\u0026quot;: \u0026quot;monthly\u0026quot; } } }  In the days mode, the message limit check ensures that the data usage for the defined no-of-days does not exceed the max-bytes value. In the below sample configuration, the mode is configured as days and the accounting duration as 30 days. In this case the message limit check ensures that the data usage for every 30 days from 10.Jul.2019 (effective-since) does not exceed the 2GB limit.\n\u0026quot;resource-limits\u0026quot;: { \u0026quot;data-volume\u0026quot;: { \u0026quot;effective-since\u0026quot;: \u0026quot;2019-07-10T14:30:00Z\u0026quot;, \u0026quot;max-bytes\u0026quot;: 2147483648, \u0026quot;period\u0026quot;: { \u0026quot;mode\u0026quot;: \u0026quot;days\u0026quot;, \u0026quot;no-of-days\u0026quot;: 30 } } }  "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/concepts/connection-events/",
+	"title": "Connection Events",
+	"tags": [],
+	"description": "",
+	"content": "Hono\u0026rsquo;s protocol adapters can use connection events to indicate the connection status of a device. In particular, an adapter can notify downstream components about a newly established connection with a device or about a device having disconnected. The connection status of devices using stateful protocols like MQTT and AMQP can usually be determined quite easily because these protocols often require peers to explicitly open or close a connection and often also support a kind of heart beat which can be used to determine if a connection is still alive. However, for stateless protocols like HTTP or CoAP, there is no clear definition of what it actually means that a device is connected. It is obvious that a device is connected when it is sending an HTTP request. However, the adapter has no way of knowing if the device has gone to sleep after it has received the adapter\u0026rsquo;s response to its request.\nThat said, connection events indicating an established connection with a device can usually be taken as face value. However, connection events indicating the disconnection of a device may only represent the protocol adapters view of the device\u0026rsquo;s connection status. For example, the HTTP adapter might consider a device disconnected because it hasn\u0026rsquo;t received any requests from the device for some time. However, the device itself might as well be up and running (i.e. not sleeping) and simply have no data worth publishing.\nThe mechanism of firing connection events is pluggable with the default implementation simply forwarding connection status information to the logging framework. Hono also comes with an alternative implementation which forwards connection status information by means of Connection Events via the Events API.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/user-guide/",
+	"title": "User Guide",
+	"tags": [],
+	"description": "",
+	"content": " User Guide Learn how Eclipse Hono\u0026trade; enables you to quickly send data from devices to business applications and vice versa.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/user-guide/device-registry/",
+	"title": "Device Registry",
+	"tags": [],
+	"description": "",
+	"content": "The Device Registry component provides exemplary implementations of Hono\u0026rsquo;s Tenant API, Device Registration API and Credentials API.\nAs such it exposes AMQP 1.0 based endpoints for retrieving the relevant information and persists data in the local filesystem.\nIn addition, the Device Registry also exposes HTTP resources for managing the contents of the registry according to the Device Registry HTTP API.\n Warning The Device Registry is not intended to be used in production environments. In particular, access to the HTTP resources described below is not restricted to authorized clients only.\nThe resources have been designed to provide convenient access to the registry\u0026rsquo;s content using command line tools like curl or HTTPie.\n  Managing Tenants The following sections describe the resources representing the operations of the Tenant API and how they can be used to manage tenants. Please refer to the Device Registry HTTP API for the specific elements that are explained in detail there.\nAdd a Tenant  URI: /v1/tenants/${tenantId} Method: POST Request Headers:  (required) Content-Type: application/json (no other type supported)  Request Body:  (Optional) A JSON object as specified by Tenant schema of the HTTP API specification.  Status Codes:  201 (Created): Tenant has been added successfully under the resource indicated by Location header. 400 (Bad Request): The tenant has not been created because the request was malformed, e .g. because the payload was malformed. The response body may contain hints regarding the cause of the problem. 409 (Conflict): A tenant with the given tenantId already exists. The request has not been processed.  Response Headers:  Location: The URI under which the newly created resource can be accessed. ETag: Version of the resource   Example\nThe following commands add some tenants with different adapter configurations:\nAdd a tenant that has all adapters set to enabled:\ncurl -i -X POST http://localhost:28080/v1/tenants/tenantAllAdapters HTTP/1.1 201 Created ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4 Location: /v1/tenants/tenantAllAdapters Content-Type: application/json; charset=utf-8 {\u0026quot;id\u0026quot;: \u0026quot;tenantAllAdapters\u0026quot;}  Add a tenant that can only use the MQTT adapter:\ncurl -i -X POST -H 'Content-Type: application/json' --data-binary '{ \u0026quot;adapters\u0026quot;: [ { \u0026quot;type\u0026quot;: \u0026quot;hono-mqtt\u0026quot;, \u0026quot;enabled\u0026quot;: true } ] }' http://localhost:28080/v1/tenants/tenantMqttAdapter HTTP/1.1 201 Created ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4 Location: /v1/tenants/tenantMqttAdapter Content-Type: application/json; charset=utf-8 {\u0026quot;id\u0026quot;: \u0026quot;tenantMqttAdapter\u0026quot;}  Get configuration details of a Tenant  URI: /v1/tenants/${tenantId} Method: GET Status Codes:  200 (OK): A tenant with the given identifier has been found. The response body contains the tenant data as specified by Tenant schema of the HTTP API specification. 404 (Not Found): No tenant with the given identifier is registered.   Example\nThe following command retrieves the details for the tenant tenantMqttAdapter:\ncurl -i http://localhost:28080/v1/tenants/tenantMqttAdapter HTTP/1.1 200 OK ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4 Content-Type: application/json; charset=utf-8 { \u0026quot;enabled\u0026quot;: true, \u0026quot;adapters\u0026quot;: [ { \u0026quot;type\u0026quot;: \u0026quot;hono-mqtt\u0026quot;, \u0026quot;enabled\u0026quot;: true } ] }  NB A tenant can be created without specifying a tenant identifier. The device registry will generate a tenant ID:\ncurl -i -X POST http://localhost:28080/v1/tenants/ HTTP/1.1 201 Created Etag: edc93899-7838-4dd1-93c8-839748c2fa42 location: /v1/tenants/0b2df55f-1a02-43f7-a1c0-f3dbd25041e0 content-type: application/json; charset=utf-8 content-length: 45 {\u0026quot;id\u0026quot;:\u0026quot;0b2df55f-1a02-43f7-a1c0-f3dbd25041e0\u0026quot;}  Update Tenant  URI: /v1/tenants/${tenantId} Method: PUT Request Headers:  (required) Content-Type: application/json (no other type supported)  Request Body:  (required) A JSON object as specified by Tenant schema of the HTTP API specification.  Status Codes:  204 (No Content): The tenant has been updated successfully. 400 (Bad Request): The tenant has not been updated because the request was malformed, e .g. because the payload was malformed. The response body may contain hints regarding the cause of the problem. 404 (Not Found): The request could not be processed because no tenant with the given identifier exists.   This resource can be used to change the configuration of a particular tenant.\nExample\nThe following command disables the MQTT adapter for devices that belong to the tenant tenantMqttAdapter:\ncurl -i -X PUT -H 'Content-Type: application/json' --data-binary '{ \u0026quot;adapters\u0026quot;: [ { \u0026quot;type\u0026quot;: \u0026quot;hono-mqtt\u0026quot;, \u0026quot;enabled\u0026quot;: true } ] }' http://localhost:28080/v1/tenants/tenantMqttAdapter HTTP/1.1 204 No Content ETag: 8919c736-30aa-40ce-a45a-830b90c4cd42 Content-Length: 0  Delete Tenant  URI: /v1/tenants/${tenantId} Method: DELETE Status Codes:  204 (No Content): The tenant with the given identifier has been deleted. 404 (Not Found): The request could not be processed because no tenant with the given identifier exists.   Example\ncurl -i -X DELETE http://localhost:28080/v1/tenants/tenantMqttAdapter HTTP/1.1 204 No Content Content-Length: 0  Managing Device Registration Information The following sections describe the resources representing the operations of the Device Registration API and how they can be used to manage device registration information. Please refer to the Device Registry HTTP API for the specific elements that are explained in detail there.\nRegister Device  URI: /v1/devices/${tenantId}/${deviceId} Method: POST Headers:  (required) Content-Type: application/json  Request Body:  (Optional) A JSON object as specified by Device schema of the HTTP API specification.  Status Codes:  201 (Created): Device has been registered successfully under resource indicated by Location header. 400 (Bad Request): Device has not been registered because the request was malformed, e .g. a required header is missing (the body may contain hints regarding the problem). 409 (Conflict): There already exists a device with the given ID. The request has not been processed.   Example\nThe following command registers a device with ID 4711 for tenant DEFAULT_TENANT\ncurl -i -X POST -H 'Content-Type: application/json' --data-binary '{ \u0026quot;ext\u0026quot;: { \u0026quot;ep\u0026quot;: \u0026quot;IMEI4711\u0026quot; } }' http://localhost:28080/v1/devices/DEFAULT_TENANT/4711  The response will contain a Location header containing the resource path created for the device. In this example it will look like this:\nHTTP/1.1 201 Created Location: /v1/devices/DEFAULT_TENANT/4711 ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4 Content-Type: application/json; charset=utf-8 {\u0026quot;id\u0026quot;: \u0026quot;4711\u0026quot;}  NB A device can be created without specifying a device identifier. The device registry will generate a device identifier:\ncurl -i -X POST http://localhost:28080/v1/devices/DEFAULT_TENANT HTTP/1.1 201 Created Etag: 0d615bcd-0825-44d9-9ef5-54a7b12165d8 location: /v1/devices/DEFAULT_TENANT/98d25103-d49d-44b0-bdd0-0de84743c522 content-type: application/json; charset=utf-8 content-length: 45 {\u0026quot;id\u0026quot;:\u0026quot;98d25103-d49d-44b0-bdd0-0de84743c522\u0026quot;}  Read Device  URI: /v1/devices/${tenantId}/${deviceId} Method: GET Status Codes:  200 (OK): A device with the given identifier has been found. The response body contains the registration information as specified by Device schema of the HTTP API specification. 404 (Not Found): No device with the given identifier is registered for the given tenant.   Example\nThe following command retrieves registration data for device 4711:\ncurl -i http://localhost:28080/v1/devices/DEFAULT_TENANT/4711 HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { \u0026quot;enabled\u0026quot;: true, \u0026quot;ext\u0026quot;: { \u0026quot;ep\u0026quot;: \u0026quot;IMEI4711\u0026quot; } }  Update Device  URI: /devices/v1/${tenantId}/${deviceId} Method: PUT Headers:  (required) Content-Type: application/json  Parameters (encoded as a JSON object in the request body): Request Body:  (required) A JSON object as specified by Device schema of the HTTP API specification. All existing registration information will be replaced by the data provided in the object.  Status Codes:  204 (No Content): Device registration data has been updated. 400 (Bad Request): Device registration has not been updated because the request was malformed, e .g. a required header is missing (the body may contain hints regarding the problem). 404 (Not Found): No device with the given identifier is registered for the given tenant.   Example\ncurl -i -X PUT -H 'Content-Type: application/json' --data-binary '{ \u0026quot;ext\u0026quot;: { \u0026quot;ep\u0026quot;: \u0026quot;IMEI4711\u0026quot;, \u0026quot;psk-id\u0026quot;: \u0026quot;psk4711\u0026quot; } }' http://localhost:28080/v1/devices/DEFAULT_TENANT/4711 HTTP/1.1 204 No Content Content-Length: 0  Delete Device  URI: /v1/devices/${tenantId}/${deviceId} Method: DELETE Status Codes:  204 (No Content): Device registration has been deleted. 404 (Not Found): No device with the given identifier is registered for the given tenant.   Example\ncurl -i -X DELETE http://localhost:28080/v1/devices/DEFAULT_TENANT/4711 HTTP/1.1 204 No Content Content-Length: 0  Managing Credentials The following sections describe the resources representing the operations of the Credentials API and how they can be used to manage credentials for devices. Please refer to the Device Registry HTTP API for the specific elements that are explained in detail there.\nUpdate Credentials for a Device  URI: /v1/credentials/${tenantId}/${deviceId} Method: PUT Request Headers:  (required) Content-Type: application/json (no other type supported)  Request Body:  (required) A JSON object as specified by Credentials schema of the HTTP API specification.  Status Codes:  204 (No Content): Credentials have been updated successfully. 400 (Bad Request): The credentials have not been added because the request was malformed, e .g. because the payload did not contain required values. The response body may contain hints regarding the cause of the problem.  Response Headers:  ETag: Version of the resource   Example\nThe following command adds some hashed-password credentials from a given plain text password for device 4710 using authentication identifier sensor10:\ncurl -i -X PUT -H 'Content-Type: application/json' --data-binary '[{ \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor10\u0026quot;, \u0026quot;secrets\u0026quot;: [{ \u0026quot;pwd-plain\u0026quot;: \u0026quot;mylittlesecret\u0026quot; }] }]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4710 HTTP/1.1 204 No Content ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4x  This uses a convenient option which lets the Device Registry do the hashing of the password. The following command retrieves the credentials that are stored by the Device Registry as a result of the command above:\ncurl -i http://localhost:28080/v1/credentials/DEFAULT_TENANT/4710 HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4x [{ \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor10\u0026quot;, \u0026quot;enabled\u0026quot;: true, \u0026quot;secrets\u0026quot;: [ { \u0026quot;id\u0026quot;: \u0026quot;349556ea-4902-47c7-beb0-1009ab693fb4\u0026quot; } ] }]  The above result does not contain pwd_hash and hash_function of the secret, as these values are confidential.\nThe following commands set some hashed-password credentials for device 4720 using authentication identifier sensor20:\ncurl -i -X PUT -H 'Content-Type: application/json' --data-binary '[{ \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor20\u0026quot;, \u0026quot;secrets\u0026quot;: [{ \u0026quot;pwd-plain\u0026quot;: \u0026quot;mylittlesecret\u0026quot; }] }]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720 HTTP/1.1 204 No Content ETag: 02c99fb5-af8c-409f-8520-b405e224b27f  The following command adds an expiration date to the hashed-password credentials for authentication identifier sensor20:\ncurl -i -X PUT -H 'Content-Type: application/json' --data-binary '{ \u0026quot;device-id\u0026quot;: \u0026quot;4720\u0026quot;, \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor20\u0026quot;, \u0026quot;secrets\u0026quot;: [{ \u0026quot;pwd-plain\u0026quot;: \u0026quot;mylittlesecret\u0026quot;, \u0026quot;not-after\u0026quot;: \u0026quot;2018-01-01T00:00:00+01:00\u0026quot; }] }' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720 HTTP/1.1 204 No Content ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4x  Multiple credentials of different type can be registered for the same authentication identifier. The following commands add psk credentials for the same device 4720 using authentication identifier sensor20:\nSHARED_KEY=$(echo -n \u0026quot;TheSharedKey\u0026quot; | base64 -w 0) curl -i -X PUT -H 'Content-Type: application/json' --data-binary '[ { \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor20\u0026quot;, \u0026quot;secrets\u0026quot;: [{ \u0026quot;pwd-plain\u0026quot;: \u0026quot;mylittlesecret\u0026quot; }] }, { \u0026quot;device-id\u0026quot;: \u0026quot;4720\u0026quot;, \u0026quot;type\u0026quot;: \u0026quot;psk\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor20\u0026quot;, \u0026quot;secrets\u0026quot;: [{ \u0026quot;key\u0026quot;: \u0026quot;'$SHARED_KEY'\u0026quot; }] }]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720 HTTP/1.1 204 No Content ETag: 122c971a-505a-4336-8f7d-640360e909bc  The following command deletes all credentials for device 4710:\ncurl -i -X PUT -H 'Content-Type: application/json' --data-binary '[]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4710 HTTP/1.1 204 No Content ETag: d383ba4d-1853-4d03-b322-b7ff5af05ae2  Get all Credentials for a Device  URI: /v1/credentials/${tenantId}/${deviceId} Method: GET Status Codes:  200 (OK): Credentials for the device have been found, body contains the credentials. The response body contains the registration information as specified by Credentials schema of the HTTP API specification. 404 (Not Found): No credentials for the device are registered.   Example\nThe following command retrieves credentials metadata for device 4720:\ncurl -i http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720 HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 ETag: f3449b77-2c84-4b09-8d04-2b305876e0cb {[ { \u0026quot;auth-id\u0026quot;: \u0026quot;sensor20\u0026quot;, \u0026quot;enabled\u0026quot;: true, \u0026quot;secrets\u0026quot;: [ { \u0026quot;id\u0026quot;: \u0026quot;d383ba4d-1853-4d03-b322-b7ff5af05ae2\u0026quot; \u0026quot;not-after\u0026quot;: \u0026quot;2020-02-1T00:00:00+01:00\u0026quot; }, { \u0026quot;id\u0026quot;: \u0026quot;46810d5c-133e-4c1c-994d-ed7745516b8e\u0026quot; \u0026quot;not-before\u0026quot;: \u0026quot;2020-01-01T00:00:00+01:00\u0026quot; } ], \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot; }, { \u0026quot;auth-id\u0026quot;: \u0026quot;sensor20\u0026quot;, \u0026quot;enabled\u0026quot;: true, \u0026quot;secrets\u0026quot;: [ { \u0026quot;key\u0026quot;: \u0026quot;VGhlU2hhcmVkS2V5\u0026quot; } ], \u0026quot;type\u0026quot;: \u0026quot;psk\u0026quot; } ]} "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/user-guide/http-adapter/",
+	"title": "HTTP Adapter",
+	"tags": [],
+	"description": "",
+	"content": "The HTTP protocol adapter exposes HTTP based endpoints for Eclipse Hono\u0026trade;\u0026rsquo;s south bound Telemetry, Event and Command \u0026amp; Control APIs.\nDevice Authentication The HTTP adapter by default requires clients (devices or gateway components) to authenticate during connection establishment. The adapter supports both the Basic HTTP authentication scheme as well as client certificate based authentication as part of a TLS handshake for that purpose.\nThe adapter tries to authenticate the device using these mechanisms in the following order\nClient Certificate When a device uses a client certificate for authentication during the TLS handshake, the adapter tries to determine the tenant that the device belongs to, based on the issuer DN contained in the certificate. In order for the lookup to succeed, the tenant\u0026rsquo;s trust anchor needs to be configured by means of registering the trusted certificate authority. The device\u0026rsquo;s client certificate will then be validated using the registered trust anchor, thus implicitly establishing the tenant that the device belongs to. In a second step, the adapter then uses the Credentials API\u0026rsquo;s get operation with the client certificate\u0026rsquo;s subject DN as the auth-id and x509-cert as the type of secret as query parameters.\nNB The HTTP adapter needs to be configured for TLS in order to support this mechanism.\nHTTP Basic Auth The username provided in the header must have the form auth-id@tenant, e.g. sensor1@DEFAULT_TENANT. The adapter verifies the credentials provided by the client against the credentials that the configured Credentials service has on record for the client. The adapter uses the Credentials API\u0026rsquo;s get operation to retrieve the credentials on record with the tenant and auth-id provided by the device in the username and hashed-password as the type of secret as query parameters.\nThe examples below refer to devices 4711 and gw-1 of tenant DEFAULT_TENANT using auth-ids sensor1 and gw1 and corresponding passwords. The example deployment as described in the Deployment Guides comes pre-configured with the corresponding entities in its device registry component. Please refer to the Credentials API for details regarding the different types of secrets.\nNB There is a subtle difference between the device identifier (device-id) and the auth-id a device uses for authentication. See Device Identity for a discussion of the concepts.\nMessage Limits Before accepting any telemetry or event or command messages, the HTTP adapter verifies that the configured message limit is not exceeded. If the limit is exceeded then the incoming message is discarded with the status code 429 Too Many Requests.\nPublish Telemetry Data (authenticated Device)  URI: /telemetry Method: POST Request Headers:  (optional) authorization: The device\u0026rsquo;s auth-id and plain text password encoded according to the Basic HTTP authentication scheme. If not set, the adapter expects the device to present a client certificate as part of the TLS handshake during connection establishment. (required) content-type: The type of payload contained in the request body. (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) qos-level: The QoS level for publishing telemetry messages. The adapter supports at most once (0) and at least once (1) QoS levels. The default value of 0 is assumed if this header is omitted.  Request Body:  (required) Arbitrary payload encoded according to the given content type.  Response Headers:  (optional) content-type: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data. (optional) hono-command: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-req-id: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-target-device: The id of the device that shall execute the command. This header will only be present if the response contains a command to be executed by the device and if the response goes to a gateway that acts on behalf of the target device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200. (optional) Error details, if status code is \u0026gt;= 400.  Status Codes:  200 (OK): The telemetry data has been accepted for processing. The response contains a command for the device to execute. 202 (Accepted): The telemetry data has been accepted for processing. Note that if the qos-level request header is omitted (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer. However, if the QoS level header is set to 1 (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 400 (Bad Request): The request cannot be processed. Possible reasons for this include:  The content type header is missing. The request body is empty. The QoS header value is invalid.  401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials. 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This is the preferred way for devices to publish telemetry data. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).\nExamples\nPublish some JSON data for device 4711:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry HTTP/1.1 202 Accepted content-length: 0  Publish some JSON data for device 4711 using at least once QoS:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' -H 'qos-level: 1' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://localhost:8080/telemetry HTTP/1.1 202 Accepted content-length: 0  Publish some JSON data for device 4711, indicating that the device will wait for 10 seconds to receive the response:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' -H 'hono-ttd: 10' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://localhost:8080/telemetry HTTP/1.1 200 OK hono-command: set hono-cmd-req-id: 1010a7249aa5-f742-4376-8458-bbfc88c72d92 content-length: 23 { \u0026quot;brightness\u0026quot;: 87 }  Publish some JSON data for device 4711 using a client certificate for authentication:\n# in base directory of Hono repository: curl -i --cert demo-certs/certs/device-4711-cert.pem --key demo-certs/certs/device-4711-key.pem --cacert demo-certs/certs/trusted-certs.pem -H 'content-type: application/json' --data-binary '{\u0026quot;temp\u0026quot;: 5}' https://localhost:8443/telemetry HTTP/1.1 202 Accepted content-length: 0  NB The example above assumes that the HTTP adapter is configured for TLS and the secure port is used.\nPublish Telemetry Data (unauthenticated Device)  URI: /telemetry/${tenantId}/${deviceId} Method: PUT Request Headers:  (required) content-type: The type of payload contained in the request body. (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) qos-level: The QoS level for publishing telemetry messages. The adapter supports at most once (0) and at least once (1) QoS levels. The default value of 0 is assumed if this header is omitted.  Request Body:  (required) Arbitrary payload encoded according to the given content type.  Response Headers:  (optional) content-type: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data. (optional) hono-command: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-req-id: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200. (optional) Error details, if status code is \u0026gt;= 400.  Status Codes:  200 (OK): The telemetry data has been accepted for processing. The response contains a command for the device to execute. 202 (Accepted): The telemetry data has been accepted for processing. Note that if the qos-level request header is omitted (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer. However, if the QoS level header is set to 1 (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 400 (Bad Request): The request cannot be processed. Possible reasons for this include:  The content type header is missing. The request body is empty. The QoS header value is invalid.  403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_HTTP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711:\ncurl -i -X PUT -H 'content-type: application/json' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry/DEFAULT_TENANT/4711 HTTP/1.1 202 Accepted content-length: 0  Publish some JSON data for device 4711 using at least once QoS:\ncurl -i -X PUT -H 'content-type: application/json' -H 'qos-level: 1' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry/DEFAULT_TENANT/4711 HTTP/1.1 202 Accepted content-length: 0  Publish some JSON data for device 4711, indicating that the device will wait for 10 seconds to receive the response:\ncurl -i -X PUT -H 'content-type: application/json' -H 'hono-ttd: 10' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://localhost:8080/telemetry/DEFAULT_TENANT/4711 HTTP/1.1 200 OK hono-command: set hono-cmd-req-id: 1010a7249aa5-f742-4376-8458-bbfc88c72d92 content-length: 23 { \u0026quot;brightness\u0026quot;: 87 }  Publish Telemetry Data (authenticated Gateway)  URI: /telemetry/${tenantId}/${deviceId} Method: PUT Request Headers:  (optional) authorization: The gateway\u0026rsquo;s auth-id and plain text password encoded according to the Basic HTTP authentication scheme. If not set, the adapter expects the gateway to present a client certificate as part of the TLS handshake during connection establishment. (required) content-type: The type of payload contained in the request body. (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) qos-level: The QoS level for publishing telemetry messages. The adapter supports at most once (0) and at least once (1) QoS levels. The default value of 0 is assumed if this header is omitted.  Request Body:  (required) Arbitrary payload encoded according to the given content type.  Response Headers:  (optional) content-type: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data. (optional) hono-command: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-req-id: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-target-device: The id of the device that shall execute the command. This header will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200. (optional) Error details, if status code is \u0026gt;= 400.  Status Codes:  200 (OK): The telemetry data has been accepted for processing. The response contains a command for the device to execute. 202 (Accepted): The telemetry data has been accepted for processing. Note that if the qos-level request header is omitted (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer. However, if the QoS level header is set to 1 (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 400 (Bad Request): The request cannot be processed. Possible reasons for this include:  The content type header is missing. The request body is empty. The QoS header value is invalid.  401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials. 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The tenant that the gateway belongs to is not allowed to use this protocol adapter. The device belongs to another tenant than the gateway. The gateway is not authorized to act on behalf of the device. The gateway associated with the device is not registered or disabled.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This resource can be used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nPublish some JSON data for device 4712:\ncurl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry/DEFAULT_TENANT/4712 HTTP/1.1 202 Accepted content-length: 0  Publish some JSON data for device 4712 using at least once QoS:\ncurl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' -H 'qos-level: 1' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry/DEFAULT_TENANT/4712 HTTP/1.1 202 Accepted content-length: 0  Publish some JSON data for device 4712, indicating that the gateway will wait for 10 seconds to receive the response:\ncurl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' -H 'hono-ttd: 10' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://localhost:8080/telemetry/DEFAULT_TENANT/4712 HTTP/1.1 200 OK hono-command: set hono-cmd-req-id: 1010a7249aa5-f742-4376-8458-bbfc88c72d92 content-length: 23 { \u0026quot;brightness\u0026quot;: 87 }  NB The example above assumes that a gateway device has been registered with hashed-password credentials with auth-id gw and password gw-secret which is authorized to publish data on behalf of device 4712.\nPublish an Event (authenticated Device)  URI: /event Method: POST Request Headers:  (optional) authorization: The device\u0026rsquo;s auth-id and plain text password encoded according to the Basic HTTP authentication scheme. If not set, the adapter expects the device to present a client certificate as part of the TLS handshake during connection establishment. (required) content-type: The type of payload contained in the request body. (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) hono-ttl: The time-to-live in number of seconds for event messages.\n  Request Body:  (required) Arbitrary payload encoded according to the given content type.  Response Headers:  (optional) content-type: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data. (optional) hono-command: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-req-id: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-target-device: The id of the device that shall execute the command. This header will only be present if the response contains a command to be executed by the device and if the response goes to a gateway that acts on behalf of the target device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200. (optional) Error details, if status code is \u0026gt;= 400.  Status Codes:  200 (OK): The event has been accepted for processing. The response contains a command for the device to execute. 202 (Accepted): The event has been accepted for processing. 400 (Bad Request): The request cannot be processed. Possible reasons for this include:  The content type header is missing. The request body is empty but the event is not of type empty-notification.  401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials. 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed because there is no consumer of events for the given tenant connected to Hono.   This is the preferred way for devices to publish events. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).\nExample\nPublish some JSON data for device 4711:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' --data-binary '{\u0026quot;alarm\u0026quot;: true}' http://127.0.0.1:8080/event HTTP/1.1 202 Accepted content-length: 0  Publish an Event (unauthenticated Device)  URI: /event/${tenantId}/${deviceId} Method: PUT Request Headers:  (required) content-type: The type of payload contained in the request body. (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) hono-ttl: The time-to-live in number of seconds for event messages.  Request Body:  (required) Arbitrary payload encoded according to the given content type.  Response Headers:  (optional) content-type: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data. (optional) hono-command: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-req-id: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200. (optional) Error details, if status code is \u0026gt;= 400.  Status Codes:  200 (OK): The event has been accepted and put to a persistent store for delivery to consumers. The response contains a command for the device to execute. 202 (Accepted): The event has been accepted and put to a persistent store for delivery to consumers. 400 (Bad Request): The request cannot be processed. Possible reasons for this include:  The content type header is missing. The request body is empty but the event is not of type empty-notification.  403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed because there is no consumer of events for the given tenant connected to Hono.   This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_HTTP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711:\ncurl -i -X PUT -H 'content-type: application/json' --data-binary '{\u0026quot;alarm\u0026quot;: true}' http://127.0.0.1:8080/event/DEFAULT_TENANT/4711 HTTP/1.1 202 Accepted content-length: 0  Publish an Event (authenticated Gateway)  URI: /event/${tenantId}/${deviceId} Method: PUT Request Headers:  (optional) authorization: The gateway\u0026rsquo;s auth-id and plain text password encoded according to the Basic HTTP authentication scheme. If not set, the adapter expects the gateway to present a client certificate as part of the TLS handshake during connection establishment. (required) content-type: The type of payload contained in the request body. (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) hono-ttl: The time-to-live in number of seconds for event messages.  Request Body:  (required) Arbitrary payload encoded according to the given content type.  Response Headers:  (optional) content-type: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data. (optional) hono-command: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-req-id: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-target-device: The id of the device that shall execute the command. This header will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200. (optional) Error details, if status code is \u0026gt;= 400.  Status Codes:  200 (OK): The event has been accepted and put to a persistent store for delivery to consumers. The response contains a command for the device to execute. 202 (Accepted): The event has been accepted and put to a persistent store for delivery to consumers. 400 (Bad Request): The request cannot be processed. Possible reasons for this include:  The content type header is missing. The request body is empty but the event is not of type empty-notification.  401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials. 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The tenant that the gateway belongs to is not allowed to use this protocol adapter. The device belongs to another tenant than the gateway. The gateway is not authorized to act on behalf of the device. The gateway associated with the device is not registered or disabled.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed because there is no consumer of events for the given tenant connected to Hono.   This resource can be used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nPublish some JSON data for device 4712:\ncurl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/event/DEFAULT_TENANT/4712 HTTP/1.1 202 Accepted content-length: 0  NB The example above assumes that a gateway device has been registered with hashed-password credentials with auth-id gw and password gw-secret which is authorized to publish data on behalf of device 4712.\nCommand \u0026amp; Control The HTTP adapter enables devices to receive commands that have been sent by business applications. Commands are delivered to the device by means of an HTTP response message. That means a device first has to send a request, indicating how long it will wait for the response. That request can either be a telemetry or event message, with a hono-ttd header or query parameter (ttd for time till disconnect) specifying the number of seconds the device will wait for the response. The business application can react on that message by sending a command message, targeted at the device. The HTTP adapter will then send the command message as part of the HTTP response message with status 200 (OK) to the device. If the HTTP adapter receives no command message in the given time period, a 202 (Accepted) response will be sent to the device (provided the request was valid).\nSpecifying the Time a Device will wait for a Response The adapter lets devices indicate the number of seconds they will wait for a response by setting a header or a query parameter.\nUsing an HTTP Header The (optional) hono-ttd header can be set in requests for publishing telemetry data or events.\nExample:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' -H 'hono-ttd: 60' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry HTTP/1.1 202 Accepted content-length: 0  Using a Query Parameter Alternatively the hono-ttd query parameter can be used:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry?hono-ttd=60 HTTP/1.1 202 Accepted content-length: 0  Commands handled by gateways Authenticated gateways will receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway. Corresponding devices have to be configured so that they can be used with a gateway. See Configuring Gateway Devices for details.\nA gateway can send a request with the hono-ttd header or query parameter on the /event or /telemetry URI, indicating its readiness to receive a command for any device it acts on behalf of. Note that in this case, the business application will be notified with the gateway id in the device_id property of the downstream message.\nAn authenticated gateway can also indicate its readiness to receive a command targeted at a specific device. For that, the /event/${tenantId}/${deviceId} or /telemetry/${tenantId}/${deviceId} URI is to be used, containing the id of the device to receive a command for. The business application will receive a notification with that device id.\nIf there are multiple concurrent requests with a hono-ttd header or query parameter, sent by the command target device and/or one or more of its potential gateways, the HTTP adapter will choose the device or gateway to send the command to as follows:\n A request done by the command target device or by a gateway specifically done for that device, has precedence. If there are multiple, concurrent such requests, the last one will get the command message (if received) in its response. Note that the other requests won\u0026rsquo;t be answered with a command message in their response event if the business application sent multiple command messages. That means commands for a single device can only be requested sequentially, not in parallel. If the above doesn\u0026rsquo;t apply, a single hono-ttd request on the /event or /telemetry URI, sent by a gateway that the command target device is configured for, will get the command message in its response. If there are multiple, concurrent such requests by different gateways, all configured for the command target device, the request by the gateway will be chosen, through which the target device has last sent a telemetry or event message. If the target device hasn\u0026rsquo;t sent a message yet and it is thereby unknown via which gateway the device communicates, then one of the requests will be chosen randomly to set the command in its response.  Sending a Response to a Command (authenticated Device)  URI: /command/res/${commandRequestId} or /command/res/${commandRequestId}?hono-cmd-status=${status} Method: POST Request Headers:  (optional) authorization: The device\u0026rsquo;s auth-id and plain text password encoded according to the Basic HTTP authentication scheme. If not set, the adapter expects the device to present a client certificate as part of the TLS handshake during connection establishment. (optional) content-type: A media type describing the semantics and format of the payload contained in the request body. This header may be set if the result of processing the command on the device is non-empty. In this case the result data is contained in the request body. (optional) hono-cmd-status: The status of the command execution. If not set, the adapter expects that the URI contains it as request parameter at the end.  Request Body:  (optional) Arbitrary data representing the result of processing the command on the device.  Status Codes:  202 (Accepted): The response has been successfully delivered to the application that has sent the command. 400 (Bad Request): The request cannot be processed because the command status is missing. 401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials.\n 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed. Possible reasons for this include:  There is no application listening for a reply to the given commandRequestId. The application has already given up on waiting for a response.    This is the preferred way for devices to respond to commands. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).\nExample\nSend a response to a previously received command with the command-request-id req-id-uuid for device 4711:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' --data-binary '{\u0026quot;brightness-changed\u0026quot;: true}' http://127.0.0.1:8080/command/res/req-id-uuid?hono-cmd-status=200 HTTP/1.1 202 Accepted content-length: 0  Sending a Response to a Command (unauthenticated Device)  URI: /command/res/${tenantId}/${deviceId}/${commandRequestId} or /command/res/${tenantId}/${deviceId}/${commandRequestId}?hono-cmd-status=${status} Method: PUT Request Headers:  (optional) content-type: A media type describing the semantics and format of the payload contained in the request body (the outcome of processing the command). (optional) hono-cmd-status: The status of the command execution. If not set, the adapter expects that the URI contains it as request parameter at the end.  Request Body:  (optional) Arbitrary data representing the result of processing the command on the device.  Status Codes:  202 (Accepted): The response has been successfully delivered to the application that has sent the command. 400 (Bad Request): The request cannot be processed because the command status is missing. 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this might be:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed. Possible reasons for this include:  There is no application listening for a reply to the given commandRequestId. The application has already given up on waiting for a response.    This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_HTTP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nSend a response to a previously received command with the command-request-id req-id-uuid for the unauthenticated device 4711:\ncurl -i -X PUT -H 'content-type: application/json' --data-binary '{\u0026quot;brightness-changed\u0026quot;: true}' http://127.0.0.1:8080/command/res/DEFAULT_TENANT/4711/req-id-uuid?hono-cmd-status=200 HTTP/1.1 202 Accepted content-length: 0  Sending a Response to a Command (authenticated Gateway)  URI: /command/res/${tenantId}/${deviceId}/${commandRequestId} or /command/res/${tenantId}/${deviceId}/${commandRequestId}?hono-cmd-status=${status} Method: PUT Request Headers:  (optional) authorization: The gateway\u0026rsquo;s auth-id and plain text password encoded according to the Basic HTTP authentication scheme. If not set, the adapter expects the gateway to present a client certificate as part of the TLS handshake during connection establishment. (optional) content-type: A media type describing the semantics and format of the payload contained in the request body (the outcome of processing the command). (optional) hono-cmd-status: The status of the command execution. If not set, the adapter expects that the URI contains it as request parameter at the end.  Request Body:  (optional) Arbitrary data representing the result of processing the command on the device.  Status Codes:  202 (Accepted): The response has been successfully delivered to the application that has sent the command. 400 (Bad Request): The request cannot be processed because the command status is missing. 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this might be:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant. The gateway is not authorized to act on behalf of the device. The gateway associated with the device is not registered or disabled.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed. Possible reasons for this include:  There is no application listening for a reply to the given commandRequestId. The application has already given up on waiting for a response.    This resource can be used by gateway components to send the response to a command on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to send responses to a command on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nSend a response to a previously received command with the command-request-id req-id-uuid for device 4712:\ncurl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' --data-binary '{\u0026quot;brightness-changed\u0026quot;: true}' http://127.0.0.1:8080/command/res/DEFAULT_TENANT/4712/req-id-uuid?hono-cmd-status=200 HTTP/1.1 202 Accepted content-length: 0  NB The example above assumes that a gateway device has been registered with hashed-password credentials with auth-id gw and password gw-secret which is authorized to publish data on behalf of device 4712.\nDownstream Meta Data The adapter includes the following meta data in the application properties of messages being sent downstream:\n   Name Type Description     device_id string The identifier of the device that the message originates from.   orig_adapter string Contains the adapter\u0026rsquo;s type name which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The HTTP adapter\u0026rsquo;s type name is hono-http.   orig_address string Contains the (relative) URI that the device has originally posted the data to.   ttd integer Contains the effective number of seconds that the device will wait for a response. This property is only set if the HTTP request contains the hono-ttd header or request parameter.    The adapter also considers defaults registered for the device at either the tenant or the device level. The values of the default properties are determined as follows:\n If the message already contains a non-empty property of the same name, the value if unchanged. Otherwise, if a default property of the same name is defined in the device\u0026rsquo;s registration information, that value is used. Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.  Note that of the standard AMQP 1.0 message properties only the content-type and ttl can be set this way to a default value.\nEvent Message Time-to-live Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers. In most cases the AMQP Messaging Network can be configured with a maximum time-to-live to apply to the events so that the events will be removed from the persistent store if no consumer has attached to receive the event before the message expires.\nIn order to support environments where the AMQP Messaging Network cannot be configured accordingly, the protocol adapter supports setting a downstream event message\u0026rsquo;s ttl property based on the hono-ttl property set as a header or a query parameter in the event requests by the devices. Also the default ttl and max-ttl values can be configured for a tenant/device as described in the Tenant API.\nTenant specific Configuration The adapter uses the Tenant API to retrieve tenant specific configuration for adapter type hono-http. The following properties are (currently) supported:\n   Name Type Default Value Description     enabled boolean true If set to false the adapter will reject all data from devices belonging to the tenant.   max-ttd integer 60 Defines a tenant specific upper limit for the time until disconnect property that devices may include in requests for uploading telemetry data or events. Please refer to the Command \u0026amp; Control concept page for a discussion of this parameter\u0026rsquo;s purpose and usage.\nThis property can be set for the hono-http adapter type as an extension property in the adapter section of the tenant configuration.\nIf it is not set, then the default value of 60 seconds is used.   "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/user-guide/mqtt-adapter/",
+	"title": "MQTT Adapter",
+	"tags": [],
+	"description": "",
+	"content": "The MQTT protocol adapter exposes an MQTT topic hierarchy for publishing telemetry data and events to downstream consumers and for receiving commands from applications and sending back responses.\nThe MQTT adapter is not a general purpose MQTT broker. In particular the adapter\n supports MQTT 3.1.1 only. does not maintain session state for clients and thus always sets the session present flag in its CONNACK packet to 0, regardless of the value of the clean session flag provided in a client\u0026rsquo;s CONNECT packet. ignores any Will included in a client\u0026rsquo;s CONNECT packet. only supports topic names/filters for devices to publish and subscribe to that are specific to Hono\u0026rsquo;s functionality as described in the following sections. does not support retaining messages. However, if an event or telemetry message\u0026rsquo;s retain flag is set to 1 then the corresponding AMQP 1.0 message being sent downstream by the adapter will contain an x-opt-retain message annotation containing the boolean value true. A downstream consumer may then react according to the presence of this annotation.  Authentication The MQTT adapter by default requires clients (devices or gateway components) to authenticate during connection establishment. The adapter supports both the authentication based on the username/password provided in an MQTT CONNECT packet as well as client certificate based authentication as part of a TLS handshake for that purpose.\nThe adapter tries to authenticate the device using these mechanisms in the following order\nClient Certificate When a device uses a client certificate for authentication during the TLS handshake, the adapter tries to determine the tenant that the device belongs to based on the issuer DN contained in the certificate. In order for the lookup to succeed, the tenant\u0026rsquo;s trust anchor needs to be configured by means of registering the trusted certificate authority. The device\u0026rsquo;s client certificate will then be validated using the registered trust anchor, thus implicitly establishing the tenant that the device belongs to. In a second step, the adapter uses the Credentials API\u0026rsquo;s get operation to retrieve the credentials on record, including the client certificate\u0026rsquo;s subject DN as the auth-id, x509-cert as the type of secret and the MQTT client identifier as client-id in the request payload.\nNB The adapter needs to be configured for TLS in order to support this mechanism.\nUsername/Password When a device wants to authenticate using this mechanism, it needs to provide a username and a password in the MQTT CONNECT packet it sends in order to initiate the connection. The username must have the form auth-id@tenant, e.g. sensor1@DEFAULT_TENANT. The adapter verifies the credentials provided by the client against the credentials that the configured Credentials service has on record for the client. The adapter uses the Credentials API\u0026rsquo;s get operation to retrieve the credentials on record, including the tenant and auth-id provided by the client in the username, hashed-password as the type of secret and the MQTT client identifier as client-id in the request payload.\nThe examples below refer to devices 4711 and gw-1 of tenant DEFAULT_TENANT using auth-ids sensor1 and gw1 and corresponding passwords. The example deployment as described in the Deployment Guides comes pre-configured with the corresponding entities in its device registry component.\nNB There is a subtle difference between the device identifier (device-id) and the auth-id a device uses for authentication. See Device Identity for a discussion of the concepts.\nResource Limit Checks The adapter performs additional checks regarding resource limits when a client tries to connect and/or send a message to the adapter.\nConnection Limits The adapter rejects a client’s connection attempt with return code\n 0x03 (Connection Refused: server unavailable), if the maximum number of connections per protocol adapter instance is reached 0x05 (Connection Refused: not authorized), if the maximum number of simultaneously connected devices for the tenant is reached.  Connection Duration Limits The adapter rejects a client’s connection attempt with return code 0x05 (Connection Refused: not authorized), if the connection duration limit that has been configured for the client’s tenant is exceeded.\nMessage Limits The adapter\n rejects a client\u0026rsquo;s connection attempt with return code 0x05 (Connection Refused: not authorized), discards any MQTT PUBLISH packet containing telemetry data or an event that is sent by a client and rejects any AMQP 1.0 message containing a command sent by a north bound application  if the message limit that has been configured for the device’s tenant is exceeded.\nConnection Event The MQTT Adapter can send a Connection Event once the connection with a device has been successfully established or ended. Note that this requires the HONO_CONNECTION_EVENTS_PRODUCER configuration property to be explicitly set to events.\nPublishing Telemetry Data The MQTT adapter supports the publishing of telemetry data by means of MQTT PUBLISH packets using either QoS 0 or QoS 1. Using QoS 1 will result in the adapter sending an MQTT PUBACK packet to the client once the message has been settled with the accepted outcome by the AMQP 1.0 Messaging Network.\nThis requires that\n the AMQP 1.0 Messaging Network has capacity to process telemetry messages for the client\u0026rsquo;s tenant and the messages published by the client comply with the format defined by the Telemetry API.  The protocol adapter checks the configured message limit before accepting any telemetry messages. If the message limit is exceeded or the incoming telemetry message cannot be processed, the connection to the client is closed.\nPublish Telemetry Data (authenticated Device)  Topic: telemetry or t Authentication: required Payload:  (required) Arbitrary payload   This is the preferred way for devices to publish telemetry data. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default). When using this topic, the MQTT adapter determines the device\u0026rsquo;s tenant and device identity as part of the authentication process.\nExample\nPublish some JSON data for device 4711:\nmosquitto_pub -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t telemetry -m '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4711 using a client certificate for authentication:\n# in base directory of Hono repository: mosquitto_pub -p 8883 -t telemetry -m '{\u0026quot;temp\u0026quot;: 5}' --cert demo-certs/certs/device-4711-cert.pem --key demo-certs/certs/device-4711-key.pem --cafile demo-certs/certs/trusted-certs.pem  NB The example above assumes that the MQTT adapter is configured for TLS and the secure port is used.\nPublish Telemetry Data (unauthenticated Device)  Topic: telemetry/${tenant-id}/${device-id} or t/${tenant-id}/${device-id} Authentication: none Payload:  (required) Arbitrary payload   This topic can be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_MQTT_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711:\nmosquitto_pub -t telemetry/DEFAULT_TENANT/4711 -m '{\u0026quot;temp\u0026quot;: 5}'  Publish Telemetry Data (authenticated Gateway)  Topic: telemetry/${tenant-id}/${device-id} or t/${tenant-id}/${device-id} Authentication: required Payload:  (required) Arbitrary payload   This topic can be used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the topic name are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nPublish some JSON data for device 4712 via gateway gw-1:\nmosquitto_pub -u 'gw@DEFAULT_TENANT' -P gw-secret -t telemetry/DEFAULT_TENANT/4712 -m '{\u0026quot;temp\u0026quot;: 5}'  NB The example above assumes that a gateway device with ID gw-1 has been registered with hashed-password credentials with auth-id gw and password gw-secret.\nPublishing Events The MQTT adapter supports the publishing of events by means of MQTT PUBLISH packets using QoS 1 only. The adapter will send an MQTT PUBACK packet to the client once the event has been settled with the accepted outcome by the AMQP 1.0 Messaging Network.\nThis requires that\n the AMQP 1.0 Messaging Network has capacity to process events for the client\u0026rsquo;s tenant and the events published by the client comply with the format defined by the Event API.  The protocol adapter checks the configured message limit before accepting any event messages. If the message limit is exceeded or the incoming event message cannot be processed, the connection to the client is closed.\nThe devices can optionally indicate a time-to-live duration for event messages by setting the hono-ttl property explicitly in the property-bag. The property-bag is an optional collection of properties intended for the receiver of the message. A property bag is only allowed at the very end of a topic. It always starts with a /? character, followed by pairs of URL encoded property names and values that are separated by \u0026amp;. For example, a property bag containing two properties seqNo and importance looks like this: /topic/name/?seqNo=10034\u0026amp;importance=high.\nThe MQTT adapter currently does not use any properties except hono-ttl.\nPublish an Event (authenticated Device)  Topic: event or e Authentication: required Payload:  (required) Arbitrary payload   This is the preferred way for devices to publish events. It is available only if the protocol adapter has been configured to require devices to authenticate (which is the default).\nExample\nUpload a JSON string for device 4711:\nmosquitto_pub -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t event -q 1 -m '{\u0026quot;alarm\u0026quot;: 1}'  Upload a JSON string for device 4711 with time-to-live as 10 seconds:\nmosquitto_pub -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t event/?hono-ttl=10 -q 1 -m '{\u0026quot;alarm\u0026quot;: 1}'  Publish an Event (unauthenticated Device)  Topic: event/${tenant-id}/${device-id} or e/${tenant-id}/${device-id} Authentication: none Payload:  (required) Arbitrary payload   This topic can be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_MQTT_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711:\nmosquitto_pub -t event/DEFAULT_TENANT/4711 -q 1 -m '{\u0026quot;alarm\u0026quot;: 1}'  Publish some JSON data for device 4711 with time-to-live as 15 seconds:\nmosquitto_pub -t event/DEFAULT_TENANT/4711/?hono-ttl=15 -q 1 -m '{\u0026quot;alarm\u0026quot;: 1}'  Publish an Event (authenticated Gateway)  Topic: event/${tenant-id}/${device-id} or e/${tenant-id}/${device-id} Authentication: required Payload:  (required) Arbitrary payload   This topic can be used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the topic name are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nPublish some JSON data for device 4712 via gateway gw-1:\nmosquitto_pub -u 'gw@DEFAULT_TENANT' -P gw-secret -t event/DEFAULT_TENANT/4712 -q 1 -m '{\u0026quot;temp\u0026quot;: 5}'  NB The example above assumes that a gateway device with ID gw-1 has been registered with hashed-password credentials with auth-id gw and password gw-secret.\nCommand \u0026amp; Control The MQTT adapter enables devices to receive commands that have been sent by business applications by means of sending an MQTT SUBSCRIBE packet containing a device specific topic filter as described below. Devices can subscribe with QoS 1 or QoS 0. The adapter indicates the outcome of the subscription request by sending back a corresponding SUBACK packet. The SUBACK packet will contain Success - QoS 0 (0x00) or Success - QoS 1 (0x01) for a command topic filter indicating QoS 0 or 1 and will contain the Failure (0x80) value for all other filters. When a device no longer wants to receive commands anymore, it can send an MQTT UNSUBSCRIBE packet to the adapter, including the same topic filter that has been used to subscribe.\nWhen a device has successfully subscribed, the adapter sends an empty notification on behalf of the device to the downstream AMQP 1.0 Messaging Network with the ttd header set to -1, indicating that the device will be ready to receive commands until further notice. Analogously, the adapter sends an empty notification with the ttd header set to 0 when a device unsubscribes from commands.\nCommands can be sent following a request/response pattern or being one-way.\nFor Request/Response commands, devices send their responses to commands by means of sending an MQTT PUBLISH message to a topic that is specific to the command that has been executed. The MQTT adapter accepts responses being published using either QoS 0 or QoS 1.\nThe MQTT adapter checks the configured message limit before accepting any command requests and responses. In case of incoming command requests from business applications, if the message limit is exceeded, the Adapter rejects the message with the reason amqp:resource-limit-exceeded. And for the incoming command responses from devices, the Adapter rejects the message and closes the connection to the client.\nThe following sections define the topic filters/names to use for subscribing to and responding to commands. The following shorthand versions of topic path segments are supported:\n c instead of command q instead of req s instead of res  The following variables are used:\n ${command} : An arbitrary string that indicates the command to execute, e.g. setBrightness. The command is provided by the application that sends the command. ${req-id} (only for Request/Response commands) : The unique identifier of the command execution request. The identifier is passed to the device as part of the name of the topic that the command is published to. The device needs to publish its response to the command to a topic which includes this identifier, thus allowing the adapter to correlate the response with the request. ${status} : The HTTP status code indicating the outcome of executing the command. This status code is passed on to the application in the AMQP message\u0026rsquo;s status application property.  Receiving Commands (authenticated Device) An authenticated device MUST use the topic filter command///req/# to subscribe to commands.\n Deprecation Previous versions of Hono required authenticated devices to use command/+/+/req/# for subscribing to commands. This old topic filter is deprecated. Devices MAY still use it until support for it will be removed in a future Hono version.  Example\nmosquitto_sub -v -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t command///req/#  The adapter will then publish Request/Response commands for the device to topic command///req/${req-id}/${command} and one-way commands to topic command///req//${command}.\nFor example, a request/response command with name setBrightness from an application might look like this:\ncommand///q/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/setBrightness { \u0026quot;brightness\u0026quot;: 79 }  A corresponding one-way command might look like this:\ncommand///q//setBrightness { \u0026quot;brightness\u0026quot;: 79 }  Note that the topic in the latter case doesn\u0026rsquo;t contain a request identifier.\nReceiving Commands (unauthenticated Device) An unauthenticated device MUST use the topic filter command/${tenant-id}/${device-id}/req/# to subscribe to commands.\nExample\nmosquitto_sub -v -t command/DEFAULT_TENANT/4711/req/#  The adapter will then publish Request/Response commands for the device to topic command/${tenant-id}/${device-id}/req/${req-id}/${command} and one-way commands to topic command/${tenant-id}/${device-id}/req//${command}.\nFor example, a request/response command with name setBrightness from an application might look like this:\ncommand/DEFAULT_TENANT/4711/q/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/setBrightness { \u0026quot;brightness\u0026quot;: 79 }  A corresponding one-way command might look like this:\ncommand/DEFAULT_TENANT/4711/q//setBrightness { \u0026quot;brightness\u0026quot;: 79 }  Note that the topic in the latter case doesn\u0026rsquo;t contain a request identifier.\nReceiving Commands (authenticated Gateway) Gateway components can receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. Corresponding devices have to be configured so that they can be used with a gateway. See Configuring Gateway Devices for details.\nAn authenticated gateway MUST use the topic filter command//+/req/# to subscribe to commands for all devices in whose behalf it acts.\nTo subscribe only to commands for a specific device, an authenticated gateway MUST use the topic filter command//${device-id}/req/#.\n Deprecation Previous versions of Hono required authenticated gateways to use command/+/+/req/# for subscribing to commands. This old topic filter is deprecated. Gateways MAY still use it until support for it will be removed in a future Hono version.  When processing an incoming command message, the protocol adapter will give precedence to a device-specific command subscription matching the command target device, whether the subscription comes from a gateway or the device itself. If there are multiple such subscriptions from multiple gateways and/or from the device itself, the subscription initiated last will get the command messages.\nIf no device-specific command subscription exists for a command target device, but one gateway, that may act on behalf of the device, has subscribed to commands for all its devices, then the command message is sent to that gateway.\nIf multiple gateways have initiated such generic subscriptions, the protocol adapter may have to decide to which gateway a particular command message will be sent to. In case the command target device has already sent a telemetry, event or command response message via a gateway and if that gateway has created such a command subscription, that gateway will be chosen. Otherwise one gateway that may act on behalf of the command target device and that has an open subscription will be chosen randomly to receive the command message.\nExample\nA subscription to commands for all devices that a gateway acts on behalf of looks like this:\nmosquitto_sub -v -u 'gw@DEFAULT_TENANT' -P gw-secret -t command//+/req/#  A subscription to commands for a specific device can be done like this:\nmosquitto_sub -v -u 'gw@DEFAULT_TENANT' -P gw-secret -t command//4711/req/#  The adapter will then publish Request/Response commands for devices, that the gateway has acted on behalf of, to topic command//${device-id}/req/${req-id}/${command} and one-way commands to topic command//${device-id}/req//${command}.\nFor example, a request/response command for device 4711 with name setBrightness from an application might look like this:\ncommand//4711/q/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/setBrightness { \u0026quot;brightness\u0026quot;: 79 }  A corresponding one-way command might look like this:\ncommand//4711/q//setBrightness { \u0026quot;brightness\u0026quot;: 79 }  Note that the topic in the latter case doesn\u0026rsquo;t contain a request identifier.\nSending a Response to a Command (authenticated Device) An authenticated device MUST send the response to a previously received command to the topic command///res/${req-id}/${status}.\nExample\nAfter a command has arrived as in the above example, you send a response using the arrived ${req-id}:\nmosquitto_pub -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t command///res/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/200 -m '{\u0026quot;lumen\u0026quot;: 200}'  Sending a Response to a Command (unauthenticated Device) An unauthenticated device MUST send the response to a previously received command to the topic command/${tenant-id}/${device-id}/res/${req-id}/${status}.\nExample\nAfter a command has arrived as in the above example, you send a response using the arrived ${req-id}:\nmosquitto_pub -t command/DEFAULT_TENANT/4711/res/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/200 -m '{\u0026quot;lumen\u0026quot;: 200}'  Sending a Response to a Command (authenticated Gateway) An authenticated gateway MUST send a device\u0026rsquo;s response to a command it has received on behalf of the device to the topic command//${device-id}/res/${req-id}/${status}.\nExample\nAfter a command has arrived as in the above example, the response is sent using the ${req-id} from the topic that the command had been published to:\nmosquitto_pub -u 'gw@DEFAULT_TENANT' -P gw-secret -t command//4711/res/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/200 -m '{\u0026quot;lumen\u0026quot;: 200}'  Downstream Meta Data The adapter includes the following meta data in messages being sent downstream:\n   Name Location Type Description     device_id application string The identifier of the device that the message originates from.   orig_adapter application string Contains the adapter\u0026rsquo;s type name which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The MQTT adapter\u0026rsquo;s type name is hono-mqtt.   orig_address application string Contains the name of the MQTT topic that the device has originally published the data to.   x-opt-retain * message-annotations boolean Contains true if the device has published an event or telemetry message with its retain flag set to 1    The adapter also considers defaults registered for the device at either the tenant or the device level. The values of the default properties are determined as follows:\n If the message already contains a non-empty property of the same name, the value if unchanged. Otherwise, if a default property of the same name is defined in the device\u0026rsquo;s registration information, that value is used. Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.  Note that of the standard AMQP 1.0 message properties only the content-type and ttl can be set this way to a default value.\nEvent Message Time-to-live Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers. In most cases the AMQP Messaging Network can be configured with a maximum time-to-live to apply to the events so that the events will be removed from the persistent store if no consumer has attached to receive the event before the message expires.\nIn order to support environments where the AMQP Messaging Network cannot be configured accordingly, the MQTT protocol adapter supports setting a downstream event message\u0026rsquo;s ttl property based on the hono-ttl property set as property-bag at the end of the event topic. Also the default ttl and max-ttl values can be configured for a tenant/device as described in the Tenant API.\nTenant specific Configuration The adapter uses the Tenant API to retrieve tenant specific configuration for adapter type hono-mqtt. The following properties are (currently) supported:\n   Name Type Default Value Description     enabled boolean true If set to false the adapter will reject all data from devices belonging to the tenant.   "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/user-guide/amqp-adapter/",
+	"title": "AMQP Adapter",
+	"tags": [],
+	"description": "",
+	"content": "The AMQP protocol adapter allows clients (devices or gateway components) supporting the AMQP 1.0 protocol to publish messages to Eclipse Hono\u0026trade;\u0026rsquo;s Telemetry, Event and Command \u0026amp; Control endpoints.\nDevice Authentication By default, all Hono protocol adapters require clients (devices or gateway components) to authenticate during connection establishment. This is the preferred way for devices to publish data via protocol adapters. The AMQP adapter supports both the SASL PLAIN and SASL EXTERNAL authentication mechanisms. The former uses a username and password to authenticate to the adapter while the latter uses a client certificate.\nIn this guide, we will give examples for publishing telemetry data and events for authenticated (using SASL PLAIN) and unauthenticated clients.\nNB The AMQP adapter can be configured to allow unauthenticated devices to connect by setting configuration variable HONO_AMQP_AUTHENTICATION_REQUIRED to false.\nSASL PLAIN Authentication The AMQP adapter supports authenticating clients using a username and password. This means that clients need to provide a username and a password when connecting to the AMQP adapter. If the adapter is configured for multi-tenancy (i.e HONO_AMQP_SINGLE_TENANT is set to false), then the username must match the pattern [auth-id@tenant], e.g. sensor1@DEFAULT_TENANT. Otherwise the DEFAULT_TENANT is assumed and the tenant-id can be omitted from the username.\nThe adapter verifies the credentials provided by the client against the credentials the configured Credentials service has on record for the client. If the credentials match, then authentication is successful and the client device can proceed to publish messages to Hono.\nThe examples below refer to devices 4711 and gw-1 of tenant DEFAULT_TENANT using auth-ids sensor1 and gw1 and corresponding passwords. The example deployment as described in the Deployment Guides comes pre-configured with the corresponding entities in its device registry component.\nNB There is a subtle difference between the device identifier (device-id) and the auth-id a device uses for authentication. See Device Identity for a discussion of the concepts.\nSASL EXTERNAL Authentication When a device uses a client certificate for authentication, the TLS handshake is initiated during TCP connection establishment. If no trust anchor is configured for the AMQP adapter, the TLS handshake will succeed only if the certificate has not yet expired. Once the TLS handshake completes and a secure connection is established, the certificate\u0026rsquo;s signature is checked during the SASL handshake. To complete the SASL handshake and authenticate the client, the adapter performs the following steps:\n Adapter extracts the client certificate\u0026rsquo;s Issuer DN and uses it to us the Tenant service to look up the tenant that the client belongs to. In order for the lookup to succeed, the tenant’s trust anchor needs to be configured by means of registering the trusted certificate authority. If the lookup succeeds, the Tenant service returns the tenant, thus implicitly establishing the tenant that the device belongs to. Adapter validates the device’s client certificate using the registered trust anchor for the tenant. Finally, adapter authenticates the client certificate using Hono\u0026rsquo;s credentials API. In this step, the adapter uses the client certificate’s Subject DN (as authentication identifier) and x509-cert (for the credentials type) in order to determine the device ID.  NB The AMQP adapter needs to be configured for TLS in order to support this mechanism.\nResource Limit Checks The adapter performs additional checks regarding resource limits when a client tries to connect and/or send a message to the adapter.\nConnection Limits The adapter fails the SASL handshake with a client\n if the maximum number of simultaneously connected devices for the client\u0026rsquo;s tenant is reached, or if the maximum number of connections per protocol adapter instance is reached.  Connection Duration Limits The adapter fails the SASL handshake with a client if the connection duration limit that has been configured for the client’s tenant is exceeded.\nMessage Limits The adapter\n fails the SASL handshake with a client and rejects any AMQP 1.0 message containing  telemetry data or an event uploaded by a client a command sent by a north bound application   if the message limit that has been configured for the device’s tenant is exceeded.\nConnection Event The AMQP Adapter can send a Connection Event once the connection with a device has been successfully established or ended. Note that this requires the HONO_CONNECTION_EVENTS_PRODUCER configuration property to be explicitly set to events.\nLink Establishment The AMQP adapter supports the Anonymous Terminus for Message Routing specification and requires clients to create a single sender link using the null target address for publishing all types of messages to the AMQP adapter.\nUsing AT MOST ONCE delivery semantics, the client will not wait for the message to be accepted and settled by the downstream consumer. However, with AT LEAST ONCE, the client sends the message and waits for the message to be delivered to and accepted by the downstream consumer. If the message cannot be delivered due to a failure, the client will be notified.\nThe client indicates its preferred message delivery mode by means of the snd-settle-mode and rcv-settle-mode fields of its attach frame during link establishment. Clients should use mixed as the snd-settle-mode and first as the rcv-settle-mode in order to be able to use the same link for sending all types of messages using different delivery semantics as described in the following sections.\nError Handling The AMQP adapter distinguishes between two types of errors when a message is published using at least once:\n An error caused by the client side, e.g invalid message address, content-type, adapter disabled for tenant etc. An error caused by the server side, e.g no downstream consumers registered, downstream connection loss etc.  For a client side error, the adapter settles the message transfer with the rejected outcome and provides an error description in the corresponding disposition frame. In the case of a server-side error, the adapter settles the message with the released outcome, indicating to the client that the message itself was OK but it cannot be delivered due to a failure beyond the control of the client. In the latter case, a client may attempt to re-send the message unaltered.\nAMQP Command-line Client For purposes of demonstrating the usage of the AMQP adapter, the Hono CLI Module contains an AMQP command-line client for interacting with the AMQP adapter. The client can be used to send telemetry or events and to receive/respond to command request messages.\nThe command-line client supports the following parameters (with default values):\n --spring.profiles.active=amqp-send: Profile for sending telemetry data or events to Hono. --spring.profiles.active=amqp-command: Profile for receiving and responding to command request messages. --message.address: The AMQP 1.0 message address (default: telemetry) --message.payload: The message payload body (default: '{\u0026quot;temp\u0026quot;: 5}') --hono.client.host: The host name that the AMQP adapter is running on (default: localhost) --hono.client.port: The port that the adapter is listening for incoming connections (default: 5672)  To run the client to send a telemetry message to Hono, open a terminal and execute the following:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=sensor1@DEFAULT_TENANT --hono.client.password=hono-secret Accepted{}  The client prints the outcome of the operation to standard out. The outcome above (Accepted) indicates that the request to upload the data has succeeded.\nNB There are two JAR files in the hono/cli/target directory. The JAR to use for the client is the hono-cli-$VERSION-exec.jar and not the hono-cli-$VERSION.jar file. Running the latter will not work and will output the message: no main manifest attribute, in hono-cli-$VERSION.jar\nPublishing Telemetry Data The client indicates the delivery mode to use when uploading telemetry messages by means of the settled and rcv-settle-mode properties of the AMQP transfer frame(s) it uses for uploading the message. The AMQP adapter will accept messages using a delivery mode according to the following table:\n   settled rcv-settle-mode Delivery semantics     false first The adapter will forward the message to the downstream AMQP 1.0 Messaging Network and will forward any AMQP disposition frame received from the AMQP 1.0 Messaging Network to the client as is. It is up to the client\u0026rsquo;s discretion if and how it processes the disposition frame. The adapter will accept any re-delivered message. Sending unsettled messages allows for clients to implement either AT LEAST ONCE or AT MOST ONCE delivery semantics, depending on whether a client actually waits for and considers the disposition frames it receives from the adapter or not. This is the recommended mode for uploading telemetry data.   true first The adapter will acknowledge and settle any received message spontaneously before forwarding it to the downstream AMQP 1.0 Messaging Network. The adapter will ignore any AMQP disposition frames it receives from the AMQP 1.0 Messaging Network. Sending pre-settled messages allows for clients to implement AT MOST ONCE delivery semantics only. This is the fastest mode of delivery but has the drawback of less reliable end-to-end flow control and potential loss of messages without notice.    All other combinations are not supported by the adapter and will result in the message being ignored (pre-settled) or rejected (unsettled).\nPublish Telemetry Data (authenticated Device) The AMQP adapter supports publishing of telemetry data to Hono\u0026rsquo;s Telemetry API. Telemetry messages can be published using either AT LEAST ONCE or AT MOST ONCE delivery semantics.\n Message Address: telemetry or t  This refers to the to property of the message.  Settlement Mode: presettled (AT MOST ONCE) or unsettled (AT LEAST ONCE) Authentication: SASL PLAIN or SASL EXTERNAL Message Body:  (optional) Arbitrary payload  Message properties:  (optional) Arbitrary properties (content-type, correlation-id, \u0026hellip;)  Disposition Frames:  Accepted: Message successfully processed by the adapter. Released: Message cannot be processed and should be redelivered. Rejected: Adapter rejects the message due to one of the following:  (hono:bad-request): Request rejected due to a bad client request. (amqp:unauthorized-access): Request rejected because the adapter is disabled for tenant. (amqp:precondition-failed): Request does not fulfill certain requirements e.g adapter cannot assert device registration etc. (amqp:resource-limit-exceeded): Request rejected because the message limit for the given tenant is exceeded.    When a device publishes data to the telemetry address, the AMQP adapter automatically determines the device\u0026rsquo;s identity and tenant during the authentication process.\nExample\nPublish some JSON data for device 4711:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=sensor1@DEFAULT_TENANT --hono.client.password=hono-secret  Notice that we only supplied a new value for the message address, leaving the other default values.\nPublish some JSON data for device 4711 using a client certificate for authentication:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.port=5671 --hono.client.certPath=config/hono-demo-certs-jar/device-4711-cert.pem --hono.client.keyPath=config/hono-demo-certs-jar/device-4711-key.pem --hono.client.trustStorePath=config/hono-demo-certs-jar/trusted-certs.pem --hono.client.hostnameVerificationRequired=false  Publish Telemetry Data (unauthenticated Device)  Message Address: telemetry/${tenant-id}/${device-id} or t/${tenant-id}/${device-id} Settlement Mode: presettled (AT MOST ONCE) or unsettled (AT LEAST ONCE) Authentication: none Message Body:  (optional) Arbitrary payload  Message properties:  (optional) Arbitrary properties (content-type, correlation-id, \u0026hellip;)  Disposition Frames:  Accepted: Message successfully processed by the adapter. Released: Message cannot be processed and should be redelivered. Rejected: Adapter rejects the message due to:  (hono:bad-request): A bad client request (e.g invalid content-type). (amqp:unauthorized-access): The adapter is disabled for tenant. (amqp:precondition-failed): Request not fulfilling certain requirements. (amqp:resource-limit-exceeded): Request rejected because the message limit for the given tenant is exceeded.    Note how verbose the address is for unauthenticated devices. This address can be used by devices that have not authenticated to the protocol adapter. This requires the HONO_AMQP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false before starting the protocol adapter.\nExamples\nPublish some JSON data for device 4711:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --message.address=t/DEFAULT_TENANT/4711  Publish Telemetry Data (authenticated Gateway) A device that publishes data on behalf of another device is called a gateway device. The message address is used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the message address is used to identify the device that the gateway publishes data for.\nExamples\nA gateway connecting to the adapter using gw@DEFAULT_TENANT as username and gw-secret as password and then publishing some JSON data for device 4711:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=gw@DEFAULT_TENANT --hono.client.password=gw-secret --message.address=t/DEFAULT_TENANT/4711  In this example, we are using message address t/DEFAULT_TENANT/4711 which contains the device that the gateway is publishing the message for.\nPublishing Events The adapter supports AT LEAST ONCE delivery of Event messages only. A client therefore MUST set the settled property to false and the rcv-settle-mode property to first in all transfer frame(s) it uses for uploading events. All other combinations are not supported by the adapter and result in the message being rejected.\nPublish an Event (authenticated Device)  Message Address: event or e Settlement Mode: unsettled (AT LEAST ONCE) Authentication: SASL PLAIN or SASL EXTERNAL Message Body:  (optional) Arbitrary payload  Message properties:  (optional) Arbitrary properties (content-type, correlation-id, \u0026hellip;)  Disposition Frames:  Accepted: Message successfully processed by the adapter. Released: Message cannot be processed and should be redelivered. Rejected: Adapter rejects the message due to:  (hono:bad-request): A bad client request (e.g invalid content-type). (amqp:unauthorized-access): The adapter is disabled for tenant. (amqp:precondition-failed): Request not fulfilling certain requirements. (amqp:resource-limit-exceeded): Request rejected because the message limit for the given tenant is exceeded.    This is the preferred way for devices to publish events. It is available only if the protocol adapter has been configured to require devices to authenticate (which is the default).\nExample\nUpload a JSON string for device 4711:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=sensor1@DEFAULT_TENANT --hono.client.password=hono-secret --message.address=event --message.payload='{\u0026quot;alarm\u0026quot;: 1}'  Publish an Event (unauthenticated Device)  Message Address: event/${tenant-id}/${device-id} or e/${tenant-id}/${device-id} Settlement Mode: unsettled (AT LEAST ONCE) Message Body:  (optional) Arbitrary payload  Message properties:  (optional) Arbitrary properties (content-type, correlation-id, \u0026hellip;)  Disposition Frames:  Accepted: Message successfully processed by the adapter. Released: Message cannot be processed and should be redelivered. Rejected: Adapter rejects the message due to:  (hono:bad-request): A bad client request (e.g invalid content-type). (amqp:unauthorized-access): The adapter is disabled for tenant. (amqp:precondition-failed): Request not fulfilling certain requirements. (amqp:resource-limit-exceeded): Request rejected because the message limit for the given tenant is exceeded.    This address format is used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_AMQP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --message.address=e/DEFAULT_TENANT/4711 --message.payload='{\u0026quot;alarm\u0026quot;: 1}'  Publish an Event (authenticated Gateway) Examples\nA gateway connecting to the adapter using gw@DEFAULT_TENANT as username and gw-secret as password and then publishing some JSON data for device 4711:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=gw@DEFAULT_TENANT --hono.client.password=gw-secret --message.address=e/DEFAULT_TENANT/4711  In this example, we are using message address e/DEFAULT_TENANT/4711 which contains the device that the gateway is publishing the message for.\nCommand \u0026amp; Control The AMQP adapter enables devices to receive commands that have been sent by business applications by means of opening a receiver link using a device specific source address as described below. When a device no longer wants to receive commands anymore, it can simply close the link.\nWhen a device has successfully opened a receiver link for commands, the adapter sends an empty notification on behalf of the device to the downstream AMQP 1.0 Messaging Network with the ttd header set to -1, indicating that the device will be ready to receive commands until further notice. Analogously, the adapter sends an empty notification with the ttd header set to 0 when a device closes the link or disconnects.\nDevices send their responses to commands by means of sending an AMQP message with properties specific to the command that has been executed. The AMQP adapter accepts responses being published using either at most once (QoS 0) or at least once (QoS 1) delivery semantics. The device must send the command response messages using the same (sender) link that it uses for sending telemetry data and events.\nThe AMQP adapter checks the configured message limit before accepting any command requests and responses. In case of incoming command requests from business applications or the command responses from devices, if the message limit is exceeded, the Adapter rejects the message with the reason amqp:resource-limit-exceeded.\nReceiving Commands A device MUST use the following source address in its attach frame to open a link for receiving commands:\n command (authenticated device) command (authenticated gateway receiving commands for all devices it acts on behalf of) command/${tenant}/${device-id} (unauthenticated device) command/${tenant}/${device-id} (authenticated gateway receiving commands for a specific device it acts on behalf of)  The adapter supports AT LEAST ONCE delivery of command messages only. A client therefore MUST use unsettled for the snd-settle-mode and first for the rcv-settle-mode fields of its attach frame during link establishment. All other combinations are not supported and result in the termination of the link.\nOnce the link has been established, the adapter will send command messages having the following properties:\n   Name Mandatory Location Type Description     subject yes properties string Contains the name of the command to be executed.   reply-to no properties string Contains the address to which the command response should be sent. This property will be empty for one-way commands.   correlation-id no properties string This property will be empty for one-way commands, otherwise it will contain the identifier used to correlate the response with the command request.   device_id no application-properties string This property will only be set if an authenticated gateway has connected to the adapter. It will contain the id of the device (connected to the gateway) that the command is targeted at.    Authenticated gateways will receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway. Corresponding devices have to be configured so that they can be used with a gateway. See Configuring Gateway Devices for details.\nA gateway can open a link to receive commands for all devices it acts on behalf of. An authenticated gateway can also open a receiver link for commands targeted at a specific device.\nWhen processing an incoming command message, the protocol adapter will give precedence to a device-specific command consumer matching the command target device, whether it was created by a gateway or by the device itself. If multiple such consumer links have been created, by multiple gateways and/or from the device itself, the gateway or device that last created the consumer link will get the command messages.\nIf no device-specific command consumer exists for a command target device, but one gateway, that may act on behalf of the device, has opened a generic, device-unspecific command consumer link, then the command message is sent to that gateway.\nIf multiple gateways have opened a generic command consumer link, the protocol adapter may have to decide to which gateway a particular command message will be sent to. In case the command target device has already sent a telemetry, event or command response message via a gateway and if that gateway has opened a command consumer link, that gateway will be chosen. Otherwise one gateway that may act on behalf of the command target device and that has opened a command consumer link will be chosen randomly to receive the command message.\nSending a Response to a Command A device only needs to respond to commands that contain a reply-to address and a correlation-id. However, if the application expects a response, then devices must publish a response back to the application. Devices may use the same anonymous sender link for this purpose that they also use for sending telemetry data and events.\nThe adapter supports AT LEAST ONCE delivery of command response messages only. A client therefore MUST set the settled property to true and the rcv-settle-mode property to first in all transfer frame(s) it uses for uploading command responses. All other combinations are not supported by the adapter and result in the message being rejected.\nThe table below provides an overview of the properties that must be set on a command response message:\n   Name Mandatory Location Type Description     to yes properties string MUST contain the value of the reply-to property of the command request message.   correlation-id yes properties string MUST contain the value of the correlation-id property of the command request message.   status yes application-properties integer MUST contain a status code indicating the outcome of processing the command at the device (see Command \u0026amp; Control API for details).    Examples The AMQP adapter client can be used to simulate a device which receives commands and sends responses back to the application. The command line client is used to simulate an application sending commands to devices and receiving command responses from devices.\nStart the AMQP adapter client, as follows:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-command --hono.client.username=sensor1@DEFAULT_TENANT --hono.client.password=hono-secret  After successfully starting the client, a message indicating that the device is ready to receive commands will be printed to standard output. The device is now waiting to receive commands from applications.\nTo send a command to the device, open a new terminal shell and start the command application, as shown below:\n# in directory: hono/cli/ java -jar target/hono-cli-*-exec.jar --hono.client.host=localhost --hono.client.username=consumer@HONO --hono.client.password=verysecret --spring.profiles.active=command,ssl   Note Change into the cli directory before running the command above to start the command application. If you change into the target directory (i.e cli/target), then the client will not be able to locate to certificate needed to connect to the messaging network.  Once the command application starts successfully, enter a command name, payload and content-type of the command to send to the device.\n\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt; Enter name of command for device [DEFAULT_TENANT:4711] (prefix with 'ow:' to send one-way command): setBrightness \u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt; Enter command payload: some-payload \u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt; Enter content type: text/plain  After sending the command, the device (i.e. AMQP command client) will print out the command name and payload that it receives and automatically sends a command response to the application.\nReceived Command Message : [Command name: setBrightness, Command payload: some-payload] Command response sent [outcome: Accepted{}]  Downstream Meta Data The adapter includes the following meta data in the application properties of messages being sent downstream:\n   Name Type Description     device_id string The identifier of the device that the message originates from.   orig_adapter string Contains the adapter\u0026rsquo;s type name which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The AMQP adapter\u0026rsquo;s type name is hono-amqp.   orig_address string Contains the AMQP target address that the device has used to send the data.    The adapter also considers defaults registered for the device at either the tenant or the device level. The values of the default properties are determined as follows:\n If the message already contains a non-empty property of the same name, the value if unchanged. Otherwise, if a default property of the same name is defined in the device\u0026rsquo;s registration information, that value is used. Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.  Note that of the standard AMQP 1.0 message properties only the content-type and ttl can be set this way to a default value.\nEvent Message Time-to-live Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers. In most cases the AMQP Messaging Network can be configured with a maximum time-to-live to apply to the events so that the events will be removed from the persistent store if no consumer has attached to receive the event before the message expires.\nIn order to support environments where the AMQP Messaging Network cannot be configured accordingly, the protocol adapter supports setting a downstream event message\u0026rsquo;s ttl property based on the default ttl and max-ttl values configured for a tenant/device as described in the Tenant API.\nTenant specific Configuration The adapter uses the Tenant API to retrieve tenant specific configuration for adapter type hono-amqp. The following properties are (currently) supported:\n   Name Type Default Value Description     enabled boolean true If set to false the adapter will reject all data from devices belonging to the tenant and respond with a amqp:unauthorized-access as the error condition value for rejecting the message.   "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/user-guide/coap-adapter/",
+	"title": "CoAP Adapter",
+	"tags": [],
+	"description": "",
+	"content": "The CoAP protocol adapter exposes CoAP based endpoints for Eclipse Hono\u0026trade;\u0026rsquo;s south bound Telemetry, Event and Command \u0026amp; Control APIs.\n Experimental The CoAP adapter has not yet reached the level of maturity of the other standard adapters. In particular, the resources implemented by the adapter might still be subject to change.  Device Authentication The CoAP adapter by default requires clients (devices or gateway components) to authenticate during connection establishment. The adapter (currently) only supports PSK as part of a DTLS handshake for that purpose. Additional variants mentioned in Securing CoAP might be added in the future.\nThe adapter tries to authenticate the device using these mechanisms in the following order\nPSK The identity provided in the ClientKeyExchange must have the form auth-id@tenant, e.g. sensor1@DEFAULT_TENANT. The adapter performs the handshake using the credentials the configured Credentials service has on record for the client. The adapter uses the Credentials API\u0026rsquo;s get operation to retrieve the credentials on record with the tenant and auth-id provided by the device in the identity and psk as the type of secret as query parameters.\nThe examples below refer to devices 4711 and gw-1 of tenant DEFAULT_TENANT using auth-ids sensor1 and gw1 and corresponding secrets. The example deployment as described in the Deployment Guides comes pre-configured with the corresponding entities in its device registry component. Please refer to the Credentials API for details regarding the different types of secrets.\nNB There is a subtle difference between the device identifier (device-id) and the auth-id a device uses for authentication. See Device Identity for a discussion of the concepts.\nMessage Limits Before accepting any telemetry or event or command messages, the CoAP adapter verifies that the configured message limit is not exceeded. For CoAP currently only the messages limit is verified, the connections limit is not available. If the limit is exceeded then the incoming message is discarded with the status code 429 Too Many Requests.\nCoAP Content Format Codes CoAP doesn\u0026rsquo;t use a textual identifier for content types. Instead numbers are used, which are maintained by the IANA. The IANA - CoAP Content Formats page lists all (currently) registered codes and the corresponding media types.\nPublish Telemetry Data (authenticated Device) The device is authenticated using PSK.\n URI: /telemetry Method: POST Type:  CON: at least once delivery semantics NON: at most once delivery semantics  Request Options:  (optional) content-format: The type of payload contained in the request body. Required, if request contains payload.  Query Parameters:  (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) empty: Marks the request as an empty notification.  Request Body:  (optional) Arbitrary payload encoded according to the given content type. Maybe empty, if URI-query: empty is provided.  Response Options:  (optional) content-format: A media type describing the semantics and format of payload contained in the response body. This option will only be present if the response contains a command to be executed by the device which requires input data. Note that this option will be empty if the media type contained in the command (AMQP) message\u0026rsquo;s content-type property cannot be mapped to one of the registered CoAP content-format codes. (optional) location-query: The hono-command query parameter contains the name of the command to execute. This option will only be present if the response contains a command to be executed by the device. (optional) location-path: The location path is command for one-way-commands and command_response/\u0026lt;command-request-id\u0026gt; for commands expecting a response. In the latter case, the location-path option contains exactly the URI-path that the device must use when sending its response to the command. This option will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device. (optional) Error details, if status code is \u0026gt;= 4.00.  Response Codes:  2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for the device to execute. Note that if the message type is NON (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer (yet). However, if the message type is CON (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 4.00 (Bad Request): The request cannot be processed. Possible reasons include:  the request body is empty and the URI-query option doesn\u0026rsquo;t contain the empty parameter  4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This is the preferred way for devices to publish telemetry data. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).\nExamples\nThe examples provided below make use of the coap-client command line tool which is part of the libcoap project. Precompiled packages should be available for different Linux variants.\nPublish some JSON data for device 4711 using default message type CON (at least once):\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret -m POST coaps://hono.eclipseprojects.io/telemetry -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'   Note coap-client only reports error response-codes, so the expected 2.04 response code will not be printed to the terminal.  Publish some JSON data for device 4711 using message type NON (at most once):\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret -N -m POST coaps://hono.eclipseprojects.io/telemetry -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4711, indicating that the device will wait for 10 seconds to receive the response:\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret -m POST coaps://hono.eclipseprojects.io/telemetry?hono-ttd=10 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}' { \u0026quot;brightness\u0026quot;: 87 }   Note In the example above the response actually contains payload that should be used as input to a command to be executed by the device. This is just for illustrative purposes. You will usually get an empty response because there is no downstream application attached which could send any commands to the device.  Publish Telemetry Data (unauthenticated Device)  URI: /telemetry/${tenantId}/${deviceId} Method: PUT Type:  CON: at least once delivery semantics NON: at most once delivery semantics  Request Options:  (optional) content-format: The type of payload contained in the request body. Required, if request contains payload.  Query Parameters:  (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) empty: Marks the request as an empty notification.  Request Body:  (optional) Arbitrary payload encoded according to the given content type. Maybe empty, if URI-query: empty is provided.  Response Options:  (optional) content-format: A media type describing the semantics and format of payload contained in the response body. This option will only be present if the response contains a command to be executed by the device which requires input data. Note that this option will be empty if the media type contained in the command (AMQP) message\u0026rsquo;s content-type property cannot be mapped to one of the registered CoAP content-format codes. (optional) location-query: The hono-command query parameter contains the name of the command to execute. This option will only be present if the response contains a command to be executed by the device. (optional) location-path: The location path is command for one-way-commands and command_response/\u0026lt;command-request-id\u0026gt; for commands expecting a response. In the latter case, the location-path option contains exactly the URI-path that the device must use when sending its response to the command. This option will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content). (optional) Error details, if status code is \u0026gt;= 4.00.  Response Codes:  2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for the device to execute. Note that if the message type is NON (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer (yet). However, if the message type is CON (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 4.00 (Bad Request): The request cannot be processed. Possible reasons include:  the request body is empty and the URI-query option doesn\u0026rsquo;t contain the empty parameter  4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_COAP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711 using default message type CON (at least once):\ncoap-client -m PUT coap://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4711 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4711 using message type NON (at most once):\ncoap-client -N -m PUT coap://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4711 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4711, indicating that the device will wait for 10 seconds to receive the response:\ncoap-client -m PUT coap://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4711?hono-ttd=10 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}' { \u0026quot;brightness\u0026quot;: 87 }  Publish Telemetry Data (authenticated Gateway)  URI: /telemetry/${tenantId}/${deviceId} Method: PUT Type:  CON: at least once delivery semantics NON: at most once delivery semantics  Request Options:  (optional) content-format: The type of payload contained in the request body. Required, if request contains payload.  Query Parameters:  (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) empty: Marks the request as an empty notification.  Request Body:  (optional) Arbitrary payload encoded according to the given content type. Maybe empty, if URI-query: empty is provided.  Response Options:  (optional) content-format: A media type describing the semantics and format of payload contained in the response body. This option will only be present if the response contains a command to be executed by the device which requires input data. Note that this option will be empty if the media type contained in the command (AMQP) message\u0026rsquo;s content-type property cannot be mapped to one of the registered CoAP content-format codes. (optional) location-query: The hono-command query parameter contains the name of the command to execute. This option will only be present if the response contains a command to be executed by the device. (optional) location-path: The location path is command/${tenantId}/${deviceId} for one-way-commands and command_response/${tenantId}/${deviceId}/\u0026lt;command-request-id\u0026gt; for commands expecting a response. In the latter case, the location-path option contains exactly the URI-path that the device must use when sending its response to the command. Note that in both cases the ${tenantId}/${deviceId} path segments indicate the device that the command is targeted at. This option will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content). (optional) Error details, if status code is \u0026gt;= 4.00.  Response Codes:  2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for a device to execute. Note that if the message type is NON (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer (yet). However, if the message type is CON (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 4.00 (Bad Request): The request cannot be processed. Possible reasons include:  the request body is empty and the URI-query option doesn\u0026rsquo;t contain the empty parameter  4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The tenant that the gateway belongs to is not allowed to use this protocol adapter. The device belongs to another tenant than the gateway. The gateway is not authorized to act on behalf of the device. The gateway associated with the device is not registered or disabled.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This resource can be used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nPublish some JSON data for device 4712 using default message type CON (at least once):\ncoap-client -u gw@DEFAULT_TENANT -k gw-secret -m PUT coaps://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4712 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4712 using message type NON (at most once):\ncoap-client -u gw@DEFAULT_TENANT -k gw-secret -N -m PUT coaps://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4712 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4712, indicating that the gateway will wait for 10 seconds to receive the response:\ncoap-client -u gw@DEFAULT_TENANT -k gw-secret -m PUT coaps://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4712?hono-ttd=10 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}' { \u0026quot;brightness\u0026quot;: 87 }  NB The examples above assume that a gateway device has been registered with psk credentials with auth-id gw and secret gw-secret which is authorized to publish data on behalf of device 4712.\nPublish an Event (authenticated Device) The device is authenticated using PSK.\n URI: /event Method: POST Type:CON Request Options:  (optional) content-format: The type of payload contained in the request body. Required, if request contains payload.  Query Parameters:  (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) empty: Marks the request as an empty notification.  Request Body:  (optional) Arbitrary payload encoded according to the given content type. Maybe empty, if URI-query: empty is provided.  Response Options:  (optional) content-format: A media type describing the semantics and format of payload contained in the response body. This option will only be present if the response contains a command to be executed by the device which requires input data. Note that this option will be empty if the media type contained in the command (AMQP) message\u0026rsquo;s content-type property cannot be mapped to one of the registered CoAP content-format codes. (optional) location-query: The hono-command query parameter contains the name of the command to execute. This option will only be present if the response contains a command to be executed by the device. (optional) location-path: The location path is command for one-way-commands and command_response/\u0026lt;command-request-id\u0026gt; for commands expecting a response. In the latter case, the location-path option contains exactly the URI-path that the device must use when sending its response to the command. This option will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content). (optional) Error details, if status code is \u0026gt;= 4.00.  Response Codes:  2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for the device to execute. Note that if the message type is NON (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer (yet). However, if the message type is CON (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 4.00 (Bad Request): The request cannot be processed. Possible reasons include:  the request body is empty and the URI-query option doesn\u0026rsquo;t contain the empty parameter  4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This is the preferred way for devices to publish events. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).\nExamples\nThe examples provided below make use of the coap-client command line tool which is part of the libcoap project. Precompiled packages should be available for different Linux variants.\nPublish some JSON data for device 4711 using default message type CON (at least once):\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret -m POST coaps://hono.eclipseprojects.io/event -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'   Note coap-client only reports error response-codes, so the expected 2.04 response code will not be printed to the terminal.  Publish some JSON data for device 4711, indicating that the device will wait for 10 seconds to receive the response:\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret -m POST coaps://hono.eclipseprojects.io/event?hono-ttd=10 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}' { \u0026quot;brightness\u0026quot;: 87 }   Note In the example above the response actually contains payload that should be used as input to a command to be executed by the device. This is just for illustrative purposes. You will usually get an empty response because there is no downstream application attached which could send any commands to the device.  Publish an Event (unauthenticated Device)  URI: /event/${tenantId}/${deviceId} Method: PUT Type:CON Request Options:  (optional) content-format: The type of payload contained in the request body. Required, if request contains payload.  Query Parameters:  (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) empty: Marks the request as an empty notification.  Request Body:  (optional) Arbitrary payload encoded according to the given content type. Maybe empty, if URI-query: empty is provided.  Response Options:  (optional) content-format: A media type describing the semantics and format of payload contained in the response body. This option will only be present if the response contains a command to be executed by the device which requires input data. Note that this option will be empty if the media type contained in the command (AMQP) message\u0026rsquo;s content-type property cannot be mapped to one of the registered CoAP content-format codes. (optional) location-query: The hono-command query parameter contains the name of the command to execute. This option will only be present if the response contains a command to be executed by the device. (optional) location-path: The location path is command for one-way-commands and command_response/\u0026lt;command-request-id\u0026gt; for commands expecting a response. In the latter case, the location-path option contains exactly the URI-path that the device must use when sending its response to the command. This option will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content). (optional) Error details, if status code is \u0026gt;= 4.00.  Response Codes:  2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for the device to execute. Note that if the message type is NON (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer (yet). However, if the message type is CON (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 4.00 (Bad Request): The request cannot be processed. Possible reasons include:  the request body is empty and the URI-query option doesn\u0026rsquo;t contain the empty parameter  4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_COAP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711 using default message type CON (at least once):\ncoap-client -m PUT coap://hono.eclipseprojects.io/event/DEFAULT_TENANT/4711 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4711, indicating that the device will wait for 10 seconds to receive the response:\ncoap-client -m PUT coap://hono.eclipseprojects.io/event/DEFAULT_TENANT/4711?hono-ttd=10 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}' { \u0026quot;brightness\u0026quot;: 87 }  Publish an Event (authenticated Gateway)  URI: /event/${tenantId}/${deviceId} Method: PUT Type:CON Request Options:  (optional) content-format: The type of payload contained in the request body. Required, if request contains payload.  Query Parameters:  (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) empty: Marks the request as an empty notification.  Request Body:  (optional) Arbitrary payload encoded according to the given content type. Maybe empty, if URI-query: empty is provided.  Response Options:  (optional) content-format: A media type describing the semantics and format of payload contained in the response body. This option will only be present if the response contains a command to be executed by the device which requires input data. Note that this option will be empty if the media type contained in the command (AMQP) message\u0026rsquo;s content-type property cannot be mapped to one of the registered CoAP content-format codes. (optional) location-query: The hono-command query parameter contains the name of the command to execute. This option will only be present if the response contains a command to be executed by the device. (optional) location-path: The location path is command/${tenantId}/${deviceId} for one-way-commands and command_response/${tenantId}/${deviceId}/\u0026lt;command-request-id\u0026gt; for commands expecting a response. In the latter case, the location-path option contains exactly the URI-path that the device must use when sending its response to the command. Note that in both cases the ${tenantId}/${deviceId} path segments indicate the device that the command is targeted at. This option will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content). (optional) Error details, if status code is \u0026gt;= 4.00.  Response Codes:  2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for a device to execute. Note that if the message type is NON (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer (yet). However, if the message type is CON (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 4.00 (Bad Request): The request cannot be processed. Possible reasons include:  the request body is empty and the URI-query option doesn\u0026rsquo;t contain the empty parameter  4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The tenant that the gateway belongs to is not allowed to use this protocol adapter. The device belongs to another tenant than the gateway. The gateway is not authorized to act on behalf of the device. The gateway associated with the device is not registered or disabled.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This resource can be used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nPublish some JSON data for device 4712 using default message type CON (at least once):\ncoap-client -u gw@DEFAULT_TENANT -k gw-secret -m PUT coaps://hono.eclipseprojects.io/event/DEFAULT_TENANT/4712 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4712, indicating that the gateway will wait for 10 seconds to receive the response:\ncoap-client -u gw@DEFAULT_TENANT -k gw-secret -m PUT coaps://hono.eclipseprojects.io/event/DEFAULT_TENANT/4712?hono-ttd=10 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}' { \u0026quot;brightness\u0026quot;: 87 }  NB The examples above assume that a gateway device has been registered with psk credentials with auth-id gw and secret gw-secret which is authorized to publish data on behalf of device 4712.\nCommand \u0026amp; Control The CoAP adapter enables devices to receive commands that have been sent by business applications. Commands are delivered to the device by means of a response message. That means a device first has to send a request, indicating how long it will wait for the response. That request can either be a telemetry or event message, with a hono-ttd query parameter (ttd for time till disconnect) specifying the number of seconds the device will wait for the response. The business application can react on that message by sending a command message, targeted at the device. The CoAP adapter will then send the command message as part of the response message to the device.\nCommands handled by gateways Authenticated gateways will receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway. Corresponding devices have to be configured so that they can be used with a gateway. See Configuring Gateway Devices for details.\nA gateway can send a request with the hono-ttd query parameter on the /event or /telemetry URI, indicating its readiness to receive a command for any device it acts on behalf of. Note that in this case, the business application will be notified with the gateway id in the device_id property of the downstream message.\nAn authenticated gateway can also indicate its readiness to receive a command targeted at a specific device. For that, the /event/${tenantId}/${deviceId} or /telemetry/${tenantId}/${deviceId} URI is to be used, containing the id of the device to receive a command for. The business application will receive a notification with that device id.\nIf there are multiple concurrent requests with a hono-ttd query parameter, sent by the command target device and/or one or more of its potential gateways, the CoAP adapter will choose the device or gateway to send the command to as follows:\n A request done by the command target device or by a gateway specifically done for that device, has precedence. If there are multiple, concurrent such requests, the last one will get the command message (if received) in its response. Note that the other requests won\u0026rsquo;t be answered with a command message in their response event if the business application sent multiple command messages. That means commands for a single device can only be requested sequentially, not in parallel. If the above doesn\u0026rsquo;t apply, a single hono-ttd request on the /event or /telemetry URI, sent by a gateway that the command target device is configured for, will get the command message in its response. If there are multiple, concurrent such requests by different gateways, all configured for the command target device, the request by the gateway will be chosen, through which the target device has last sent a telemetry or event message. If the target device hasn\u0026rsquo;t sent a message yet and it is thereby unknown via which gateway the device communicates, then one of the requests will be chosen randomly to set the command in its response.  Sending a Response to a Command (authenticated Device) The device is authenticated using PSK.\n URI: /command_response/${commandRequestId} Method: POST Type: CON Request Options:  (optional) content-type: A media type describing the semantics and format of the payload contained in the request body. This option must be set if the result of processing the command on the device is non-empty. In this case the result data is contained in the request body.  Query Parameters:  (required) hono-cmd-status: An HTTP status code indicating the outcome of processing the command.  Request Body:  (optional) Arbitrary data representing the result of processing the command on the device.  Response Codes:  2.04 (Changed): The response has been successfully delivered to the application that has sent the command. 4.00 (Bad Request): The request cannot be processed because the command status or command request ID are missing/malformed. 4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed. Possible reasons for this include:  There is no application listening for a reply to the given commandRequestId. The application has already given up on waiting for a response.    This is the preferred way for devices to respond to commands. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).\nExample\nSend a response to a previously received command with the command-request-id req-id-uuid for device 4711:\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret coaps://hono.eclipseprojects.io/command_response/req-id-uuid?hono-cmd-status=200  Sending a Response to a Command (unauthenticated Device)  URI: /command_response/${tenantId}/${deviceId}/${commandRequestId} Method: PUT Type: CON Request Options:  (optional) content-type: A media type describing the semantics and format of the payload contained in the request body. This option must be set if the result of processing the command on the device is non-empty. In this case the result data is contained in the request body.  Query Parameters:  (required) hono-cmd-status: An HTTP status code indicating the outcome of processing the command.  Request Body:  (optional) Arbitrary data representing the result of processing the command on the device.  Response Codes:  2.04 (Changed): The response has been successfully delivered to the application that has sent the command. 4.00 (Bad Request): The request cannot be processed because the command status or command request ID are missing/malformed. 4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed. Possible reasons for this include:  There is no application listening for a reply to the given commandRequestId. The application has already given up on waiting for a response.    This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_HTTP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nSend a response to a previously received command with the command-request-id req-id-uuid for the unauthenticated device 4711:\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret coaps://hono.eclipseprojects.io/command_response/DEFAULT_TENANT/4711/req-id-uuid?hono-cmd-status=200 -e '{\u0026quot;brightness-changed\u0026quot;: true}'  Sending a Response to a Command (authenticated Gateway)  URI: /command_response/${tenantId}/${deviceId}/${commandRequestId} Method: PUT Type: CON Request Options:  (optional) content-type: A media type describing the semantics and format of the payload contained in the request body. This option must be set if the result of processing the command on the device is non-empty. In this case the result data is contained in the request body.  Query Parameters:  (required) hono-cmd-status: An HTTP status code indicating the outcome of processing the command.  Request Body:  (optional) Arbitrary data representing the result of processing the command on the device.  Response Codes:  2.04 (Changed): The response has been successfully delivered to the application that has sent the command. 4.00 (Bad Request): The request cannot be processed because the command status or command request ID are missing/malformed. 4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant. The gateway is not authorized to act on behalf of the device. The gateway associated with the device is not registered or disabled.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed. Possible reasons for this include:  There is no application listening for a reply to the given commandRequestId. The application has already given up on waiting for a response.    This resource can be used by gateway components to send the response to a command on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to send responses to a command on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nSend a response to a previously received command with the command-request-id req-id-uuid for device 4712:\ncoap-client -u gw@DEFAULT_TENANT -k gw-secret coaps://hono.eclipseprojects.io/command_response/DEFAULT_TENANT/4712/req-id-uuid?hono-cmd-status=200 -e '{\u0026quot;brightness-changed\u0026quot;: true}'  NB The example above assumes that a gateway device has been registered with psk credentials with auth-id gw and secret gw-secret which is authorized to publish data on behalf of device 4712.\nDownstream Meta Data The adapter includes the following meta data in the application properties of messages being sent downstream:\n   Name Type Description     device_id string The identifier of the device that the message originates from.   orig_adapter string Contains the adapter\u0026rsquo;s type name which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The CoAP adapter\u0026rsquo;s type name is hono-coap.   orig_address string Contains the (relative) URI that the device has originally posted the data to.   ttd integer Contains the effective number of seconds that the device will wait for a response. This property is only set if the request contains the hono-ttd URI-query option.    The adapter also considers defaults registered for the device at either the tenant or the device level. The values of the default properties are determined as follows:\n If the message already contains a non-empty property of the same name, the value if unchanged. Otherwise, if a default property of the same name is defined in the device\u0026rsquo;s registration information, that value is used. Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.  Note that of the standard AMQP 1.0 message properties only the content-type and ttl can be set this way to a default value.\nEvent Message Time-to-live Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers. In most cases the AMQP Messaging Network can be configured with a maximum time-to-live to apply to the events so that the events will be removed from the persistent store if no consumer has attached to receive the event before the message expires.\nIn order to support environments where the AMQP Messaging Network cannot be configured accordingly, the protocol adapter supports setting a downstream event message\u0026rsquo;s ttl property based on the hono-ttl property set as a query parameter in the event requests by the devices. Also the default ttl and max-ttl values can be configured for a tenant/device as described in the Tenant API.\nTenant specific Configuration The adapter uses the Tenant API to retrieve tenant specific configuration for adapter type hono-coap. The following properties are (currently) supported:\n   Name Type Default Value Description     enabled boolean true If set to false the adapter will reject all data from devices belonging to the tenant.   max-ttd integer 60 Defines a tenant specific upper limit for the time until disconnect property that devices may include in requests for uploading telemetry data or events. Please refer to the Command \u0026amp; Control concept page for a discussion of this parameter\u0026rsquo;s purpose and usage.\nThis property can be set for the hono-coap adapter type as an extension property in the adapter section of the tenant configuration.\nIf it is not set, then the default value of 60 seconds is used.   "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/user-guide/kura-adapter/",
+	"title": "Kura Adapter",
+	"tags": [],
+	"description": "",
+	"content": "The Kura protocol adapter exposes an MQTT topic hierarchy allowing Eclipse Kura\u0026trade; based gateways to publish control and data messages to Eclipse Hono\u0026trade;\u0026rsquo;s Telemetry and Event endpoints.\n Note The Kura adapter is supposed to be used with gateways running Kura version 3.x. Gateways running Kura version 4 and later should connect to the MQTT adapter instead.  The Kura adapter by default requires devices (gateways) to authenticate during connection establishment. In order to do so, gateways need to provide a username and a password in the MQTT CONNECT packet. The username must have the form auth-id@tenant, e.g. sensor1@DEFAULT_TENANT. The adapter verifies the credentials provided by the gateway against the credentials the configured Credentials service has on record for the gateway. The adapter uses the Credentials API\u0026rsquo;s get operation to retrieve the credentials-on-record with the tenant and auth-id provided by the device in the username and hashed-password as the type of secret as query parameters.\nPlease refer to the Eclipse Kura documentation on how to configure the gateway\u0026rsquo;s cloud service connection accordingly. It is important to set the gateway\u0026rsquo;s topic.context.account-name to the ID of the Hono tenant that the gateway has been registered with whereas the gateway\u0026rsquo;s client-id needs to be set to the corresponding Hono device ID. The auth-id used as part of the gateway\u0026rsquo;s username property needs to match the authentication identifier of a set of credentials registered for the device ID in Hono\u0026rsquo;s Credentials service. In other words, the credentials configured on the gateway need to belong to the corresponding device ID.\nAfter verifying the credentials, the number of existing connections and the overall amount of time that the devices have already been connected are checked against the configured resource-limits by the Kura adapter. If the limit is exceeded then a return code 0x05 indicating Connection Refused: not authorised is sent back.\nOnce the gateway has established a connection to the Kura adapter, all control and data messages published by applications running on the gateway are sent to the adapter and mapped to Hono\u0026rsquo;s Telemetry and Event API endpoints as follows:\n The adapter treats all messages that are published to a topic starting with the configured HONO_KURA_CONTROL_PREFIX as control messages. All other messages are considered to be data messages. control messages with QoS 0 are forwarded to Hono\u0026rsquo;s telemetry endpoint whereas messages with QoS 1 are forwarded to the event endpoint. The corresponding AMQP 1.0 messages that are sent downstream have a content type of application/vnd.eclipse.kura-control. data messages with QoS 0 are forwarded to the telemetry endpoint whereas messages with QoS 1 are forwarded to the event endpoint. The corresponding AMQP 1.0 messages that are sent downstream have a content type of application/vnd.eclipse.kura-data.  Downstream Meta Data The adapter includes the following meta data in messages being sent downstream:\n   Name Location Type Description     device_id application string The identifier of the device that the message originates from.   orig_adapter application string Contains the adapter\u0026rsquo;s type name which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The Kura adapter\u0026rsquo;s type name is hono-kura-mqtt.   orig_address application string Contains the name of the MQTT topic that the Kura gateway has originally published the data to.    The adapter also considers defaults registered for the device at either the tenant or the device level. The values of the default properties are determined as follows:\n If the message already contains a non-empty property of the same name, the value if unchanged. Otherwise, if a default property of the same name is defined in the device\u0026rsquo;s registration information, that value is used. Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.  Note that of the standard AMQP 1.0 message properties only the content-type and ttl can be set this way to a default value.\nEvent Message Time-to-live Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers. In most cases the AMQP Messaging Network can be configured with a maximum time-to-live to apply to the events so that the events will be removed from the persistent store if no consumer has attached to receive the event before the message expires.\nIn order to support environments where the AMQP Messaging Network cannot be configured accordingly, the protocol adapter supports setting a downstream event message\u0026rsquo;s ttl property based on the default ttl and max-ttl values configured for a tenant/device as described in the Tenant API.\nTenant specific Configuration The adapter uses the Tenant API to retrieve tenant specific configuration for adapter type hono-kura-mqtt. The following properties are (currently) supported:\n   Name Type Default Value Description     enabled boolean true If set to false the adapter will reject all data from devices belonging to the tenant.   "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/user-guide/sigfox-adapter/",
+	"title": "Sigfox Adapter",
+	"tags": [],
+	"description": "",
+	"content": "The Sigfox protocol adapter exposes an HTTP endpoint for connecting up with the Sigfox backend for publishing telemetry, events and use command \u0026amp; control.\n Tech preview This protocol adapter is not considered production ready. Its APIs might still be subject to change without warning.  Pre-requisites This Sigfox adapter only connects to the Sigfox backend system (backend.sigfox.com). It does not allow direct access to Sigfox devices.\nSo you need to set up your Sigfox devices on backend.sigfox.com and then configure the callbacks connect to your installation of Hono.\nDevices and credentials In a nutshell, the Sigfox adapter requires a single device identity, acting as a gateway device. This identity will be used to connect to Hono. All devices registered with Sigfox (the actual Sigfox devices), will be registered in Hono to allow this first identity as their gateway device.\nSetup example The following sub-sections walk you through an example setup.\nRegistering devices This example assumes that the Sigfox protocol adapter is available as https://iot-sigfox-adapter.my.hono.\nCreate a new gateway device with the following registration:\n{ \u0026quot;device-id\u0026quot;: \u0026quot;sigfox-backend\u0026quot; }  Create new credentials for the gateway device. For example, using a username of sigfox and a password of test12:\n{ \u0026quot;auth-id\u0026quot;: \u0026quot;sigfox\u0026quot;, \u0026quot;device-id\u0026quot;: \u0026quot;sigfox-backend\u0026quot;, \u0026quot;enabled\u0026quot;: true, \u0026quot;secrets\u0026quot;: [ { \u0026quot;pwd-plain\u0026quot;: \u0026quot;test12\u0026quot;, } ], \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot; }  Create a new device, referencing the previous gateway device. The device id must be your Sigfox device ID (e.g. 1AB2C3):\n{ \u0026quot;device-id\u0026quot;: \u0026quot;1AB2C3\u0026quot;, \u0026quot;via\u0026quot;: \u0026quot;sigfox-backend\u0026quot; }  Setting up callbacks Log in to the Sigfox backend at https://backend.sigfox.com and then open up the view Device Type -\u0026gt; Callbacks.\nCreate a new \u0026ldquo;Custom\u0026rdquo; callback, with the following settings (replacing \u0026lt;TENANT\u0026gt; with the name of the tenant):\n Type: DATA – UPLINK Channel: URL Url pattern: https://iot-sigfox-adapter.my.hono/data/telemetry/\u0026lt;TENANT\u0026gt;?device={device}\u0026amp;data={data} Use HTTP Method: GET Headers  Authorization – Basic … (see note below)  Send SNI: ☑ (Enabled)   Credentials At the moment you need to manually put in the Authorization header, you cannot put the credentials into the URL, as there is a bug in the Sigfox backend, which cannot be fixed by Hono. The backend does not properly escape the @ character, and thus sends foo%40tenant instead of foo@tenant to the Hono protocol adapter.\nAs a workaround, you can explicitly set the Authorization header to a value of Basic \u0026lt;base64 encoded credentials\u0026gt;. You can encode the credentials using:\necho -n \u0026quot;sigfox@tenant:password\u0026quot; | base64  To get the full value, including the Basic you may use:\necho \u0026quot;Basic $(echo -n \u0026quot;sigfox@tenant:password\u0026quot; | base64)\u0026quot;    Enabling command \u0026amp; control It is possible to enable command \u0026amp; control as well. For this you need to:\n Switch the Type of the DATA callback from UPLINK to BIDIR Add the ack query parameter to the Url pattern, e.g. https://iot-sigfox-adapter.my.hono/data/telemetry/\u0026lt;TENANT\u0026gt;?device={device}\u0026amp;data={data}\u0026amp;ack={ack}   Command requirements Sigfox allows only a very specific payload in command messages. You must send exactly 8 bytes of data. It only supports one way commands.  Events You can send events by using the path /data/event on the URL.\nConsuming data Use the standard way of consuming Hono messages.\nKnown bugs and limitations  Only the simple URL and only data (no service or device events are currently supported. "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/user-guide/jmeter_load_tests/",
+	"title": "Load Tests with JMeter",
+	"tags": [],
+	"description": "",
+	"content": "Eclipse Hono\u0026trade; comes with an Apache JMeter plugin which provides samplers that can be used in JMeter test plans to send and receive telemetry/event data.\nThe plugin provides a Hono Receiver Sampler which can be used together with JMeter\u0026rsquo;s standard HTTP Sampler and XMeter\u0026rsquo;s JMeter plugin for MQTT to play the roles of a downstream application (consumer) and devices uploading data to the HTTP and MQTT protocol adapters. The diagram below illustrates how the components are related to each other.\n  JMeter with Hono   Installation  Install JMeter Copy the plugin jar file \u0026lt;hono-installation\u0026gt;/jmeter/target/plugin/hono-jmeter-\u0026lt;version\u0026gt;-jar-with-dependencies.jar to the \u0026lt;jmeter-installation\u0026gt;/lib/ext folder. Start JMeter  Example Test Plans The \u0026lt;hono-installation\u0026gt;/jmeter/src/jmeter folder contains several JMeter test plans which you can use as a basis for your own tests. All test plans can be run against Hono\u0026rsquo;s example deployment.\n http_messaging_throughput_test.jmx runs a set of HTTP clients and AMQP 1.0 consumers for a given period of time. The senders publish data to Hono\u0026rsquo; HTTP adapter while the consumers receive messages from the AMQP 1.0 Messaging Network (in case of the example installation this is the Qpid Dispatch Router). The test plan measures the number of messages that are sent/received during the test execution. mqtt_messaging_throughput_test.jmx runs a set of MQTT clients and AMQP 1.0 consumers for a given period of time. The clients publish data to Hono\u0026rsquo; MQTT adapter while the consumers receive messages from the AMQP 1.0 Messaging Network (in case of the example installation this is the Qpid Dispatch Router). The test plan measures the number of messages that are sent/received during the test execution. To use this plan you also need to add the JMeter plugin for MQTT to your JMeter plugin path. amqp_messaging_throughput_test.jmx runs a set of AMQP 1.0 senders and consumers for a given period of time. The senders publish data to the AMQP 1.0 Messaging Network directly while the consumers receive messages from the AMQP 1.0 Messaging Network (in case of the example installation this is the Qpid Dispatch Router). The test plan measures the number of messages that are sent/received during the test execution.\nThe sender can be configured to wait for n active receivers (from this test plan and JMeter instance) which can be used to make sure, that the receivers consuming from the corresponding address (e.g. telemetry/DEFAULT_TENANT) are up and running before the senders begin to publish messages.  It is recommended to run the test plans in non-gui mode as illustrated by the example shell scripts that are contained in the \u0026lt;hono-installation\u0026gt;/jmeter/src/jmeter folder. You may need to adapt some of the properties to reflect your concrete setup, e.g. the path to the trust store, host names, ports etc.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/admin-guide/",
+	"title": "Admin Guide",
+	"tags": [],
+	"description": "",
+	"content": " Admin Guide Learn how to operate Eclipse Hono\u0026trade; and look up the configuration options of its components.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/admin-guide/common-config/",
+	"title": "Common Configuration",
+	"tags": [],
+	"description": "",
+	"content": "Many Hono components support a common set of configuration options. This section describes those options.\nEach component which supports the following options explicitly states so. If it doesn\u0026rsquo;t, then these options are not supported by this component.\nJava VM Options The Java VM started in Hono\u0026rsquo;s components can be configured with arbitrary command line options by means of setting the JDK_JAVA_OPTIONS environment variable.\n   Environment Variable Mandatory Default Description     JDK_JAVA_OPTIONS no - Any options that should be passed to the Java VM on the command line, e.g. -Xmx128m    Vert.x Options The vert.x framework instance used to run Hono\u0026rsquo;s components on can be configured using the following environment variables or corresponding command line options:\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_VERTX_DNS_QUERY_TIMEOUT\n--hono.vertx.dnsQueryTimeout no 5000 The amount of time (in milliseconds) after which a DNS query is considered to be failed. Setting this variable to a smaller value may help to reduce the time required to establish connections to the services this adapter depends on. However, setting it to a value that is too small for any DNS query to succeed will effectively prevent any connections to be established at all.   HONO_VERTX_MAX_EVENT_LOOP_EXECUTE_TIME_MILLIS\n--hono.vertx.maxEventLoopExecuteTimeMillis no 2000 The maximum number of milliseconds that a task on the event loop may run without being considered to block the event loop.   HONO_VERTX_PREFER_NATIVE\n--hono.vertx.preferNative no false Tries to enable epoll() support on Linux (if available). See the notes below for an explanation of the benefits of enabling epoll.    \nUsing epoll() on Linux Using epoll() on Linux may provide better performance for applications which have a high I/O throughput. Especially when the application supports an asynchronous I/O model. This is true for most Hono components and applications using Hono.\nThe Netty framework supports using epoll() on Linux x86_64 based systems. Hono provides the a Maven build profile for enabling support for epoll during the build process.\nIn order to use epoll\n Hono needs to be built with the netty-native-linux-x86_64 Maven profile enabled and the HONO_VERTX_PREFER_NATIVE environment variable needs to be set to true on startup.  Protocol Adapter Options AMQP 1.0 Messaging Network Connection Configuration Protocol adapters require a connection to the AMQP 1.0 Messaging Network in order to forward telemetry data and events received from devices to downstream consumers.\nThe connection to the messaging network is configured according to Hono Client Configuration with HONO_MESSAGING being used as ${PREFIX}. Since there are no responses being received, the properties for configuring response caching can be ignored.\nCommand \u0026amp; Control Connection Configuration Protocol adapters require an additional connection to the AMQP 1.0 Messaging Network in order to receive commands from downstream applications and send responses to commands back to applications.\nThe connection is configured according to Hono Client Configuration with HONO_COMMAND being used as ${PREFIX}. The properties for configuring response caching can be ignored.\nTenant Service Connection Configuration Protocol adapters require a connection to an implementation of Hono\u0026rsquo;s Tenant API in order to retrieve information for a tenant.\nThe connection to the Tenant Service is configured according to Hono Client Configuration where the ${PREFIX} is set to HONO_TENANT and the additional values for response caching apply.\nThe adapter caches the responses from the service according to the cache directive included in the response. If the response doesn\u0026rsquo;t contain a cache directive no data will be cached.\nDevice Registration Service Connection Configuration Protocol adapters require a connection to an implementation of Hono\u0026rsquo;s Device Registration API in order to retrieve registration status assertions for connected devices.\nThe connection to the Device Registration Service is configured according to Hono Client Configuration where the ${PREFIX} is set to HONO_REGISTRATION.\nThe adapter caches the responses from the service according to the cache directive included in the response. If the response doesn\u0026rsquo;t contain a cache directive no data will be cached.\nCredentials Service Connection Configuration Protocol adapters require a connection to an implementation of Hono\u0026rsquo;s Credentials API in order to retrieve credentials stored for devices that needs to be authenticated. During connection establishment, the adapter uses the Credentials API to retrieve the credentials on record for the device and matches that with the credentials provided by a device.\nThe connection to the Credentials Service is configured according to Hono Client Configuration where the ${PREFIX} is set to HONO_CREDENTIALS.\nThe adapter caches the responses from the service according to the cache directive included in the response. If the response doesn\u0026rsquo;t contain a cache directive no data will be cached.\nDevice Connection Service Connection Configuration Protocol adapters require a connection to an implementation of Hono\u0026rsquo;s Device Connection API in order to determine the gateway that a device is connected via to a protocol adapter. This information is required in order to forward commands issued by applications to the protocol adapter instance that the gateway is connected to.\nThe connection to the Device Connection service is configured according to Hono Client Configuration where the ${PREFIX} is set to HONO_DEVICECONNECTION.\nResponses from the Device Connection service are never cached, so the properties for configuring the cache are ignored.\nDirect Connection to Data Grid Protocol adapters can alternatively be configured to directly access an data grid for storing and retrieving device connection information using Infinispan\u0026rsquo;s Hotrod protocol. This has the advantage of saving the network hop to the Device Connection service. However, this is only beneficial if the Device Connection service implementation itself uses a remote service (like a data grid) for storing the data.\nThe following table provides an overview of the configuration variables and corresponding command line options for configuring the connection to the data grid:\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_DEVICECONNECTION_SERVER_LIST\n--hono.deviceConnection.serverList yes - A list of remote servers in the form: host1[:port][;host2[:port]].....   HONO_DEVICECONNECTION_AUTH_SERVER_NAME\n--hono.deviceConnection.authServerName yes - The server name to indicate in the SASL handshake when authenticating to the server.   HONO_DEVICECONNECTION_AUTH_USERNAME\n--hono.deviceConnection.authUsername yes - The username to use for authenticating to the server.   HONO_DEVICECONNECTION_AUTH_PASSWORD\n--hono.deviceConnection.authPassword yes - The password to use for authenticating to the server.    In general, the service supports all configuration properties of the Infinispan Hotrod client using hono.deviceConnection instead of the infinispan.client.hotrod prefix.\nResource Limits Checker Configuration The adapter can use metrics collected by a Prometheus server to enforce certain limits set at the tenant level like the overall number of connected devices allowed per tenant.\nThe following table provides an overview of the configuration variables and corresponding command line options for configuring the checker.\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     HONO_RESOURCELIMITS_PROMETHEUSBASED_HOST\n--hono.resourceLimits.prometheusBased.host no localhost The host name or IP address of the Prometheus server to retrieve the metrics data from. This property needs to be set in order to enable the Prometheus based checks.   HONO_RESOURCELIMITS_PROMETHEUSBASED_PORT\n--hono.resourceLimits.prometheusBased.port no 9090 The port of the Prometheus server to retrieve metrics data from.   HONO_RESOURCELIMITS_PROMETHEUSBASED_CACHE_MIN_SIZE\n--hono.resourceLimits.prometheusBased.cacheMinSize no 20 The minimum size of the cache to store the metrics data retrieved from the Prometheus server. The cache is used for storing the current amount of data exchanged with devices of tenants.   HONO_RESOURCELIMITS_PROMETHEUSBASED_CACHE_MAX_SIZE\n--hono.resourceLimits.prometheusBased.cacheMaxSize no 1000 The maximum size of the cache to store the metrics data retrieved from the Prometheus server.   HONO_RESOURCELIMITS_PROMETHEUSBASED_CACHE_TIMEOUT\n--hono.resourceLimits.prometheusBased.cacheTimeout no 600 The number of seconds after which the cached metrics data should be considered invalid.    In addition to the properties listed above, the resource limit checker also supports the properties listed below as documented in the Hono Client Configuration. These properties might be useful if a reverse proxy in front of the Prometheus server requires the client to use TLS and/or provide credentials for authentication.\n HONO_RESOURCELIMITS_PROMETHEUSBASED_CREDENTIALSPATH HONO_RESOURCELIMITS_PROMETHEUSBASED_HOSTNAMEVERIFICATIONREQUIRED HONO_RESOURCELIMITS_PROMETHEUSBASED_KEYPATH HONO_RESOURCELIMITS_PROMETHEUSBASED_KEYSTOREPASSWORD HONO_RESOURCELIMITS_PROMETHEUSBASED_KEYSTOREPATH HONO_RESOURCELIMITS_PROMETHEUSBASED_PASSWORD HONO_RESOURCELIMITS_PROMETHEUSBASED_SECUREPROTOCOLS HONO_RESOURCELIMITS_PROMETHEUSBASED_TLSENABLED HONO_RESOURCELIMITS_PROMETHEUSBASED_TRUSTSTOREPATH HONO_RESOURCELIMITS_PROMETHEUSBASED_TRUSTSTOREPASSWORD HONO_RESOURCELIMITS_PROMETHEUSBASED_USERNAME "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/admin-guide/auth-server-config/",
+	"title": "Auth Server Configuration",
+	"tags": [],
+	"description": "",
+	"content": "The Auth Server component exposes a service endpoint implementing Eclipse Hono\u0026trade;\u0026rsquo;s Authentication API. Other services use this component for authenticating clients and retrieving a token asserting the client\u0026rsquo;s identity and corresponding authorities.\nThis component serves as a default implementation of the Authentication API only. On startup, it reads in all identities and their authorities from a JSON file from the file system. All data is then kept in memory and there are no remote service APIs for managing the identities and their authorities.\nThe Auth Server is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nService Configuration In addition to the following options, this component supports the options described in Common Configuration.\nThe server can be configured by means of environment variables or corresponding command line options. The following table provides an overview of the configuration variables and corresponding command line options that the server supports:\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_APP_MAX_INSTANCES\n--hono.app.maxInstances no #CPU cores The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.   HONO_AUTH_AMQP_BIND_ADDRESS\n--hono.auth.amqp.bindAddress no 127.0.0.1 The IP address of the network interface that the secure port should be bound to.\nSee Port Configuration below for details.   HONO_AUTH_AMQP_CERT_PATH\n--hono.auth.amqp.certPath no - The absolute path to the PEM file containing the certificate that the server should use for authenticating to clients. This option must be used in conjunction with HONO_AUTH_AMQP_KEY_PATH.\nAlternatively, the HONO_AUTH_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_AUTH_AMQP_INSECURE_PORT\n--hono.auth.amqp.insecurePort no - The insecure port the server should listen on.\nSee Port Configuration below for details.   HONO_AUTH_AMQP_INSECURE_PORT_BIND_ADDRESS\n--hono.auth.amqp.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure port should be bound to.\nSee Port Configuration below for details.   HONO_AUTH_AMQP_INSECURE_PORT_ENABLED\n--hono.auth.amqp.insecurePortEnabled no false If set to true the server will open an insecure port (not secured by TLS) using either the port number set via HONO_AUTH_AMQP_INSECURE_PORT or the default AMQP port number (5672) if not set explicitly.\nSee Port Configuration below for details.   HONO_AUTH_AMQP_KEY_PATH\n--hono.auth.amqp.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the server should use for authenticating to clients. Note that the private key is not protected by a password. You should therefore make sure that the key file can only be read by the user that the server process is running under. This option must be used in conjunction with HONO_AUTH_CERT_PATH.\nAlternatively, the HONO_AUTH_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_AUTH_AMQP_KEY_STORE_PASSWORD\n--hono.auth.amqp.keyStorePassword no - The password required to read the contents of the key store.   HONO_AUTH_AMQP_KEY_STORE_PATH\n--hono.auth.amqp.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the server should use for authenticating to clients. Either this option or the HONO_AUTH_AMQP_KEY_PATH and HONO_AUTH_AMQP_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_AUTH_AMQP_NATIVE_TLS_REQUIRED\n--hono.auth.amqp.nativeTlsRequired no false The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_AUTH_AMQP_PORT\n--hono.auth.amqp.port no 5671 The secure port that the server should listen on.\nSee Port Configuration below for details.   HONO_AUTH_AMQP_SECURE_PROTOCOLS\n--hono.auth.amqp.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   HONO_AUTH_AMQP_TRUST_STORE_PASSWORD\n--hono.auth.amqp.trustStorePassword no - The password required to read the contents of the trust store.   HONO_AUTH_AMQP_TRUST_STORE_PATH\n--hono.auth.amqp.trustStorePath no - The absolute path to the Java key store containing the CA certificates the service uses for authenticating clients. The key store format can be either JKS, PKCS12 or PEM indicated by a .jks, .p12 or .pem file suffix respectively.   HONO_AUTH_SVC_PERMISSIONS_PATH\n--hono.auth.svc.permissionsPath no classpath:/\npermissions.json The Spring resource URI of the JSON file defining the identities and corresponding authorities on Hono\u0026rsquo;s endpoint resources. The default file bundled with the Auth Server defines authorities required by protocol adapters and downstream consumer. The default permissions file should only be used for evaluation purposes.   HONO_AUTH_SVC_SIGNING_KEY_PATH\n--hono.auth.svc.signing.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the server should use for signing tokens asserting an authenticated client\u0026rsquo;s identity and authorities. When using this variable, other services that need to validate the tokens issued by this service need to be configured with the corresponding certificate/public key. Alternatively, a symmetric key can be used for signing (and validating) by setting the HONO_AUTH_SVC_SIGNING_SHARED_SECRET variable. If none of these variables is set, the server falls back to the key indicated by the HONO_AUTH_AMQP_KEY_PATH variable. If that variable is also not set, startup of the server fails.   HONO_AUTH_SVC_SIGNING_SHARED_SECRET\n--hono.auth.svc.signing.sharedSecret no - A string to derive a symmetric key from that is used for signing tokens asserting an authenticated client\u0026rsquo;s identity and authorities. The key is derived from the string by using the bytes of the String\u0026rsquo;s UTF8 encoding. When setting the signing key using this variable, other services that need to validate the tokens issued by this service need to be configured with the same key. Alternatively, an asymmetric key pair can be used for signing (and validating) by setting the HONO_AUTH_SVC_SIGNING_KEY_PATH variable. If none of these variables is set, startup of the server fails.   HONO_AUTH_SVC_SIGNING_TOKEN_EXPIRATION\n--hono.auth.svc.signing.tokenExpiration no 600 The number of seconds after which the tokens created by this service for asserting an authenticated client\u0026rsquo;s identity should be considered invalid. Other Hono components will close AMQP connections with clients after this period in order to force the client to authenticate again and create a new token. In closed environments it should be save to set this value to a much higher value, e.g. several hours.   HONO_AUTH_SVC_SUPPORTED_SASL_MECHANISMS\n--hono.auth.svc.supportedSaslMechanisms no EXTERNAL, PLAIN A (comma separated) list of the supported SASL mechanisms to be advertised to clients. This option may be set to specify only one of EXTERNAL or PLAIN, or to use a different order.    The variables only need to be set if the default value does not match your environment.\nPort Configuration The Auth Server can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The server will fail to start if none of the ports is configured properly.\nSecure Port Only The server needs to be configured with a private key, a certificate holding the public key and a trust store in order to open a TLS secured port.\nThere are two alternative ways for setting the private key and certificate:\n Setting the HONO_AUTH_AMQP_KEY_STORE_PATH and the HONO_AUTH_AMQP_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_AUTH_AMQP_KEY_PATH and HONO_AUTH_AMQP_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  In order to set the trust store, the HONO_AUTH_AMQP_TRUST_STORE_PATH variable needs to be set to a key store containing the trusted root CA certificates. The HONO_AUTH_AMQP_TRUST_STORE_PASSWORD variable needs to be set if the key store requires a pass phrase for reading its contents.\nWhen starting up, the server will bind a TLS secured socket to the default secure AMQP port 5671. The port number can also be set explicitly using the HONO_AUTH_AMQP_PORT variable.\nThe HONO_AUTH_AMQP_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_AUTH_AMQP_INSECURE_PORT to a valid port number, or by implicitly configuring the default AMQP port (5672) by simply setting HONO_AUTH_AMQP_INSECURE_PORT_ENABLED to true.  The server issues a warning on the console if HONO_AUTH_AMQP_INSECURE_PORT is set to the default secure AMQP port (5671).\nThe HONO_AUTH_AMQP_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port In test setups and some production scenarios Hono server may be configured to open one secure and one insecure port at the same time.\nThis is achieved by configuring both ports correctly (see above). The server will fail to start if both ports are configured to use the same port number.\nSince the secure port may need different visibility in the network setup compared to the secure port, it has it\u0026rsquo;s own binding address HONO_AUTH_AMQP_INSECURE_PORT_BIND_ADDRESS. This can be used to narrow the visibility of the insecure port to a local network e.g., while the secure port may be visible worldwide.\nEphemeral Ports The server may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nMetrics Configuration See Monitoring \u0026amp; Tracing Admin Guide for details on how to configure the reporting of metrics.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/admin-guide/device-registry-config/",
+	"title": "Device Registry Configuration",
+	"tags": [],
+	"description": "",
+	"content": "The Device Registry component provides an exemplary implementation of Eclipse Hono\u0026trade;\u0026rsquo;s Device Registration, Credentials, Tenant and Device Connection APIs.\nProtocol adapters use these APIs to determine a device\u0026rsquo;s registration status, e.g. if it is enabled and if it is registered with a particular tenant, and to authenticate a device before accepting any data for processing from it.\nThere is no particular technical reason to implement these three APIs in one component, so for production scenarios there might be up to three different components each implementing one of the API\u0026rsquo;s.\nThe Device Registry component also exposes HTTP based resources for managing tenants and the registration information and credentials of devices.\nThe Device Registry is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nService Configuration In addition to the following options, this component supports the options described in Common Configuration.\nThe following table provides an overview of the configuration variables and corresponding command line options for configuring the Device Registry.\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_APP_TYPE\n--hono.app.type no file The device registry implementation to use. This may be either file or dummy. In the case of dummy a dummy implementation will be used which will consider all devices queried for as valid devices, having the access credentials hono-secret. Of course this shouldn\u0026rsquo;t be used for productive use.   HONO_CREDENTIALS_SVC_CACHE_MAX_AGE\n--hono.credentials.svc.cacheMaxAge no 180 The maximum period of time (seconds) that information returned by the service\u0026rsquo;s operations may be cached for.   HONO_CREDENTIALS_SVC_FILENAME\n--hono.credentials.svc.filename no /var/lib/hono/device-registry/\ncredentials.json The path to the file where the server stores credentials of devices. Hono tries to read credentials from this file during start-up and writes out all identities to this file periodically if property HONO_CREDENTIALS_SVC_SAVE_TO_FILE is set to true.\nPlease refer to Credentials File Format for details regarding the file\u0026rsquo;s format.   HONO_CREDENTIALS_SVC_HASH_ALGORITHMS_WHITELIST\n--hono.credentials.svc.hashAlgorithmsWhitelist no empty An array of supported hashing algorithms to be used with the hashed-password type of credentials. When not set, all values will be accepted.   HONO_CREDENTIALS_SVC_MAX_BCRYPT_ITERATIONS\n--hono.credentials.svc.maxBcryptIterations no 10 The maximum number of iterations that are supported in password hashes using the BCrypt hash function. This limit is enforced by the device registry when adding or updating corresponding credentials. Increasing this number allows for potentially more secure password hashes to be used. However, the time required to compute the hash increases exponentially with the number of iterations.   HONO_CREDENTIALS_SVC_MODIFICATION_ENABLED\n--hono.credentials.svc.modificationEnabled no true When set to false the credentials contained in the registry cannot be updated nor removed.   HONO_CREDENTIALS_SVC_RECEIVER_LINK_CREDIT\n--hono.credentials.svc.receiverLinkCredit no 100 The number of credits to flow to a client connecting to the Credentials endpoint.   HONO_CREDENTIALS_SVC_SAVE_TO_FILE\n--hono.credentials.svc.saveToFile no false When set to true the server will periodically write out the registered credentials to the file specified by the HONO_CREDENTIALS_SVC_FILENAME property.   HONO_CREDENTIALS_SVC_STARTEMPTY\n--hono.credentials.svc.startEmpty no false When set to true the server will not try to load credentials from the file specified by the HONO_CREDENTIALS_SVC_FILENAME property during startup.   HONO_DEVICE_CONNECTION_SVC_MAX_DEVICES_PER_TENANT\n--hono.deviceConnection.svc.maxDevicesPerTenant no 100 The number of devices per tenant for which connection related data is stored. It is an error to set this property to a value \u0026lt;= 0.   HONO_REGISTRY_AMQP_BIND_ADDRESS\n--hono.registry.amqp.bindAddress no 127.0.0.1 The IP address of the network interface that the secure AMQP port should be bound to.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_CERT_PATH\n--hono.registry.amqp.certPath no - The absolute path to the PEM file containing the certificate that the server should use for authenticating to clients. This option must be used in conjunction with HONO_REGISTRY_AMQP_KEY_PATH.\nAlternatively, the HONO_REGISTRY_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_REGISTRY_AMQP_INSECURE_PORT\n--hono.registry.amqp.insecurePort no - The insecure port the server should listen on for AMQP 1.0 connections.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_INSECURE_PORT_BIND_ADDRESS\n--hono.registry.amqp.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure AMQP port should be bound to.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_INSECURE_PORT_ENABLED\n--hono.registry.amqp.insecurePortEnabled no false If set to true the server will open an insecure port (not secured by TLS) using either the port number set via HONO_REGISTRY_AMQP_INSECURE_PORT or the default AMQP port number (5672) if not set explicitly.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_KEY_PATH\n--hono.registry.amqp.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the server should use for authenticating to clients. This option must be used in conjunction with HONO_REGISTRY_AMQP_CERT_PATH. Alternatively, the HONO_REGISTRY_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_REGISTRY_AMQP_KEY_STORE_PASSWORD\n--hono.registry.amqp.keyStorePassword no - The password required to read the contents of the key store.   HONO_REGISTRY_AMQP_KEY_STORE_PATH\n--hono.registry.amqp.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the server should use for authenticating to clients. Either this option or the HONO_REGISTRY_AMQP_KEY_PATH and HONO_REGISTRY_AMQP_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_REGISTRY_AMQP_NATIVE_TLS_REQUIRED\n--hono.registry.amqp.nativeTlsRequired no false The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_REGISTRY_AMQP_PORT\n--hono.registry.amqp.port no 5671 The secure port that the server should listen on for AMQP 1.0 connections.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_SECURE_PROTOCOLS\n--hono.registry.amqp.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   HONO_REGISTRY_REST_BIND_ADDRESS\n--hono.registry.rest.bindAddress no 127.0.0.1 The IP address of the network interface that the secure HTTP port should be bound to.\nSee Port Configuration below for details.   HONO_REGISTRY_REST_CERT_PATH\n--hono.registry.rest.certPath no - The absolute path to the PEM file containing the certificate that the server should use for authenticating to clients. This option must be used in conjunction with HONO_REGISTRY_REST_KEY_PATH.\nAlternatively, the HONO_REGISTRY_REST_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_REGISTRY_REST_INSECURE_PORT\n--hono.registry.rest.insecurePort no - The insecure port the server should listen on for HTTP requests.\nSee Port Configuration below for details.   HONO_REGISTRY_REST_INSECURE_PORT_BIND_ADDRESS\n--hono.registry.rest.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure HTTP port should be bound to.\nSee Port Configuration below for details.   HONO_REGISTRY_REST_INSECURE_PORT_ENABLED\n--hono.registry.rest.insecurePortEnabled no false If set to true the server will open an insecure port (not secured by TLS) using either the port number set via HONO_REGISTRY_REST_INSECURE_PORT or the default AMQP port number (5672) if not set explicitly.\nSee Port Configuration below for details.   HONO_REGISTRY_REST_KEY_PATH\n--hono.registry.rest.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the server should use for authenticating to clients. This option must be used in conjunction with HONO_REGISTRY_REST_CERT_PATH. Alternatively, the HONO_REGISTRY_REST_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_REGISTRY_REST_KEY_STORE_PASSWORD\n--hono.registry.rest.keyStorePassword no - The password required to read the contents of the key store.   HONO_REGISTRY_REST_KEY_STORE_PATH\n--hono.registry.rest.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the server should use for authenticating to clients. Either this option or the HONO_REGISTRY_REST_KEY_PATH and HONO_REGISTRY_REST_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_REGISTRY_REST_PORT\n--hono.registry.rest.port no 5671 The secure port that the server should listen on for HTTP requests.\nSee Port Configuration below for details.   HONO_REGISTRY_SVC_CACHE_MAX_AGE\n--hono.registry.svc.cacheMaxAge no 180 The maximum period of time (seconds) that information returned by the service\u0026rsquo;s operations may be cached for.   HONO_REGISTRY_SVC_FILENAME\n--hono.registry.svc.filename no /var/lib/hono/device-registry/\ndevice-identities.json The path to the file where the server stores identities of registered devices. Hono tries to read device identities from this file during start-up and writes out all identities to this file periodically if property HONO_REGISTRY_SVC_SAVE_TO_FILE is set to true.\nPlease refer to Device Identities File Format for details regarding the file\u0026rsquo;s format.   HONO_REGISTRY_SVC_MAX_DEVICES_PER_TENANT\n--hono.registry.svc.maxDevicesPerTenant no 100 The number of devices that can be registered for each tenant. It is an error to set this property to a value \u0026lt;= 0.   HONO_REGISTRY_SVC_MODIFICATION_ENABLED\n--hono.registry.svc.modificationEnabled no true When set to false the device information contained in the registry cannot be updated nor removed from the registry.   HONO_REGISTRY_SVC_RECEIVER_LINK_CREDIT\n--hono.registry.svc.receiverLinkCredit no 100 The number of credits to flow to a client connecting to the Device Registration endpoint.   HONO_REGISTRY_SVC_SAVE_TO_FILE\n--hono.registry.svc.saveToFile no false When set to true the server will periodically write out the registered device information to the file specified by the HONO_REGISTRY_SVC_FILENAME property.   HONO_REGISTRY_SVC_SIGNING_KEY_PATH\n--hono.registry.svc.signing.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the server should use for signing tokens asserting a device\u0026rsquo;s registration status. When using this variable, other services that need to validate the tokens issued by this service need to be configured with the corresponding certificate/public key. Alternatively, a symmetric key can be used for signing (and validating) by setting the HONO_REGISTRY_SVC_SIGNING_SHARED_SECRET variable. If none of these variables is set, the server falls back to the key indicated by the HONO_REGISTRY_AMP_KEY_PATH variable. If that variable is also not set, startup of the server fails.   HONO_REGISTRY_SVC_SIGNING_SHARED_SECRET\n--hono.registry.svc.signing.sharedSecret no - A string to derive a symmetric key from that is used for signing tokens asserting a device\u0026rsquo;s registration status. The key is derived from the string by using the bytes of the String\u0026rsquo;s UTF8 encoding. When setting the signing key using this variable, other services that need to validate the tokens issued by this service need to be configured with the same key. Alternatively, an asymmetric key pair can be used for signing (and validating) by setting the HONO_REGISTRY_SVC_SIGNING_KEY_PATH variable. If none of these variables is set, startup of the server fails.   HONO_REGISTRY_SVC_SIGNING_TOKEN_EXPIRATION\n--hono.registry.svc.signing.tokenExpiration no 10 The expiration period to use for the tokens asserting the registration status of devices.   HONO_REGISTRY_SVC_STARTEMPTY\n--hono.registry.svc.startEmpty no false When set to true the server will not try to load device identities from the file specified by the HONO_REGISTRY_SVC_FILENAME property during startup.   HONO_TENANT_SVC_CACHE_MAX_AGE\n--hono.tenant.svc.cacheMaxAge no 180 The maximum period of time (seconds) that information returned by the service\u0026rsquo;s operations may be cached for.   HONO_TENANT_SVC_FILENAME\n--hono.tenant.svc.filename no /var/lib/hono/device-registry/\ntenants.json The path to the file where the server stores tenants. Hono tries to read tenants from this file during start-up and writes out all identities to this file periodically if property HONO_TENANT_SVC_SAVE_TO_FILE is set to true.\nPlease refer to Tenants File Format for details regarding the file\u0026rsquo;s format.   HONO_TENANT_SVC_MODIFICATION_ENABLED\n--hono.tenant.svc.modificationEnabled no true When set to false the tenants contained in the registry cannot be updated nor removed.   HONO_TENANT_SVC_RECEIVER_LINK_CREDIT\n--hono.tenant.svc.receiverLinkCredit no 100 The number of credits to flow to a client connecting to the Tenant endpoint.   HONO_TENANT_SVC_SAVE_TO_FILE\n--hono.tenant.svc.saveToFile no false When set to true the server will periodically write out the registered tenants to the file specified by the HONO_TENANTS_SVC_TENANT_FILENAME property.   HONO_TENANT_SVC_STARTEMPTY\n--hono.tenant.svc.startEmpty no false When set to true the server will not try to load tenants from the file specified by the HONO_TENANT_SVC_FILENAME property during startup.    The variables only need to be set if the default value does not match your environment.\nPort Configuration The Device Registry supports configuration of both, an AMQP based endpoint as well as an HTTP based endpoint proving RESTful resources for managing registration information and credentials. Both endpoints can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The server will fail to start if none of the ports is configured properly.\nThe following sections apply to configuring both, the AMQP endpoint as well as the REST endpoint. The environment variables to use for configuring the REST endpoint are the same as the ones for the AMQP endpoint, substituting _AMQP_ with _REST_, e.g. HONO_REGISTRY_REST_KEY_PATH instead of HONO_REGISTRY_AMQP_KEY_PATH.\nSecure Port Only The server needs to be configured with a private key and certificate in order to open a TLS secured port.\nThere are two alternative ways for doing so:\n Setting the HONO_REGISTRY_AMQP_KEY_STORE_PATH and the HONO_REGISTRY_AMQP_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_REGISTRY_AMQP_KEY_PATH and HONO_REGISTRY_AMQP_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  When starting up, the server will bind a TLS secured socket to the default secure AMQP port 5671. The port number can also be set explicitly using the HONO_REGISTRY_AMQP_PORT variable.\nThe HONO_REGISTRY_AMQP_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_REGISTRY_AMQP_INSECURE_PORT to a valid port number, or by implicitly configuring the default AMQP port (5672) by simply setting HONO_REGISTRY_AMQP_INSECURE_PORT_ENABLED to true.  The server issues a warning on the console if HONO_REGISTRY_AMQP_INSECURE_PORT is set to the default secure AMQP port (5671).\nThe HONO_REGISTRY_AMQP_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port In test setups and some production scenarios Hono server may be configured to open one secure and one insecure port at the same time.\nThis is achieved by configuring both ports correctly (see above). The server will fail to start if both ports are configured to use the same port number.\nSince the secure port may need different visibility in the network setup compared to the secure port, it has it\u0026rsquo;s own binding address HONO_REGISTRY_AMQP_INSECURE_PORT_BIND_ADDRESS. This can be used to narrow the visibility of the insecure port to a local network e.g., while the secure port may be visible worldwide.\nEphemeral Ports The server may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nAuthentication Service Connection Configuration The Device Registry requires a connection to an implementation of Hono\u0026rsquo;s Authentication API in order to authenticate and authorize client requests.\nThe connection is configured according to Hono Client Configuration where the ${PREFIX} is set to HONO_AUTH. Since Hono\u0026rsquo;s Authentication Service does not allow caching of the responses, the cache properties can be ignored.\nIn addition to the standard client configuration properties, following properties may be set for the connection:\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_AUTH_VALIDATION_CERT_PATH\n--hono.auth.validation.certPath no - The absolute path to the PEM file containing the an X.509 certificate that the service should use for validating tokens issued by the Authentication service. Alternatively, a symmetric key can be used for validating tokens by setting the HONO_AUTH_VALIDATION_SHARED_SECRET variable. If none of these variables is set, startup of the service fails.   HONO_AUTH_VALIDATION_SHARED_SECRET\n--hono.auth.validation.sharedSecret no - A string to derive a symmetric key from which is used for validating tokens issued by the Authentication service. The key is derived from the string by using the bytes of the String\u0026rsquo;s UTF8 encoding. When setting the validation key using this variable, the Authentication service must be configured with the same key. Alternatively, an X.509 certificate can be used for validating tokens by setting the HONO_AUTH_VALIDATION_CERT_PATH variable. If none of these variables is set, startup of the service fails.   HONO_AUTH_SUPPORTED_SASL_MECHANISMS\n--hono.auth.supportedSaslMechanisms no EXTERNAL, PLAIN A (comma separated) list of the SASL mechanisms that the device registry should offer to clients for authentication. This option may be set to specify only one of EXTERNAL or PLAIN, or to use a different order.    Metrics Configuration See Monitoring \u0026amp; Tracing Admin Guide for details on how to configure the reporting of metrics.\nDevice Identities File Format The Device Registry supports persisting the device identities and their registration information to a JSON file in the local file system. The Getting started Guide includes an example configuration which illustrates the file format used. The configuration file\u0026rsquo;s location is /deploy/src/main/deploy/example-device-identities.json.\nCredentials File Format The Device Registry supports persisting the devices\u0026rsquo; credentials to a JSON file in the local file system. The Getting started Guide includes an example configuration which illustrates the file format used. The configuration file\u0026rsquo;s location is /deploy/src/main/deploy/example-credentials.json.\nTenants File Format The Device Registry supports persisting tenants to a JSON file in the local file system. The configuration file\u0026rsquo;s location is /deploy/src/main/deploy/example-tenants.json.\nConfiguring Gateway Devices The Device Registry supports devices to act on behalf of other devices. This is particularly useful for cases where a device does not connect directly to a Hono protocol adapter but is connected to a gateway component that is usually specific to the device\u0026rsquo;s communication protocol. It is the gateway component which then connects to a Hono protocol adapter and publishes data on behalf of the device(s). Examples of such a set up include devices using SigFox or LoRa for communication.\nIn these cases the protocol adapter will authenticate the gateway component instead of the device for which it wants to publish data. In order to verify that the gateway is authorized to publish data on behalf of the particular device, the protocol adapter should include the gateway\u0026rsquo;s device identifier (as determined during the authentication process) in its invocation of the Device Registration API\u0026rsquo;s assert Device Registration operation.\nThe Device Registry will then do the following: 1. Verify that the device exists and is enabled. 2. Verify that the gateway exists and is enabled. 3. Verify that the device\u0026rsquo;s registration information contains a property called via and that its value is either the gateway\u0026rsquo;s device identifier or a JSON array which contains the gateway\u0026rsquo;s device identifier as one of its values.\nOnly if all conditions are met, the Device Registry returns an assertion of the device\u0026rsquo;s registration status. The protocol adapter can then forward the published data to the AMQP Messaging Network in the same way as for any device that connects directly to the adapter.\nThe example configuration file (located at /deploy/src/main/deploy/example-device-identities.json) includes a device and a corresponding gateway configured in this way.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/admin-guide/device-connection-config/",
+	"title": "Configuring the Device Connection Service",
+	"tags": [],
+	"description": "",
+	"content": "The Device Connection service provides an implementation of Eclipse Hono\u0026trade;\u0026rsquo;s Device Connection API.\nProtocol adapters use this API to store and retrieve information about the gateway that a device is using to connect to Hono\u0026rsquo;s protocol adapters. This information is necessary for routing commands to the particular protocol adapter instance that the gateway used by the device is connected to.\nThe Device Connection component provides a production grade implementation of the Device Connection API which uses a remote data grid for storing information about device connections. The data grid can be scaled out independently from the Device Connection service components to meet the storage demands at hand.\nThe Device Connection component is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nService Configuration In addition to the following options, this component supports the options described in Common Configuration.\nThe following table provides an overview of the configuration variables and corresponding command line options for configuring the Device Connection component.\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_APP_MAX_INSTANCES\n--hono.app.maxInstances no #CPU cores The number of Verticle instances to deploy. If not set, one Verticle per processor core is deployed.   HONO_DEVICECONNECTION_AMQP_BIND_ADDRESS\n--hono.registry.amqp.bindAddress no 127.0.0.1 The IP address of the network interface that the secure AMQP port should be bound to.\nSee Port Configuration below for details.   HONO_DEVICECONNECTION_AMQP_CERT_PATH\n--hono.deviceConnection.amqp.certPath no - The absolute path to the PEM file containing the certificate that the server should use for authenticating to clients. This option must be used in conjunction with HONO_DEVICECONNECTION_AMQP_KEY_PATH.\nAlternatively, the HONO_DEVICECONNECTION_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_DEVICECONNECTION_AMQP_INSECURE_PORT\n--hono.deviceConnection.amqp.insecurePort no - The insecure port the server should listen on for AMQP 1.0 connections.\nSee Port Configuration below for details.   HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_BIND_ADDRESS\n--hono.deviceConnection.amqp.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure AMQP port should be bound to.\nSee Port Configuration below for details.   HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_ENABLED\n--hono.deviceConnection.amqp.insecurePortEnabled no false If set to true the server will open an insecure port (not secured by TLS) using either the port number set via HONO_REGISTRY_AMQP_INSECURE_PORT or the default AMQP port number (5672) if not set explicitly.\nSee Port Configuration below for details.   HONO_DEVICECONNECTION_AMQP_KEY_PATH\n--hono.deviceConnection.amqp.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the server should use for authenticating to clients. This option must be used in conjunction with HONO_DEVICECONNECTION_AMQP_CERT_PATH. Alternatively, the HONO_DEVICECONNECTION_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_DEVICECONNECTION_AMQP_KEY_STORE_PASSWORD\n--hono.deviceConnection.amqp.keyStorePassword no - The password required to read the contents of the key store.   HONO_DEVICECONNECTION_AMQP_KEY_STORE_PATH\n--hono.deviceConnection.amqp.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the server should use for authenticating to clients. Either this option or the HONO_DEVICECONNECTION_AMQP_KEY_PATH and HONO_DEVICECONNECTION_AMQP_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_DEVICECONNECTION_AMQP_NATIVE_TLS_REQUIRED\n--hono.deviceConnection.amqp.nativeTlsRequired no false The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_DEVICECONNECTION_AMQP_PORT\n--hono.deviceConnection.amqp.port no 5671 The secure port that the server should listen on for AMQP 1.0 connections.\nSee Port Configuration below for details.   HONO_DEVICECONNECTION_AMQP_RECEIVER_LINK_CREDIT\n--hono.deviceConnection.amqp.receiverLinkCredit no 100 The number of credits to flow to a client connecting to the service\u0026rsquo;s AMQP endpoint.   HONO_DEVICECONNECTION_AMQP_SECURE_PROTOCOLS\n--hono.deviceConnection.amqp.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.    The variables only need to be set if the default value does not match your environment.\nPort Configuration The Device Connection component supports configuration of both, an AMQP based endpoint as well as an HTTP based endpoint proving RESTful resources for managing registration information and credentials. Both endpoints can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The server will fail to start if none of the ports is configured properly.\nSecure Port Only The server needs to be configured with a private key and certificate in order to open a TLS secured port.\nThere are two alternative ways for doing so:\n Setting the HONO_DEVICECONNECTION_AMQP_KEY_STORE_PATH and the HONO_DEVICECONNECTION_AMQP_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_DEVICECONNECTION_AMQP_KEY_PATH and HONO_DEVICECONNECTION_AMQP_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  When starting up, the server will bind a TLS secured socket to the default secure AMQP port 5671. The port number can also be set explicitly using the HONO_DEVICECONNECTION_AMQP_PORT variable.\nThe HONO_DEVICECONNECTION_AMQP_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_DEVICECONNECTION_AMQP_INSECURE_PORT to a valid port number, or by implicitly configuring the default AMQP port (5672) by simply setting HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_ENABLED to true.  The server issues a warning on the console if HONO_DEVICECONNECTION_AMQP_INSECURE_PORT is set to the default secure AMQP port (5671).\nThe HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port In test setups and some production scenarios Hono server may be configured to open one secure and one insecure port at the same time.\nThis is achieved by configuring both ports correctly (see above). The server will fail to start if both ports are configured to use the same port number.\nSince the secure port may need different visibility in the network setup compared to the secure port, it has it\u0026rsquo;s own binding address HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_BIND_ADDRESS. This can be used to narrow the visibility of the insecure port to a local network e.g., while the secure port may be visible worldwide.\nEphemeral Ports The server may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nData Grid Connection Configuration The Device Connection component requires a connection to a remote data grid using the Infinispan Hotrod protocol to store device connection information in.\nThe following table provides an overview of the configuration variables and corresponding command line options for configuring the connection to the data grid:\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_DEVICECONNECTION_REMOTE_SERVER_LIST\n--hono.deviceConnection.remote.serverList yes - A list of remote servers in the form: host1[:port][;host2[:port]].....   HONO_DEVICECONNECTION_REMOTE_AUTH_SERVER_NAME\n--hono.deviceConnection.remote.authServerName yes - The server name to indicate in the SASL handshake when authenticating to the server.   HONO_DEVICECONNECTION_REMOTE_AUTH_USERNAME\n--hono.deviceConnection.remote.authUsername yes - The username to use for authenticating to the server.   HONO_DEVICECONNECTION_REMOTE_AUTH_PASSWORD\n--hono.deviceConnection.remote.authPassword yes - The password to use for authenticating to the server.    In general, the service supports all configuration properties of the Infinispan Hotrod client using hono.deviceConnection.remote instead of the infinispan.client.hotrod prefix.\nAuthentication Service Connection Configuration The Device Connection component requires a connection to an implementation of Hono\u0026rsquo;s Authentication API in order to authenticate and authorize client requests.\nThe connection is configured according to Hono Client Configuration where the ${PREFIX} is set to HONO_AUTH. Since Hono\u0026rsquo;s Authentication Service does not allow caching of the responses, the cache properties can be ignored.\nIn addition to the standard client configuration properties, following properties need to be set for the connection:\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_AUTH_VALIDATION_CERT_PATH\n--hono.auth.validation.certPath no - The absolute path to the PEM file containing the public key that the service should use for validating tokens issued by the Authentication service. Alternatively, a symmetric key can be used for validating tokens by setting the HONO_AUTH_VALIDATION_SHARED_SECRET variable. If none of these variables is set, the service falls back to the key indicated by the HONO_AUTH_CERT_PATH variable. If that variable is also not set, startup of the service fails.   HONO_AUTH_VALIDATION_SHARED_SECRET\n--hono.auth.validation.sharedSecret no - A string to derive a symmetric key from which is used for validating tokens issued by the Authentication service. The key is derived from the string by using the bytes of the String\u0026rsquo;s UTF8 encoding. When setting the validation key using this variable, the Authentication service must be configured with the same key. Alternatively, an asymmetric key pair can be used for validating (and signing) by setting the HONO_AUTH_SIGNING_CERT_PATH variable. If none of these variables is set, startup of the service fails.    Metrics Configuration See Monitoring \u0026amp; Tracing Admin Guide for details on how to configure the reporting of metrics.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/admin-guide/http-adapter-config/",
+	"title": "HTTP Adapter Configuration",
+	"tags": [],
+	"description": "",
+	"content": "The HTTP protocol adapter exposes a HTTP based API for Eclipse Hono\u0026trade;\u0026rsquo;s Telemetry and Event endpoints.\nThe adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nThe adapter supports the following standard configuration options:\n Common Java VM Options Common vert.x Options Common Protocol Adapter Options Monitoring Options  Service Configuration The following table provides an overview of the configuration variables and corresponding command line options for configuring the HTTP adapter.\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_APP_MAX_INSTANCES\n--hono.app.maxInstances no #CPU cores The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.   HONO_HTTP_AUTHENTICATION_REQUIRED\n--hono.http.authenticationRequired no true If set to true the protocol adapter requires devices to authenticate when connecting to the adapter. The credentials provided by the device are verified using the configured Credentials Service. Devices that have failed to authenticate are not allowed to publish any data.   HONO_HTTP_BIND_ADDRESS\n--hono.http.bindAddress no 127.0.0.1 The IP address of the network interface that the secure port should be bound to.\nSee Port Configuration below for details.   HONO_HTTP_CERT_PATH\n--hono.http.certPath no - The absolute path to the PEM file containing the certificate that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_HTTP_KEY_PATH.\nAlternatively, the HONO_HTTP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_HTTP_DEFAULTS_ENABLED\n--hono.http.defaultsEnabled no true If set to true the protocol adapter uses default values registered for a device to augment messages published by the device with missing information like a content type. In particular, the protocol adapter adds default values registered for the device as (application) properties with the same name to the AMQP 1.0 messages it sends downstream to the AMQP Messaging Network.   HONO_HTTP_INSECURE_PORT\n--hono.http.insecurePort no - The insecure port the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_HTTP_INSECURE_PORT_BIND_ADDRESS\n--hono.http.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure port should be bound to.\nSee Port Configuration below for details.   HONO_HTTP_INSECURE_PORT_ENABLED\n--hono.http.insecurePortEnabled no false If set to true the protocol adapter will open an insecure port (not secured by TLS) using either the port number set via HONO_HTTP_INSECURE_PORT or the default port number (8080) if not set explicitly.\nSee Port Configuration below for details.   HONO_HTTP_KEY_PATH\n--hono.http.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_HTTP_CERT_PATH. Alternatively, the HONO_HTTP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_HTTP_KEY_STORE_PASSWORD\n--hono.http.keyStorePassword no - The password required to read the contents of the key store.   HONO_HTTP_KEY_STORE_PATH\n--hono.http.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the protocol adapter should use for authenticating to clients. Either this option or the HONO_HTTP_KEY_PATH and HONO_HTTP_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_HTTP_SNI\n--hono.http.sni no false Set whether the server supports Server Name Indication. By default, the server will not support SNI and the option is false. However, if set to true then the key store format , HONO_HTTP_KEY_STORE_PATH, should be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_HTTP_NATIVE_TLS_REQUIRED\n--hono.http.nativeTlsRequired no false The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_HTTP_MAX_PAYLOAD_SIZE\n--hono.http.maxPayloadSize no 2048 The maximum allowed size of an incoming HTTP request\u0026rsquo;s body in bytes. Requests with a larger body size are rejected with a 413 Request entity too large response.   HONO_HTTP_PORT\n--hono.http.port no 8443 The secure port that the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_HTTP_REALM\n--hono.http.realm no Hono The name of the realm that unauthenticated devices are prompted to provide credentials for. The realm is used in the WWW-Authenticate header returned to devices in response to unauthenticated requests.   HONO_HTTP_SECURE_PROTOCOLS\n--hono.http.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   HONO_HTTP_TENANT_IDLE_TIMEOUT\n--hono.http.tenantIdleTimeout no 0ms The duration after which the protocol adapter removes local state of the tenant (e.g. open AMQP links) with an amount and a unit, e.g. 2h for 2 hours. See the Spring Boot documentation for an explanation of the format. The value 0ms disables the timeout.    The variables only need to be set if the default value does not match your environment.\nPort Configuration The HTTP protocol adapter can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The HTTP protocol adapter will fail to start if none of the ports is configured properly.\nSecure Port Only The protocol adapter needs to be configured with a private key and certificate in order to open a TLS secured port.\nThere are two alternative ways for doing so:\n Setting the HONO_HTTP_KEY_STORE_PATH and the HONO_HTTP_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_HTTP_KEY_PATH and HONO_HTTP_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  When starting up, the protocol adapter will bind a TLS secured socket to the default secure port 8443. The port number can also be set explicitly using the HONO_HTTP_PORT variable.\nThe HONO_HTTP_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_HTTP_INSECURE_PORT to a valid port number, or by implicitly configuring the default port (8080) by simply setting HONO_HTTP_INSECURE_PORT_ENABLED to true.  The protocol adapter issues a warning on the console if HONO_HTTP_INSECURE_PORT is set to the default secure HTTP port (8443).\nThe HONO_HTTP_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port The protocol adapter may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nEphemeral Ports Both the secure as well as the insecure port numbers may be explicitly set to 0. The protocol adapter will then use arbitrary (unused) port numbers determined by the operating system during startup.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-adapter-config/",
+	"title": "AMQP Adapter Configuration",
+	"tags": [],
+	"description": "",
+	"content": "The AMQP protocol adapter allows clients (devices and gateway components) that speaks AMQP 1.0 to publish telemetry messages and events to Eclipse Hono\u0026trade;\u0026rsquo;s Telemetry and Event endpoints.\nThe adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nThe adapter supports the following standard configuration options:\n Common Java VM Options Common vert.x Options Common Protocol Adapter Options Monitoring Options  Service Configuration The following table provides an overview of the configuration variables and corresponding command line options for configuring the AMQP adapter.\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     HONO_AMQP_AUTHENTICATION_REQUIRED\n--hono.amqp.authenticationRequired no true If set to true the protocol adapter requires devices to authenticate when connecting to the adapter. The credentials provided by the device are verified using the configured Credentials Service. Devices that have failed to authenticate are not allowed to publish any data.   HONO_AMQP_BIND_ADDRESS\n--hono.amqp.bindAddress no 127.0.0.1 The IP address of the network interface that the secure port should be bound to.\nSee Port Configuration below for details.   HONO_AMQP_CERT_PATH\n--hono.amqp.certPath no - The absolute path to the PEM file containing the certificate that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_AMQP_KEY_PATH.\nAlternatively, the HONO_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_AMQP_DEFAULTS_ENABLED\n--hono.amqp.defaultsEnabled no true If set to true the protocol adapter uses default values registered for a device to augment messages published by the device with missing information like a content type. In particular, the protocol adapter adds default values registered for the device as (application) properties with the same name to the AMQP 1.0 messages it sends downstream to the AMQP Messaging Network.   HONO_AMQP_IDLE_TIMEOUT\n--hono.amqp.idleTimeout no 60000 The time interval (milliseconds) to wait for incoming traffic from a device before the connection should be considered stale and thus be closed. Setting this property to 0 prevents the adapter from detecting and closing stale connections.   HONO_AMQP_INSECURE_PORT_BIND_ADDRESS\n--hono.amqp.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure port should be bound to.\nSee Port Configuration below for details.   HONO_AMQP_INSECURE_PORT\n--hono.amqp.insecurePort no 5672 The port number that the protocol adapter should listen on for insecure connections.\nSee Port Configuration below for details.   HONO_AMQP_INSECURE_PORT_ENABLED\n--hono.amqp.insecurePortEnabled no false If set to true the protocol adapter will open an insecure port (not secured by TLS) using either the port number set via HONO_AMQP_INSECURE_PORT or the default AMQP port number (1883) if not set explicitly.\nSee Port Configuration below for details.   HONO_AMQP_KEY_PATH\n--hono.amqp.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_AMQP_CERT_PATH. Alternatively, the HONO_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_AMQP_KEY_STORE_PASSWORD\n--hono.amqp.keyStorePassword no - The password required to read the contents of the key store.   HONO_AMQP_KEY_STORE_PATH\n--hono.amqp.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the protocol adapter should use for authenticating to clients. Either this option or the HONO_AMQP_KEY_PATH and HONO_AMQP_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_AMQP_SNI\n--hono.amqp.sni no false Set whether the server supports Server Name Indication. By default, the server will not support SNI and the option is false. However, if set to true then the key store format, HONO_AMQP_KEY_STORE_PATH, should be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_AMQP_MAX_CONNECTIONS\n--hono.amqp.maxConnections no 0 The maximum number of concurrent connections that the protocol adapter should accept. If not set (or set to 0), the protocol adapter determines a reasonable value based on the available resources like memory and CPU.   HONO_AMQP_MAX_FRAME_SIZE\n--hono.amqp.maxFrameSize no 16384 The maximum number of bytes that can be sent in an AMQP message delivery over the connection with a device. When a client sends an AMQP frame of larger size, the connection is closed.   HONO_AMQP_MAX_PAYLOAD_SIZE\n--hono.amqp.maxPayloadSize no 2048 The maximum allowed size of an incoming AMQP message in bytes. When a client sends a message with a larger payload, the message is discarded and the link to the client is closed.   HONO_AMQP_MAX_SESSION_FRAMES\n--hono.amqp.maxSessionFrames no 30 The maximum number of AMQP transfer frames for sessions created on this connection. This is the number of transfer frames that may simultaneously be in flight for all links in the session.   HONO_AMQP_NATIVE_TLS_REQUIRED\n--hono.amqp.nativeTlsRequired no false The server will probe for OpenSSL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_AMQP_PORT\n--hono.amqp.port no 5671 The secure port that the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_AMQP_SECURE_PROTOCOLS\n--hono.amqp.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   HONO_AMQP_TENANT_IDLE_TIMEOUT\n--hono.amqp.tenantIdleTimeout no 0ms The duration after which the protocol adapter removes local state of the tenant (e.g. open AMQP links) with an amount and a unit, e.g. 2h for 2 hours. See the Spring Boot documentation for an explanation of the format. The value 0ms disables the timeout.   HONO_APP_MAX_INSTANCES\n--hono.app.maxInstances no #CPU cores The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.    The variables only need to be set if the default values do not match your environment.\nPort Configuration The AMQP protocol adapter can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The AMQP protocol adapter will fail to start if none of the ports is configured properly.\nSecure Port Only The protocol adapter needs to be configured with a private key and certificate in order to open a TLS secured port.\nThere are two alternative ways for doing so:\n either setting the HONO_AMQP_KEY_STORE_PATH and the HONO_AMQP_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_AMQP_KEY_PATH and HONO_AMQP_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  When starting up, the protocol adapter will bind a TLS secured socket to the default secure port 5671. The port number can also be set explicitly using the HONO_AMQP_PORT variable.\nThe HONO_AMQP_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_AMQP_INSECURE_PORT to a valid port number, or by implicitly configuring the default adapter port (5672) by simply setting HONO_AMQP_INSECURE_PORT_ENABLED to true.  The protocol adapter issues a warning on the console if HONO_AMQP_INSECURE_PORT is set to the default secure port (5671) used by the adapter for secure connections.\nThe HONO_AMQP_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port The protocol adapter may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nEphemeral Ports Both the secure as well as the insecure port numbers may be explicitly set to 0. The protocol adapter will then use arbitrary (unused) port numbers determined by the operating system during startup.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/admin-guide/mqtt-adapter-config/",
+	"title": "MQTT Adapter Configuration",
+	"tags": [],
+	"description": "",
+	"content": "The MQTT protocol adapter exposes an MQTT topic hierarchy for publishing messages and events to Eclipse Hono\u0026trade;\u0026rsquo;s Telemetry and Event endpoints.\nThe adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nThe adapter supports the following standard configuration options:\n Common Java VM Options Common vert.x Options Common Protocol Adapter Options Monitoring Options  Service Configuration The following table provides an overview of the configuration variables and corresponding command line options for configuring the MQTT adapter.\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     HONO_APP_MAX_INSTANCES\n--hono.app.maxInstances no #CPU cores The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.   HONO_CONNECTION_EVENTS_PRODUCER\n--hono.connectionEvents.producer no logging The implementation of connection events producer which is to be used. This may be logging or events.\nSee Connection Events   HONO_MQTT_AUTHENTICATION_REQUIRED\n--hono.mqtt.authenticationRequired no true If set to true the protocol adapter requires devices to authenticate when connecting to the adapter. The credentials provided by the device are verified using the configured Credentials Service. Devices that have failed to authenticate are not allowed to publish any data.   HONO_MQTT_BIND_ADDRESS\n--hono.mqtt.bindAddress no 127.0.0.1 The IP address of the network interface that the secure port should be bound to.\nSee Port Configuration below for details.   HONO_MQTT_CERT_PATH\n--hono.mqtt.certPath no - The absolute path to the PEM file containing the certificate that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_MQTT_KEY_PATH.\nAlternatively, the HONO_MQTT_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_MQTT_COMMAND_ACK_TIMEOUT\n--hono.mqtt.commandAckTimeout no 100 The amount of time (milliseconds) after which the sending of a command to a device using QoS 1 is considered to be failed. The value of this variable should be increased in cases where devices are connected over a network with high latency.   HONO_MQTT_DEFAULTS_ENABLED\n--hono.mqtt.defaultsEnabled no true If set to true the protocol adapter uses default values registered for a device to augment messages published by the device with missing information like a content type. In particular, the protocol adapter adds default values registered for the device as (application) properties with the same name to the AMQP 1.0 messages it sends downstream to the AMQP Messaging Network.   HONO_MQTT_INSECURE_PORT_BIND_ADDRESS\n--hono.mqtt.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure port should be bound to.\nSee Port Configuration below for details.   HONO_MQTT_INSECURE_PORT_ENABLED\n--hono.mqtt.insecurePortEnabled no false If set to true the protocol adapter will open an insecure port (not secured by TLS) using either the port number set via HONO_MQTT_INSECURE_PORT or the default MQTT port number (1883) if not set explicitly.\nSee Port Configuration below for details.   HONO_MQTT_KEY_PATH\n--hono.mqtt.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_MQTT_CERT_PATH. Alternatively, the HONO_MQTT_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_MQTT_KEY_STORE_PASSWORD\n--hono.mqtt.keyStorePassword no - The password required to read the contents of the key store.   HONO_MQTT_KEY_STORE_PATH\n--hono.mqtt.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the protocol adapter should use for authenticating to clients. Either this option or the HONO_MQTT_KEY_PATH and HONO_MQTT_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_MQTT_SNI\n--hono.mqtt.sni no false Set whether the server supports Server Name Indication. By default, the server will not support SNI and the option is false. However, if set to true then the key store format , HONO_MQTT_KEY_STORE_PATH, should be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_MQTT_MAX_CONNECTIONS\n--hono.mqtt.maxConnections no 0 The maximum number of concurrent connections that the protocol adapter should accept. If not set (or set to 0), the protocol adapter determines a reasonable value based on the available resources like memory and CPU.   HONO_MQTT_MAX_PAYLOAD_SIZE\n--hono.mqtt.maxPayloadSize no 2048 The maximum allowed size of an incoming MQTT message\u0026rsquo;s payload in bytes. When a client sends a message with a larger payload, the message is discarded and the connection to the client gets closed.   HONO_MQTT_NATIVE_TLS_REQUIRED\n--hono.mqtt.nativeTlsRequired no false The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_MQTT_PORT\n--hono.mqtt.port no 8883 The secure port that the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_MQTT_SECURE_PROTOCOLS\n--hono.mqtt.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   HONO_MQTT_TENANT_IDLE_TIMEOUT\n--hono.mqtt.tenantIdleTimeout no 0ms The duration after which the protocol adapter removes local state of the tenant (e.g. open AMQP links) with an amount and a unit, e.g. 2h for 2 hours. See the Spring Boot documentation for an explanation of the format. The value 0ms disables the timeout.    The variables only need to be set if the default values do not match your environment.\nPort Configuration The MQTT protocol adapter can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The MQTT protocol adapter will fail to start if none of the ports is configured properly.\nSecure Port Only The protocol adapter needs to be configured with a private key and certificate in order to open a TLS secured port.\nThere are two alternative ways for doing so:\n either setting the HONO_MQTT_KEY_STORE_PATH and the HONO_MQTT_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_MQTT_KEY_PATH and HONO_MQTT_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  When starting up, the protocol adapter will bind a TLS secured socket to the default secure MQTT port 8883. The port number can also be set explicitly using the HONO_MQTT_PORT variable.\nThe HONO_MQTT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_MQTT_INSECURE_PORT to a valid port number, or by implicitly configuring the default MQTT port (1883) by simply setting HONO_MQTT_INSECURE_PORT_ENABLED to true.  The protocol adapter issues a warning on the console if HONO_MQTT_INSECURE_PORT is set to the default secure MQTT port (8883).\nThe HONO_MQTT_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port The protocol adapter may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nEphemeral Ports Both the secure as well as the insecure port numbers may be explicitly set to 0. The protocol adapter will then use arbitrary (unused) port numbers determined by the operating system during startup.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/admin-guide/kura-adapter-config/",
+	"title": "Kura Adapter Configuration",
+	"tags": [],
+	"description": "",
+	"content": "The Kura protocol adapter exposes an MQTT topic hierarchy allowing Eclipse Kura\u0026trade; based gateways to publish control and data messages to Eclipse Hono\u0026trade;\u0026rsquo;s Telemetry and Event endpoints.\nThe adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nThe adapter supports the following standard configuration options:\n Common Java VM Options Common vert.x Options Common Protocol Adapter Options Monitoring Options  Service Configuration The following table provides an overview of the configuration variables and corresponding command line options for configuring the MQTT adapter.\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     HONO_APP_MAX_INSTANCES\n--hono.app.maxInstances no #CPU cores The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.   HONO_KURA_AUTHENTICATION_REQUIRED\n--hono.kura.authenticationRequired no true If set to true the protocol adapter requires devices to authenticate when connecting to the adapter. The credentials provided by the device are verified using the configured Credentials Service. Devices that have failed to authenticate are not allowed to publish any data.   HONO_KURA_BIND_ADDRESS\n--hono.kura.bindAddress no 127.0.0.1 The IP address of the network interface that the secure port should be bound to.\nSee Port Configuration below for details.   HONO_KURA_CERT_PATH\n--hono.kura.certPath no - The absolute path to the PEM file containing the certificate that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_KURA_KEY_PATH.\nAlternatively, the HONO_KURA_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_KURA_CONTROL_PREFIX\n--hono.kura.controlPrefix no $EDC The topic.control-prefix to use for determining if a message published by a Kura gateway is a control message. All messages published to a topic that does not start with this prefix are considered data messages.   HONO_KURA_CTRL_MSG_CONTENT_TYPE\n--hono.kura.ctrlMsgContentType no application/vnd.eclipse.kura-control The content type to set on AMQP messages created from Kura control messages.   HONO_KURA_DATA_MSG_CONTENT_TYPE\n--hono.kura.dataMsgContentType no application/vnd.eclipse.kura-data The content type to set on AMQP messages created from Kura data messages.   HONO_KURA_DEFAULTS_ENABLED\n--hono.kura.defaultsEnabled no true If set to true the protocol adapter uses default values registered for a device to augment messages published by the device with missing information like a content type. In particular, the protocol adapter adds default values registered for the device as (application) properties with the same name to the AMQP 1.0 messages it sends downstream to the AMQP Messaging Network.   HONO_KURA_INSECURE_PORT\n--hono.kura.insecurePort no - The insecure port the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_KURA_INSECURE_PORT_BIND_ADDRESS\n--hono.kura.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure port should be bound to.\nSee Port Configuration below for details.   HONO_KURA_INSECURE_PORT_ENABLED\n--hono.kura.insecurePortEnabled no false If set to true the protocol adapter will open an insecure port (not secured by TLS) using either the port number set via HONO_KURA_INSECURE_PORT or the default MQTT port number (1883) if not set explicitly.\nSee Port Configuration below for details.   HONO_KURA_KEY_PATH\n--hono.kura.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_KURA_CERT_PATH. Alternatively, the HONO_KURA_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_KURA_KEY_STORE_PASSWORD\n--hono.kura.keyStorePassword no - The password required to read the contents of the key store.   HONO_KURA_KEY_STORE_PATH\n--hono.kura.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the protocol adapter should use for authenticating to clients. Either this option or the HONO_KURA_KEY_PATH and HONO_KURA_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_KURA_SNI\n--hono.kura.sni no false Set whether the server supports Server Name Indication. By default, the server will not support SNI and the option is false. However, if set to true then the key store format , HONO_KURA_KEY_STORE_PATH, should be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_KURA_MAX_PAYLOAD_SIZE\n--hono.kura.maxPayloadSize no 2048 The maximum allowed size of an incoming MQTT message\u0026rsquo;s payload in bytes. When a client sends a message with a larger payload, the message is discarded and the connection to the client gets closed.   HONO_KURA_NATIVE_TLS_REQUIRED\n--hono.kura.nativeTlsRequired no false The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_KURA_PORT\n--hono.kura.port no 8883 The secure port that the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_KURA_SECURE_PROTOCOLS\n--hono.kura.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   HONO_KURA_TENANT_IDLE_TIMEOUT\n--hono.kura.tenantIdleTimeout no 0ms The duration after which the protocol adapter removes local state of the tenant (e.g. open AMQP links) with an amount and a unit, e.g. 2h for 2 hours. See the Spring Boot documentation for an explanation of the format. The value 0ms disables the timeout.    The variables only need to be set if the default values do not match your environment.\nPort Configuration The Kura protocol adapter can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The Kura protocol adapter will fail to start if none of the ports is configured properly.\nSecure Port Only The protocol adapter needs to be configured with a private key and certificate in order to open a TLS secured port.\nThere are two alternative ways for doing so:\n either setting the HONO_KURA_KEY_STORE_PATH and the HONO_KURA_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_KURA_KEY_PATH and HONO_KURA_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  When starting up, the protocol adapter will bind a TLS secured socket to the default secure MQTT port 8883. The port number can also be set explicitly using the HONO_KURA_PORT variable.\nThe HONO_KURA_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_KURA_INSECURE_PORT to a valid port number, or by implicitly configuring the default MQTT port (1883) by simply setting HONO_KURA_INSECURE_PORT_ENABLED to true.  The protocol adapter issues a warning on the console if HONO_KURA_INSECURE_PORT is set to the default secure MQTT port (8883).\nThe HONO_KURA_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port The protocol adapter may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nEphemeral Ports Both the secure as well as the insecure port numbers may be explicitly set to 0. The protocol adapter will then use arbitrary (unused) port numbers determined by the operating system during startup.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/admin-guide/hono-client-configuration/",
+	"title": "Hono Client Configuration",
+	"tags": [],
+	"description": "",
+	"content": "The org.eclipse.hono.client.HonoConnection factory can be used to create AMQP 1.0 connections to Hono\u0026rsquo;s service components.\nThe factory uses environment variables and/or command line options to configure the connection to the service and the caching of responses to service invocations. All variables used for configuring the connection factory for a particular service share a common prefix. This way, multiple sets of variables can be used to configure multiple factories for connecting to different service endpoints without interfering with each other. For example, the set of variables for configuring the connection factory for the Device Registration service may use the common prefix HONO_REGISTRATION whereas the set for configuring the factory for the Credentials service may use HONO_CREDENTIALS.\nConnection Properties The following table provides an overview of the configuration variables and corresponding command line options for configuring the AMQP connection to the service. Note that the variables map to the properties of classes org.eclipse.hono.config.ClientConfigProperties and org.eclipse.client.RequestResponseClientConfigProperties which can be used to programmatically configure a client.\nThe variable names contain ${PREFIX} as a placeholder for the particular common prefix being used. The ${prefix} placeholder used in the command line option name is the same as ${PREFIX}, using all lower case characters and . instead of _ as the delimiter, e.g. the variable prefix HONO_CREDENTIALS corresponds to the command line option prefix hono.credentials).\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     ${PREFIX}_AMQPHOSTNAME\n--${prefix}.amqpHostname no - The name to use as the hostname in the client\u0026rsquo;s AMQP open frame during connection establishment. This variable can be used to indicate the virtual host to connect to on the server.   ${PREFIX}_CERTPATH\n--${prefix}.certPath no - The absolute path to the PEM file containing the certificate that the client should use for authenticating to the server. This variable must be used in conjunction with ${PREFIX}_KEY_PATH.\nAlternatively, the ${PREFIX}_KEYSTOREPATH variable can be used to configure a key store containing both the key as well as the certificate.   ${PREFIX}_CONNECTTIMEOUT\n--${prefix}.connectTimeout no 5000 The maximum amount of time (milliseconds) that the client should wait for the AMQP connection to be opened. This includes the time for TCP/TLS connection establishment, SASL handshake and exchange of the AMQP open frame. This property can be used to tune the time period to wait according to the network latency involved with the connection between the client and the service.   ${PREFIX}_CREDENTIALSPATH\n--${prefix}.credentialsPath no - The absolute path to a properties file that contains a username and a password property to use for authenticating to the service.\nThis variable is an alternative to using ${PREFIX}_USERNAME and ${PREFIX}_PASSWORD which has the advantage of not needing to expose the secret (password) in the client process\u0026rsquo; environment.   ${PREFIX}_FLOWLATENCY\n--${prefix}.flowLatency no 20 The maximum amount of time (milliseconds) that the client should wait for credits after a link to the service has been established.   ${PREFIX}_HOST\n--${prefix}.host no localhost The IP address or name of the host to connect to. NB This needs to be set to an address that can be resolved within the network the adapter runs on. When running as a Docker container, use Docker\u0026rsquo;s --network command line option to attach the local container to the Docker network that the service is running on.   ${PREFIX}_HOSTNAMEVERIFICATIONREQUIRED\n--${prefix}.hostnameVerificationRequired no true A flag indicating whether the value of the ${PREFIX}_HOST variable must match the distinguished name or any of the alternative names asserted by the server\u0026rsquo;s certificate when connecting using TLS.   ${PREFIX}_IDLETIMEOUT\n--${prefix}.idleTimeout no 16000 Sets the amount of time in milliseconds after which a connection will be closed when no frames have been received from the remote peer. This property is also used to configure a heartbeat mechanism, checking that the connection is still alive. The corresponding heartbeat interval will be set to idleTimeout/2 ms.   ${PREFIX}_INITIALCREDITS\n--${prefix}.initialCredits no 200 The number of credits that a consuming client will initially issue to the service (sender) after link creation. This value effectively limits the number of messages that can be in flight unsettled.   ${PREFIX}_KEYPATH\n--${prefix}.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the client should use for authenticating to the server. Note that the private key is not protected by a password. You should therefore make sure that the key file can only be read by the user that the client process is running under. This variable must be used in conjunction with ${PREFIX}_CERTPATH. Alternatively, the ${PREFIX}_KEYSTOREPATH variable can be used to configure a key store containing both the key as well as the certificate.   ${PREFIX}_KEYSTOREPASSWORD\n--${prefix}.keyStorePassword no - The password required to read the contents of the key store.   ${PREFIX}_KEYSTOREPATH\n--${prefix}.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the client should use for authenticating to the server. Either this variable or the ${PREFIX}_KEYPATH and ${PREFIX}_CERTPATH variables need to be set in order to enable SASL External based authentication to the server. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   ${PREFIX}_LINKESTABLISMENTTIMEOUT\n--${prefix}.linkEstablishmentTimeout no 1000 The maximum amount of time (milliseconds) that the client should wait for the service\u0026rsquo;s attach frame during link establishment. This property can be used to tune the time period to wait according to the network latency involved with the communication link between the client and the service.   ${PREFIX}_NAME\n--${prefix}.name no - The name to use as the container-id in the client\u0026rsquo;s AMQP open frame during connection establishment.   ${PREFIX}_PASSWORD\n--${prefix}.password no - The password to use for authenticating to the service.   ${PREFIX}_PORT\n--${prefix}.port no 5671 The port that the service is listening on.   ${PREFIX}_SENDMESSAGETIMEOUT\n--${prefix}.sendMessageTimeout no 1000 The maximum number of milliseconds to wait for a delivery update after an event or command message was sent before the send operation is failed. Setting this value to a higher value increases the chance of successful service invocation in situations where network latency is high.   ${PREFIX}_RECONNECTATTEMPTS\n--${prefix}.reconnectAttempts no -1 The number of attempts (in addition to the original connection attempt) that the client should make in order to establish an AMQP connection with the peer before giving up. The default value of this property is -1 which means that the client will try forever.   ${PREFIX}_RECONNECTDELAYINCREMENT\n--${prefix}.reconnectDelayIncrement no 100 The factor (milliseconds) used in the exponential backoff algorithm for determining the delay before trying to re-establish an AMQP connection with the peer. The delay after an initial, failed connection attempt will be the value of the ${PREFIX}_RECONNECTMINDELAY variable. Each subsequent connection attempt will use a random delay between the minimum delay and the value determined by exponentially increasing the delay by the ${PREFIX}_RECONNECTDELAYINCREMENT factor. The overall limit of the delay time is defined by the ${PREFIX}_RECONNECTMAXDELAY variable.   ${PREFIX}_RECONNECTMAXDELAY\n--${prefix}.reconnectMaxDelay no 7000 The maximum number of milliseconds to wait before trying to re-establish an AMQP connection with the peer.   ${PREFIX}_RECONNECTMINDELAY\n--${prefix}.reconnectMinDelay no 0 The minimum number of milliseconds to wait before trying to re-establish an AMQP connection with the peer.   ${PREFIX}_REQUESTTIMEOUT\n--${prefix}.requestTimeout no 200 The maximum number of milliseconds to wait for a response before a service invocation is failed. Setting this value to a higher value increases the chance of successful service invocation in situations where network latency is high.   ${PREFIX}_SECUREPROTOCOLS\n--${prefix}.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   ${PREFIX}_TLSENABLED\n--${prefix}.tlsEnabled no false If set to true the connection to the peer will be encrypted using TLS and the peer\u0026rsquo;s identity will be verified using the JVM\u0026rsquo;s configured standard trust store.\nThis variable only needs to be set to enable TLS explicitly if no specific trust store is configured using the ${PREFIX}_TRUSTSTOREPATH variable.   ${PREFIX}_TRUSTSTOREPATH\n--${prefix}.trustStorePath no - The absolute path to the Java key store containing the CA certificates the adapter uses for authenticating the service. This property must be set if the service has been configured to support TLS. The key store format can be either JKS, PKCS12 or PEM indicated by a .jks, .p12 or .pem file suffix respectively.   ${PREFIX}_TRUSTSTOREPASSWORD\n--${prefix}.trustStorePassword no - The password required to read the contents of the trust store.   ${PREFIX}_USERNAME\n--${prefix}.username no - The username to use for authenticating to the service. This property (and the corresponding password) needs to be set in order to enable SASL Plain based authentication to the service.    Response Caching The clients created by a Hono client factory support the caching of responses received in response to service invocations. Caching can greatly improve performance by preventing costly invocations of remote service operations. However, it usually only makes sense for resources that do not change too frequently. The Hono client follows the approach to caching used in HTTP 1.1. In particular, it supports cache directives that a service includes in the response messages it sends back to the Hono client.\nIn order to enable caching, the org.eclipse.hono.client.impl.HonoClientImpl factory class needs to be configured with a cache manager using the setCacheManager method. Any specific client created by the factory will then cache responses to service invocations based on the following rules:\n If the response contains a no-cache directive, the response is not cached at all. Otherwise, if the response contains a max-age directive, the response is cached for the number of seconds specified by the directive. Otherwise, if the response message does not contain any of the above directives and the response\u0026rsquo;s status code is one of the codes defined in RFC 2616, Section 13.4 Response Cacheability, the response is put to the cache using the default timeout defined by the ${PREFIX}_RESPONSECACHEDEFAULTTIMEOUT variable as the maximum age.  The following table provides an overview of the configuration variables and corresponding command line options for configuring the Hono client\u0026rsquo;s caching behavior.\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     ${PREFIX}_RESPONSECACHEMINSIZE\n--${prefix}.responseCacheMinSize no 20 The minimum number of responses that can be cached.   ${PREFIX}_RESPONSECACHEMAXSIZE\n--${prefix}.responseCacheMaxSize no 1000 The maximum number of responses that can be cached. It is up to the particular cache implementation, how to deal with new cache entries once this limit has been reached.   ${PREFIX}_RESPONSECACHEDEFAULTTIMEOUT\n--${prefix}.responseCacheDefaultTimeout no 600 The default number of seconds after which cached responses should be considered invalid.    Using TLS The factory can be configured to use TLS for\n authenticating the server during connection establishment and (optionally) authenticating to the server using a client certificate (if the server supports this)  In order to authenticate the server by means of the server\u0026rsquo;s certificate, the factory needs to be configured with a trust anchor containing the certificate authorities that the client trusts. The trust anchor can be configured explicitly by means of the ${PREFIX}_TRUSTSTOREPATH and ${PREFIX}_TRUSTSTOREPASSWORD variables. This is most useful in cases where the server\u0026rsquo;s certificate has not been signed by one of the public root CAs that are contained in the JRE\u0026rsquo;s standard trust store. However, if the server does use a certificate signed by such a public CA, then it is sufficient to set the ${PREFIX}_TLSENABLED variable to true in order for the client to support TLS when connecting to the server.\nThe client can also be configured to authenticate to the server by means of an X.509 client certificate if the server is configured to support this. The ${PREFIX}_CERTPATH and ${PREFIX}_KEYPATH variables can be used to set the paths to PEM files containing the certificate and private key. Alternatively, the ${PREFIX}_KEYSTOREPATH and ${PREFIX}_KEYSTOREPASSWORD variables can be used to set the path and password of a key store which contains both the certificate as well as the private key.\nThe factory supports TLS 1.2 only by default for negotiating TLS sessions with servers. Additional protocols can be enabled by setting the ${PREFIX}_SECUREPROTOCOLS variable to a comma separated list of protocol names as defined in the vert.x documentation. However, great care should be taken when enabling older protocols because most of them are vulnerable to attacks.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-network-config/",
+	"title": "AMQP 1.0 Messaging Network Configuration",
+	"tags": [],
+	"description": "",
+	"content": "The Qpid Dispatch Router, together with the Apache Artemis message broker, serves as the default AMQP 1.0 Messaging Network that is used in Hono\u0026rsquo;s example deployment as described in the Deployment Guides.\nThe Dispatch Router component exposes service endpoints implementing the north bound part of Hono\u0026rsquo;s Telemetry, Event and Command \u0026amp; Control APIs which are used by applications to interact with devices.\nDispatch Router Configuration The Dispatch Router is part of the Apache Qpid project. Hono uses Dispatch Router by means of the EnMasse project\u0026rsquo;s Dispatch Router Docker image created from the Qpid project source code.\nThe Dispatch Router can be configured by means of configuration files. Hono includes an example configuration in the deploy/src/main/config/qpid folder which is used by the example deployment scripts. Please refer to the Dispatch Router documentation for details regarding the configuration file format and options.\nArtemis Broker Configuration The Artemis Broker is part of the Apache ActiveMQ project. Hono uses Artemis by means of the EnMasse project\u0026rsquo;s Artemis Docker image created from the Artemis project source code.\nThe Artemis Broker can be configured by means of configuration files. Hono includes an example configuration in the deploy/src/main/config/artemis folder which is used by the example deployment scripts. Please refer to the Artemis documentation for details regarding the configuration file format and options.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/admin-guide/secure_communication/",
+	"title": "Secure Communication",
+	"tags": [],
+	"description": "",
+	"content": "The individual components of an Eclipse Hono\u0026trade; installation, e.g. the protocol adapters, AMQP Messaging Network, Hono Auth etc., and the clients attaching to Hono in order to send and receive data all communicate with each other using AMQP 1.0 over TCP. The Hono components and the clients will usually not be located on the same local network but will probably communicate over public networking infrastructure. For most use cases it is therefore desirable, if not necessary, to provide for confidentiality of the data being transferred between these components. This section describes how Hono supports confidentiality by means of Transport Layer Security (TLS) and how to configure it.\nEnabling TLS All of Hono\u0026rsquo;s components can be configured to use TLS for establishing an encrypted communication channel with peers. When a client initiates a connection with a server, the TLS handshake protocol is used to negotiate parameters of a secure channel to be used for exchanging data. The most important of those parameters is a secret (symmetric) encryption key that is only known to the client and the server and which is used to transparently encrypt all data being sent over the connection as long as the connection exists. With each new connection, a new secret key is negotiated.\nUsing TLS in this way requires configuring the server component with a cryptographic private/public key pair and a certificate which binds an identity claim to the public key. It is out of scope of this document to describe the full process of creating such a key pair and acquiring a corresponding certificate. The demo-certs module already contains a set of keys and certificates to be used for evaluation and demonstration purposes. Throughout the rest of this section we will use these keys and certificates . Please refer to the demo-certs/README.md file for details regarding how to create your own keys and certificates.\nWithin a Hono installation the following communication channels can be secured with TLS:\n Applications connecting to Dispatch Router - Client applications consuming e.g. Telemetry data from Hono connect to the AMQP Messaging Network. This connection can be secured by configuring the client and the messaging network for TLS. Device Registry connecting to Auth Server - The Device Registry connects to the Auth Server in order to verify client credentials and determine the client\u0026rsquo;s authorities. This (internal) connection can (should) be secured by configuring the Auth Server and Device Registry for TLS. Protocol Adapter to Device Registry - A protocol adapter connects to the Device Registry in order to retrieve assertions regarding the registration status of devices. This (internal) connection can be secured by configuring the protocol adapter and the Device Registry for TLS. Protocol Adapter connecting to AMQP Messaging Network - A protocol adapter connects to the messaging network in order to forward telemetry data and commands hence and forth between downstream components (client applications) and devices. This (internal) connection can be secured by configuring the Dispatch Router and the protocol adapters for TLS. Devices connecting to a Protocol Adapter - Devices use TLS to both authenticate the protocol adapter and to establish an encrypted channel that provides integrity and privacy when transmitting data. Note that the specifics of if and how TLS can be used with a particular protocol adapter is specific to the transport protocol the adapter uses for communicating with the devices. Liveness/readiness probes connecting to Service Health Checks - Systems like Kubernetes are periodically checking the health status of the individual services . This communication can be secured by configuring the health check of the individual services to expose a secure endpoint.  Auth Server The Auth Server supports the use of TLS for connections to clients. Please refer to the Auth Server admin guide for details regarding the required configuration steps.\nThe demo-certs/certs folder includes the following demo keys and certificates to be used with the Auth Server for that purpose.\n   File Description     auth-server-key.pem The example private key for creating signatures.   auth-server-cert.pem The example certificate asserting the server\u0026rsquo;s identity.   trusted-certs.pem Trusted CA certificates to use for verifying signatures.    Dispatch Router The Dispatch Router reads its configuration from a file on startup (the default location is /etc/qpid-dispatch/qdrouterd.conf). Please refer to the Dispatch Router documentation for details regarding the configuration of TLS/SSL.\nThe demo-certs/certs folder includes the following demo keys and certificates to be used with the Dispatch Router for that purpose:\n   File Description     qdrouter-key.pem The example private key for creating signatures.   qdrouter-cert.pem The example certificate asserting the server\u0026rsquo;s identity.   trusted-certs.pem Trusted CA certificates to use for verifying signatures.    Device Registry The Device Registry supports the use of TLS for connections to protocol adapters and the Auth Server. Please refer to the Device Registry admin guide for details regarding the required configuration steps.\nThe demo-certs/certs folder contains the following demo keys and certificates to be used with the Device Registry for that purpose.\n   File Description     auth-server-cert.pem The certificate of the Auth Server, used to verify the signatures of tokens issued by the Auth Server.   device-registry-key.pem The example private key for creating signatures.   device-registry-cert.pem The example certificate asserting the server\u0026rsquo;s identity.   trusted-certs.pem Trusted CA certificates to use for verifying signatures.    HTTP Adapter The HTTP adapter supports the use of TLS for its connections to the Tenant service, the Device Registration service, the Credentials service and the AMQP Messaging Network. The adapter also supports the use of TLS for connections with devices. For this purpose, the adapter can be configured with a server certificate and private key. Please refer to the HTTP adapter admin guide for details regarding the required configuration steps.\nThe demo-certs/certs folder contains the following demo keys and certificates to be used with the HTTP adapter for that purpose.\n   File Description     http-adapter-key.pem The example private key for creating signatures.   http-adapter-cert.pem The example certificate asserting the adapter\u0026rsquo;s identity.   trusted-certs.pem Trusted CA certificates to use for verifying signatures.    MQTT Adapter The MQTT adapter supports the use of TLS for its connections to the Tenant service, the Device Registration service, the Credentials service and the AMQP Messaging Network. The adapter also supports the use of TLS for connections with devices. For this purpose, the adapter can be configured with a server certificate and private key. Please refer to the MQTT adapter admin guide for details regarding the required configuration steps.\nThe demo-certs/certs folder contains the following demo keys and certificates to be used with the MQTT adapter for that purpose.\n   File Description     mqtt-adapter-key.pem The example private key for creating signatures.   mqtt-adapter-cert.pem The example certificate asserting the adapter\u0026rsquo;s identity.   trusted-certs.pem Trusted CA certificates to use for verifying signatures.    Kura Adapter The Kura adapter supports the use of TLS for its connections to the Tenant service, the Device Registration service, the Credentials service and the AMQP Messaging Network. The adapter also supports the use of TLS for connections with devices. For this purpose, the adapter can be configured with a server certificate and private key. Please refer to the Kura adapter admin guide for details regarding the required configuration steps.\nThe demo-certs/certs folder contains the following demo keys and certificates to be used with the Kura adapter for that purpose.\n   File Description     kura-adapter-key.pem The example private key for creating signatures.   kura-adapter-cert.pem The example certificate asserting the adapter\u0026rsquo;s identity.   trusted-certs.pem Trusted CA certificates to use for verifying signatures.    Client Application When the connection between an application client and Hono (i.e. the Dispatch Router) is supposed to be secured by TLS (which is a good idea), then the client application needs to be configured to trust the CA that signed the Dispatch Router\u0026rsquo;s certificate chain. Clients can use the org.eclipse.hono.client.HonoConnection.newConnection(ClientConfigProperties) method to establish a connection to Hono. The org.eclipse.hono.config.ClientConfigProperties instance passed in to the method needs to be configured with the trust store containing the CA\u0026rsquo;s certificate. Please refer to the Hono Client configuration guide for details regarding the corresponding configuration properties that need to be set.\nThe demo-certs/certs folder contains the following demo keys to be used with client applications for that purpose.\n   File Description     trusted-certs.pem Trusted CA certificates to use for verifying signatures.    Using OpenSSL Hono\u0026rsquo;s individual services are implemented in Java and therefore, by default, use the SSL/TLS engine that comes with the Java Virtual Machine that the services are running on. In case of the Docker images provided by Hono this is the SSL engine of OpenJDK. While the standard SSL engine has the advantage of being a part of the JVM itself and thus being available on every operating system that the JVM is running on without further installation, it provides only limited performance and throughput when compared to native TLS implementations like OpenSSL.\nIn order to address this problem, the Netty networking library that is used in Hono\u0026rsquo;s components can be configured to employ the OpenSSL instead of the JVM\u0026rsquo;s SSL engine by means of Netty\u0026rsquo;s Forked Tomcat Native (tcnative) module.\nThe tcnative module comes in several flavors, corresponding to the way that the OpenSSL library has been linked in. The statically linked versions include a specific version of OpenSSL (or BoringSSL for that matter) and is therefore most easy to use on supported platforms, regardless of whether another version of OpenSSL is already installed or not. In contrast, the dynamically linked variants depend on a particular version of OpenSSL being already installed on the operating system. Both approaches have their pros and cons and Hono therefore does not include tcnative in its Docker images by default, i.e. Hono\u0026rsquo;s services will use the JVM\u0026rsquo;s default SSL engine by default.\nConfiguring Containers When starting up any of Hono\u0026rsquo;s Docker images as a container, the JVM will look for additional jar files to include in its classpath in the container\u0026rsquo;s /opt/hono/extensions folder. Thus, using a specific variant of tcnative is just a matter of configuring the container to mount a volume or binding a host folder at that location and putting the desired variant of tcnative into the corresponding volume or host folder.r Assuming that the Auth Server should be run with the statically linked, BoringSSL based tcnative variant, the following steps are necessary:\n Download tcnative matching the platform architecture (linux-x86_64). Put the jar file to a folder on the Docker host, e.g. /tmp/tcnative. Start the Auth Server Docker image mounting the host folder:  docker run --name hono-auth-server --mount type=bind,src=/tmp/tcnative,dst=/opt/hono/extensions,ro ... eclipse/hono-service-auth  Note that the command given above does not contain the environment variables and secrets that are usually required to configure the service properly.\nWhen the Auth Server starts up, it will look for a working variant of tcnative on its classpath and (if found) use it for establishing TLS connections. The service\u0026rsquo;s log file will indicate whether the JVM\u0026rsquo;s default SSL engine or OpenSSL is used.\nUsing a Docker volume instead of a bind mount works the same way but requires the use of volume as the type of the --mount parameter. Please refer to the Docker reference documentation for details.\nServer Name Indication (SNI) Server Name Indication can be used to indicate to a server the host name that the client wants to connect to as part of the TLS handshake. This is useful in order to be able to host multiple virtual servers on a single network address. In particular, SNI allows server components to select a server certificate that matches the domain name indicated by the client using SNI.\nHono\u0026rsquo;s protocol adapters support virtual servers by means of SNI as described above. Devices can then connect to a protocol adapter using any one of the configured virtual domain names.\nThe following steps a re necessary in order to configure the protocol adapters with multiple virtual servers:\n Create Server Certificate(s)  When a device establishes a connection to one of Hono\u0026rsquo;s protocol adapters using one of its virtual domain names, then it includes the domain name in its TLS hello message by means of the SNI extension. The server can then use this information to determine the matching server certificate and corresponding private key that is required to perform the TLS handshake.\nIt is therefore necessary to create a private key and certificate for each virtual server to be hosted. The virtual server\u0026rsquo;s domain name needs to be added to the certificate\u0026rsquo;s Subject Alternative Name (SAN) list in order for Hono to be able to determine the key/certificate pair to use for the TLS handshake with the device. Please refer to the vert.x SNI guide for details on how this works under the hood.\nHono\u0026rsquo;s protocol adapters then need to be configured with the server certificates and keys. In order to do so, the certificates and corresponding private keys need to be added to a key store. Hono supports the JKS and PKCS12 key store formats for that purpose. Once the key store has been created, Hono\u0026rsquo;s protocol adapters need to be configured with the path to the key store by means of the adapters\u0026rsquo; KEY_STORE_PATH configuration variable. Please refer to the protocol adapter admin guides for details on how to configure the key store path.\n Enable SNI for Hono\u0026rsquo;s Protocol Adapters  Hono\u0026rsquo;s protocol adapters can be configured to support SNI by means of the SNI configuration variable. Please refer to the protocol adapter admin guides for details on how to set this variable.\n Verify Configuration  The setup can be verified by means of the command line tools that are part of OpenSSL. Assuming that the MQTT protocol adapter\u0026rsquo;s IP address is 10.100.84.23, its secure endpoint is bound to port 31884 and it has been configured with a certificate using domain name my-hono.eclipse.org, then the following command can be used to test if a TLS secured connection with the adapter using that virtual host name can be established successfully:\nopenssl s_client -connect 10.100.84.23:31884 -servername my-hono.eclipse.org "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/admin-guide/monitoring-tracing-config/",
+	"title": "Monitoring &amp; Tracing",
+	"tags": [],
+	"description": "",
+	"content": "The individual components of an Eclipse Hono\u0026trade; installation need to work together in order to provide their functionality to devices and applications. Under normal circumstances these interactions work flawlessly. However, due to the nature of distributed systems, any one (or more) of the components may crash or become otherwise unavailable due to arbitrary reasons. This page describes how Hono supports operations teams by providing insights into the individual service components and their interactions with each other by means of reporting metrics and tracing the processing of individual messages through the system.\nWhen a device uploads telemetry data to the HTTP adapter, the adapter invokes operations on the Device Registration, Credentials and the Tenant services in order to authenticate and authorize the device before sending the telemetry data downstream to the AMQP 1.0 Messaging Network. The overall success of this process and the latency involved before the message reaches the consumer is determined by the individual interactions between the service components.\nMonitoring In a production environment, an operations team will usually want to keep track of some key performance indicators (KPI) which allow the team to determine the overall health of the system, e.g. memory and CPU consumption etc. Hono supports the tracking of such KPIs by means of metrics it can be configured to report. The metrics are usually collected in a time series database like InfluxDB or Prometheus and then visualized on a monitoring dash-board built using frameworks like Grafana. Such a dash-board can usually also be configured to send alarms when certain thresholds are exceeded.\nMetrics usually provide insights into the past and current status of an individual component. The values can be aggregated to provide a picture of the overall system\u0026rsquo;s status. As such, metrics provide a great way to monitor system health and, in particular, to anticipate resource shortages and use such knowledge to pro-actively prevent system failure.\nConfiguring a Metrics Back End Hono uses Micrometer for providing metrics. It is possible to drop in any Micrometer compatible back end. Hono also uses the Micrometer integration with Spring Boot and Vert.x.\nPlease refer to the Micrometer documentation for details regarding the configuration of a specific Micrometer back end. In most cases, you only need to add the back end specific jar files to the class path and add back end specific configuration to the application.yml file.\nThe Hono build supports configuration of a specific metrics back end by means of Maven profiles. The following build profiles are currently supported:\n metrics-prometheus – Enables the Prometheus backend. metrics-graphite – Enables the Graphite backend. metrics-influxdb – Enables the InfluxDB backend.  Additionally to selecting a metrics back end, you may need to configure the back end using Spring configuration options. See the documentation mentioned above for more information.\nNote that none of the above profiles are active by default, i.e. you need to explicitly activate one of them when starting the build using Maven\u0026rsquo;s -p command line parameter.\nUsing Prometheus Most of the metrics back ends have data being pushed to from the components reporting the metrics. However, Prometheus is different in that it polls (or scrapes) all components periodically for new metrics data. For this to work, the Prometheus server needs to be configured with the IP addresses of the components to monitor. In the example deployment that comes with Hono, the Prometheus server is configured with the names of the Kubernetes services corresponding to the Hono components that it should scrape. The components themselves need to expose a corresponding HTTP endpoint that the Prometheus server can connect to for scraping the meter data. All Hono components that report metrics can be configured to expose such an endpoint via their Health Check server which already exposes endpoints for determining the component\u0026rsquo;s readiness and liveness status.\nHealth Check Server Configuration All of Hono\u0026rsquo;s service components and protocol adapters contain a Health Check server which can be configured to expose several HTTP endpoints for determining the component\u0026rsquo;s status. In particular, the server exposes a /readiness, a /liveness and an optional /prometheus URI endpoint.\nThe former two endpoints are supposed to be used by container orchestration platforms like Kubernetes to monitor the runtime status of the containers that it manages. These endpoints are always exposed when the health check server is started.\nThe /prometheus endpoint can be used by a Prometheus server to retrieve collected meter data from the component. It is only exposed if Prometheus has been configured as the metrics back end as described above.\nThe health check server can be configured by means of the following environment variables:\n   Environment Variable\nCommand Line Option Default Value Description     HONO_HEALTHCHECK_BINDADDRESS\n--hono.healthCheck.bindAddress 127.0.0.1 The IP address of the network interface that the health check server\u0026rsquo;s secure port should be bound to. The server will only be started if this property is set to some other than the default value and corresponding key material has been configured using the HONO_HEALTHCHECK_KEYPATH and HONO_HEALTHCHECK_CERTPATH variables.   HONO_HEALTHCHECK_CERTPATH\n--hono.healthCheck.certPath - The absolute path to the PEM file containing the certificate that the secure server should use for authenticating to clients. This option must be used in conjunction with HONO_HEALTHCHECK_KEYPATH.\nAlternatively, the HONO_HEALTHCHECK_KEYSTOREPATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_HEALTHCHECK_INSECUREPORTBINDADDRESS\n--hono.healthCheck.insecurePortBindAddress 127.0.0.1 The IP address of the network interface that the health check server\u0026rsquo;s insecure port should be bound to. The server will only be started if this property is set to some other than the default value.   HONO_HEALTHCHECK_INSECUREPORT\n--hono.healthCheck.insecurePort 8088 The port that the insecure server should listen on.   HONO_HEALTHCHECK_KEYPATH\n--hono.healthCheck.keyPath - The absolute path to the (PKCS8) PEM file containing the private key that the secure server should use for authenticating to clients. This option must be used in conjunction with HONO_HEALTHCHECK_CERTPATH. Alternatively, the HONO_HEALTHCHECK_KEYSTOREPATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_HEALTHCHECK_PORT\n--hono.healthCheck.port 8088 The port that the secure server should listen on.   HONO_HEALTHCHECK_KEYSTOREPASSWORD\n--hono.healthCheck.keyStorePassword - The password required to read the contents of the key store.   HONO_HEALTHCHECK_KEYSTOREPATH\n--hono.healthCheck.keyStorePath - The absolute path to the Java key store containing the private key and certificate that the secure server should use for authenticating to clients. Either this option or the HONO_HEALTHCHECK_KEYPATH and HONO_HEALTHCHECK_CERTPATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively. The HONO_HEALTHCHECK_KEYSTOREPASSWORD variable can be used to set the password required for reading the key store.     Failure to start The component/service will fail to start if neither the secure not the insecure server have been configured properly.  Tracing In normal operation the vast majority of messages should be flowing through the system without any noteworthy delays or problems. In fact, that is the whole purpose of Hono. However, that doesn\u0026rsquo;t mean that nothing can go wrong. For example, when a tenant\u0026rsquo;s device administrator changes the credentials of a device in the Credentials service but has not yet updated the credentials on the device yet, then the device will start to fail in uploading any data to the protocol adapter it connects to. After a while, a back end application\u0026rsquo;s administrator might notice, that there hasn\u0026rsquo;t been any data being received from that particular device for quite some time. The application administrator therefore calls up the Hono operations team and complains about the data being lost somewhere.\nThe operations team will have a hard time determining what is happening, because it will need to figure out which components have been involved in the processing of the device and why the data hasn\u0026rsquo;t been processed as usual. The metrics alone usually do not help much here because metrics are usually not scoped to individual devices. The logs written by the individual components, on the other hand, might contain enough information to correlate individual entries in the log with each other and thus trace the processing of the message throughout the system. However, this is usually a very tedious (and error prone) process and the relevant information is often only logged at a level (e.g. DEBUG) that is not used in production (often INFO or above).\nIn order to address this problem, Hono\u0026rsquo;s service components are instrumented using OpenTracing. OpenTracing provides Vendor-neutral APIs and instrumentation for distributed tracing. The OpenTracing web page provides a list of supported tracer implementations from which users can choose in order to collect (and examine) the tracing information generated by Hono\u0026rsquo;s individual components.\nConfiguring a Tracer Hint: The description in this chapter applies to any compatible OpenTracing implementation. For an easier approach to configure usage of Jaeger tracing, see the next chapter.\nHono\u0026rsquo;s components use the OpenTracing Tracer Resolver mechanism to find and initialize a concrete OpenTracing implementation during startup of the component. The discovery mechanism is using Java\u0026rsquo;s ServiceLoader and as such relies on the required resources to be available on the class path.\nWhen starting up any of Hono\u0026rsquo;s Docker images as a container, the JVM will look for additional jar files to include in its class path in the container\u0026rsquo;s /opt/hono/extensions folder. Thus, using a specific implementation of OpenTracing is just a matter of configuring the container to mount a volume or binding a host folder at that location and putting the implementation\u0026rsquo;s jar files and resources into the corresponding volume or host folder.\n Note This also means that (currently) only Tracer implementations can be used with Hono that also implement the Tracer Resolver mechanism.  Assuming that the HTTP adapter should be configured to use Jaeger tracing, the following steps are necessary:\n Download Jaeger\u0026rsquo;s Java Tracer Resolver implementation and its dependencies (see the hint at the end). Put the jars to a folder on the Docker host, e.g. /tmp/jaeger. Start the HTTP adapter Docker image mounting the host folder:\ndocker run --name hono-adapter-http-vertx \\ --mount type=bind,src=/tmp/jaeger,dst=/opt/hono/extensions,ro \\ ... \\ eclipse/hono-adapter-http-vertx   Note: the command given above does not contain the environment variables and secrets that are required to configure the service properly. The environment variables for configuring the Jaeger client are also missing. Please refer to the Jaeger documentation for details.\nWhen the HTTP adapter starts up, it will look for a working implementation of the Tracer Resolver on its classpath and (if found) initialize and use it for publishing traces. The adapter\u0026rsquo;s log file will indicate the name of the Tracer implementation being used.\nUsing a Docker volume instead of a bind mount works the same way but requires the use of volume as the type of the --mount parameter. Please refer to the Docker reference documentation for details.\nHint: to resolve all dependencies for jaeger-tracerresolver in order to provide them to /opt/hono/extensions, you may want to rely on Maven\u0026rsquo;s dependency plugin. To obtain all jar files you can invoke the following command in a simple Maven project that contains only the dependency to jaeger-tracerresolver:\nmvn dependency:copy-dependencies  All jar files can then be found in the directory target/dependency.\nConfiguring usage of Jaeger tracing (included in Docker images) In case Jaeger tracing shall be used, there is an alternative to putting the jar files in the container\u0026rsquo;s /opt/hono/extensions folder as described above. This is to have the Jaeger tracing jar files be included in the Hono Docker images by using the jaeger Maven profile when building Hono.\nFor example, building the HTTP adapter image with the Jaeger client included:\n# in directory: hono/adapters/http-vertx/ mvn clean install -Pbuild-docker-image,jaeger  Note that when running the created docker image, the environment variables for configuring the Jaeger client still need to be set. Please refer to the Jaeger documentation for details.\nEnforcing the recording of traces for a tenant Typically, in production systems, the tracing components will be configured to not store all trace spans in the tracing backend, in order to reduce the performance impact. For debugging purposes it can however be beneficial to enforce the recording of certain traces. Hono allows this by providing a configuration option in the Tenant information with which all traces concerning the processing of telemetry, event and command messages for that specific tenant will be recorded. Furthermore, this enforced trace sampling can be restricted to only apply to messages sent in the context of a specific authentication identifier. Please refer to the description of the tracing object in the Tenant Information for details.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/dev-guide/",
+	"title": "Developer Guide",
+	"tags": [],
+	"description": "",
+	"content": " Developer Guide Learn how to build Eclipse Hono\u0026trade; and how to integrate your custom components with it.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/dev-guide/building_hono/",
+	"title": "Building from Source",
+	"tags": [],
+	"description": "",
+	"content": " Hono can be deployed using the pre-built Docker images available from our Docker Hub repositories. However, customizing and/or extending Hono\u0026rsquo;s functionality requires building the images from source code.\nThis page provides step by step instructions for getting the source code and building the Hono\u0026rsquo;s Docker images from it.\nPrerequisites for building Hono Docker Creating Hono\u0026rsquo;s container images using the Hono build process requires a Docker daemon running either locally or on another host you have access to. Please follow the instructions on the Docker web site to install Docker on your platform.\nJava Hono is written in Java and therefore requires a Java Development Kit (JDK) version 11 or higher installed on your computer. Please follow the JDK vendor\u0026rsquo;s instructions for installing Java on your operating system.\nMaven Hono\u0026rsquo;s build process is based on Apache Maven. You need at least Maven 3.5 in order to build Hono. Please follow the installation instructions on the Maven home page.\nGit A Git client is required if you want to contribute changes/improvements to the Hono project. It is not necessary for simply building Hono locally. Please refer to the Git Downloads page for installation instructions.\nGetting the Hono Source Code Either\n download the latest release archive and extract the archive to a local folder or clone the Hono source code repository from GitHub:  git clone https://github.com/eclipse/hono.git  This will create a hono folder in the current working directory and clone the whole repository into that folder.  Starting the Hono Build Process Run the following from the source folder:\n# in the \u0026quot;hono\u0026quot; folder containing the source code mvn clean install -Ddocker.host=tcp://${host}:${port} -Pbuild-docker-image,metrics-prometheus  with ${host} and ${port} reflecting the name/IP address and port of the host where Docker is running on. This will build all libraries, Docker images and example code. If you are running on Linux and Docker is installed locally or you have set the DOCKER_HOST environment variable, you can omit the -Ddocker.host property definition.\nIf you plan to build the Docker images more frequently, e.g. because you want to extend or improve the Hono code, then you should define the docker.host property in your Maven settings.xml file containing the very same value as you would use on the command line as indicated above. The file is usually located in the .m2 folder in your user\u0026rsquo;s home directory. This way you can simply do a mvn clean install later on and the Docker images will be built automatically as well because the build-docker-image profile is activated automatically if the Maven property docker.host is set.\n Be patient The first build might take several minutes because Docker will need to download all the base images that Hono is relying on. However, most of these will be cached by Docker so that subsequent builds will be running much faster.  Perform the integration tests The source code for Hono comes with a test suite for integration testing. To trigger these tests, change to the tests folder and execute:\n# in the \u0026quot;hono/tests\u0026quot; folder containing the test suite mvn verify -Prun-tests  The tests are executed against the Docker images of the Hono components. Because of that, it is necessary to build the respective images as described above before the execution of the tests. The respective Readme.md file in the folder hono/tests contains more information regarding the test suite.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/dev-guide/amqp_adapter_client/",
+	"title": "AMQP Adapter Client for Java",
+	"tags": [],
+	"description": "",
+	"content": " Eclipse Hono\u0026trade; comes with a Java client for the AMQP adapter. It is intended for the implementation of (prototype) devices, (protocol) gateways or (end-to-end) tests. The client is based on Eclipse Vert.x.\nThe starting point is the class AmqpAdapterClientFactory.\nThe factory provides methods to get a receiver for receiving commands and a sender for each of the following actions:\n send a telemetry message send an event message send a response to a previously received command   Do not re-use sender instances The senders manage the underlying AMQP sender links, which are restored after temporary interruption of the connection (HonoConnection manages the automatic reconnection). To achieve this, a caching mechanism is used, so that defective links are replaced by new ones. The sender must be always retrieved from the factory when sending because otherwise the link might no longer exist. So, do not hold references to sender objects and re-use them for subsequent send operations!  For examples of how to use the client, see the example implementation in the AmqpExampleDevice class.\nUsage in a Gateway There are two ways to subscribe to commands for use in a gateway:\n Gateway subscribing for commands for a specific device: The gateway subscribes individually for each connected device by creating a command consumer for the specific device. Gateway subscribing for commands for all its devices: The gateway subscribes for commands sent to all the different devices that the gateway acts on behalf of by creating a command consumer that is not scoped on a specific device.  Subscribing for all devices does not work if multiple instances of the gateway are running at the same time, because a command is only sent to one receiver, and this may be an instance that has no connection to the device. On the other hand, subscribing for a specific device once it connects to the gateway instance (and closing the subscription once it disconnects) may not work for device-oriented protocols that are not connection-based.\nTracing The AMQP Adapter Client supports tracing of the messages with OpenTracing. To use tracing, each of the senders returned by the factory can be cast to an interface with the same name and the prefix \u0026ldquo;Traceable\u0026rdquo; (e.g. cast TelemetrySender to TraceableTelemetrySender). The traceable interfaces provide send methods with an additional SpanContext parameter.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/dev-guide/java_client_consumer/",
+	"title": "Consuming Messages from Java",
+	"tags": [],
+	"description": "",
+	"content": " To illustrate how Eclipse Hono\u0026trade; can be integrated with Java code, a simple application is provided that consumes telemetry and event data for devices belonging to the default tenant.\nIt also includes support for Command and Control:\nif indicated by a received downstream message that contains a ttd value (refer to Device notifications for details) it tries to send a command to the device. If the value of ttd indicates that the device stays connected for an unlimited time (ttd == -1), the application will periodically repeat to send a command until notified the device is disconnected again (ttd == 0).\nThis application shall serve as a blueprint to integrate your existing java source code with Hono. Its code is found in the example module in the package org.eclipse.hono.vertx.example.\nThe provided classes are kept as simple as possible (in the tradition of a classical \u0026ldquo;Hello World\u0026rdquo; implementation) while still covering the most relevant messaging patterns (downstream and upstream messages). For this purpose they make use of simple constant definitions and deal with exceptions as rarely as possible. You may want to change the level of detail that should be logged to the console by editing the contained resources/logback.xml file.\nPlease refer to the javadoc of the classes for details.\n Note Note that production ready code likely has to think more about error handling and logging than this simple blueprint.  Configure the example For simplicity, all configurations are defined as Java constants inside the class HonoExampleConstants.\nIf you have Hono running in Docker under localhost, the example should work out of the box.\nSome configuration values can be overridden by providing them as property to the application.\nThis includes the host and the port of the AMQP network. In the standard setup of Hono they should be configured to the qdrouter from the Apache Qpid project. In production scenarios this might be a large setup of AMQP routers, brokers, etc.\nPlease refer to the class HonoExampleConstants to find out which part of the application can be configured by properties.\nRun the example The application waits for messages until you press any key or kill it.\nIt is started by\n# in directory: hono/example/ mvn exec:java -Dexec.mainClass=org.eclipse.hono.vertx.example.HonoExampleApplication  or \u0026mdash; if e.g. the host of the AMQP network should be changed \u0026mdash;\nmvn exec:java -Dexec.mainClass=org.eclipse.hono.vertx.example.HonoExampleApplication -Dconsumer.host=192.168.99.100  Telemetry and Event messages Depending on the logger configuration, all received downstream messages are printed to the console.\nPlease note that consumers do not connect with Hono directly, but rather with an AMQP router network.\nCommand and Control By using a helper class provided by Hono, a callback in the application code is invoked when a downstream message was received that signals the device will stay connected to the protocol adapter for some time (see Device notifications for details).\nInside this callback an arbitrary simple command is sent down to the device (once or periodically) and the response is logged to the console.\nEncryption of communication For the encrypted communication with Hono, the necessary truststore is already installed and used by the Hono client.\nIf you want to integrate the code with your own software, please copy the provided truststore (hono/demo-certs/certs/trusted-certs.pem) from the Hono project to the resources directory of your project and adopt the code pointing to the file location.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/dev-guide/custom_http_adapter/",
+	"title": "Implement a Custom Hono HTTP Protocol Adapter",
+	"tags": [],
+	"description": "",
+	"content": "Eclipse Hono\u0026trade; comes with a default HTTP Adapter which can be used to interact with devices via HTTP. The default HTTP Adapter also serves as a blueprint for implementing a custom HTTP protocol adapter.\nThis section will guide you through the steps to build your own custom HTTP protocol adapter.\nPrerequisites You should be familiar with the setup and start of Hono. Refer to the Getting Started guide.\nThe standard HTTP Adapter Hono\u0026rsquo;s HTTP Adapter supports telemetry and event data processing. Please refer to the HTTP Adapter User Guide and HTTP Adapter Admin Guide for details regarding the usage and configuration of the HTTP Adapter.\nYou can find the source of the HTTP Adapter at https://github.com/eclipse/hono/tree/master/adapters/http-vertx.\nAnatomy of the standard HTTP Adapter Like many other Hono components, the HTTP Adapter is built on top of the Vert.x framework.\nThe HTTP Adapter\u0026rsquo;s VertxBasedHttpProtocolAdapter class is derived from an abstract base class. This base class implements the standard functionality for component initialization, receiving HTTP requests from devices or external clients, and forwarding of data to the downstream AMQP Messaging Network.\nDerive a custom HTTP Protocol Adapter Use the standard HTTP Adapter as a blueprint.\nAdding Routes In Vert.x, a route is a mapping of an HTTP request to a handler. Inside a route, Vert.x provides a RoutingContext instance which gives access to the HTTP request (and response) object containing the HTTP headers.\nThe standard HTTP Adapter overrides the abstract method addRoutes(), provided by the base class, and adds routes for processing telemetry data and events.\n// route for uploading telemetry data router.route(HttpMethod.PUT, String.format(\u0026quot;/telemetry/:%s/:%s\u0026quot;, PARAM_TENANT, PARAM_DEVICE_ID)) .handler(ctx -\u0026gt; uploadTelemetryMessage(ctx, getTenantParam(ctx), getDeviceIdParam(ctx)));  The route for telemetry data parses the HTTP request, extracts the tenant and deviceId parameters from the request URL path, and forwards the message payload to the method uploadTelemetryMessage(), provided by the base class.\nNB Note the Vert.x place holder indicators : inside the URL path pattern /telemetry/:%s/:%s. Vert.x makes matching place holders available as request parameters. See Capturing path parameters in the Vert.x documentation.\nThe route for events looks very similar to the route for telemetry data. It forwards the event message payload to the uploadEventMessage() method.\nPlease refer to the Telemetry API and Event API for details about the different Hono APIs.\nIn the custom HTTP protocol adapter adapt the routes according to your needs.\nBuild and run the custom HTTP Protocol Adapter If you have Hono running, you can launch your custom HTTP protocol adapter as a Docker Container or a Spring Boot application.\nYou may adopt the Maven profile build-docker-image from the Maven POM file of the standard HTTP Adapter into your custom adapter\u0026rsquo;s Maven POM file.\nFollow the guidelines for running the HTTP Adapter in HTTP Adapter. Don\u0026rsquo;t forget to configure the custom protocol adapter to bind to a different port than the standard HTTP Adapter if you intend to run them both at the same time. See the Port Configuration section of the HTTP Adapter documentation for details.\nUsing the custom HTTP Protocol Adapter Now that you have your custom HTTP protocol adapter up and running, you can use any HTTP client, like curl or HTTPie, to publish data to your custom adapter.\nNote that before publishing data to your custom HTTP protocol adapter, you need to start a consumer for the tenant you intend to publish data for. Otherwise you will not be able to successfully send data. For this purpose, you may use the example consumer as described in the Getting Started guide.\nFurther extend the custom HTTP Protocol Adapter The abstract base class includes additional hooks which you may use to plug into the adapter\u0026rsquo;s life cycle:\n   Hook Description     preStartup() called before start of adapter\u0026rsquo;s HTTP server   onStartupSuccess() called after successful start of adapter   preShutdown() called before stop of adapter\u0026rsquo;s HTTP server   postShutdown called after successful stop of adapter   "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/api/",
+	"title": "API",
+	"tags": [],
+	"description": "",
+	"content": " API Documentation of the APIs defined by Eclipse Hono\u0026trade;.\nFor an overview of the available APIs, see the architecture documentation.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/api/telemetry/",
+	"title": "Telemetry API Specification",
+	"tags": [],
+	"description": "",
+	"content": "The Telemetry API is used by Protocol Adapters to send telemetry data downstream. Business Applications and other consumers use the API to receive data published by devices belonging to a particular tenant.\nThe Telemetry API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using AMQP 1.0 in order to invoke operations of the API as described in the following sections. Throughout the remainder of this page we will simply use AMQP when referring to AMQP 1.0.\nSouthbound Operations The following operations can be used by Protocol Adapters to forward telemetry data received from devices to downstream consumers like Business Applications.\nForward Telemetry Data Preconditions\n Adapter has established an AMQP connection with the AMQP Messaging Network. Adapter has established an AMQP link in role sender with the AMQP Messaging Network using target address telemetry/${tenant_id} where ${tenant_id} is the ID of the tenant that the client wants to upload telemetry data for. The device for which the adapter wants to send telemetry data has been registered (see Device Registration API).  The adapter indicates its preferred message delivery mode by means of the snd-settle-mode and rcv-settle-mode fields of its attach frame during link establishment.\n   snd-settle-mode rcv-settle-mode Delivery semantics     unsettled, mixed first Using unsettled for the snd-settle-mode allows for adapters to implement both AT LEAST ONCE or AT MOST ONCE delivery semantics, depending on whether the adapter waits for and considers the disposition frames it receives from the AMQP Messaging Network or not. This is the recommended mode for forwarding telemetry data.   settled first Using settled for the snd-settle-mode allows for adapters to implement AT MOST ONCE delivery semantics only. This is the fastest mode of delivery but has the drawback of less reliable end-to-end flow control and potential loss of messages without notice.    All other combinations are not supported by Hono and may result in the termination of the link or connection (depending on the configuration of the AMQP Messaging Network).\nMessage Flow\nAs indicated above, it is up to the discretion of the protocol adapter whether it wants to use AT LEAST ONCE or AT MOST ONCE delivery semantics.\nHono\u0026rsquo;s HTTP adapter allows devices to indicate, which delivery semantics they want to use when uploading telemetry data. The HTTP adapter always forwards messages unsettled and either ignores the outcome of the message transfer (AT MOST ONCE) or waits for the downstream peer to accept the message (AT LEAST ONCE) before acknowledging the reception of the message to the device.\nThe following sequence diagram illustrates the flow of messages involved in the HTTP Adapter forwarding an unsettled telemetry data message to the downstream AMQP Messaging Network implementing AT MOST ONCE delivery semantics.\n  Forward telemetry data flow (AT MOST ONCE)    Device 4711 PUTs telemetry data to the HTTP Adapter  HTTP Adapter transfers telemetry data to AMQP 1.0 Messaging Network. HTTP Adapter acknowledges the reception of the data to the Device.  AMQP 1.0 Messaging Network acknowledges reception of the message which is ignored by the HTTP Adapter.   Note In the example above the HTTP adapter does not wait for the outcome of the transfer of the message to the AMQP Messaging Network before sending back the HTTP response to the device. If the messaging network had sent a disposition frame with the rejected instead of the accepted outcome, the HTTP adapter would still have signaled a 202 status code back to the device. In this case the data would have been lost without the device noticing.  The following sequence diagram illustrates the flow of messages involved in the HTTP Adapter forwarding an unsettled telemetry data message to the downstream AMQP Messaging Network implementing AT LEAST ONCE delivery semantics.\n  Forward telemetry data flow (AT LEAST ONCE)    Device 4711 PUTs telemetry data to the HTTP Adapter, indicating QoS Level 1.  HTTP Adapter transfers telemetry data to AMQP 1.0 Messaging Network. AMQP 1.0 Messaging Network acknowledges reception of the message. HTTP Adapter acknowledges the reception of the data to the Device.   When the AMQP Messaging Network fails to settle the transfer of a telemetry message or settles the transfer with any other outcome than accepted, the protocol adapter MUST NOT try to re-send such rejected messages but SHOULD indicate the failed transfer to the device if the transport protocol provides means to do so.\nMessage Format\nThe following table provides an overview of the properties a client needs to set on a Forward Telemetry Data message.\n   Name Mandatory Location Type Description     content-type yes properties symbol A content type indicating the type and characteristics of the data contained in the payload, e.g. text/plain; charset=\u0026quot;utf-8\u0026quot; for a text message or application/json etc. The value may be set to application/octet-stream if the message payload is to be considered opaque binary data.   creation-time no properties timestamp The instant in time when the message has been created (see the AMQP 1.0 specification for details). This property is mandatory if ttd is set, otherwise it is optional.   device_id yes application-properties string The identifier of the device that the data in the payload is originating from.   ttd no application-properties int The time \u0026lsquo;til disconnect indicates the number of seconds that the device will remain connected to the protocol adapter. The value of this property must be interpreted relative to the message\u0026rsquo;s creation-time. A value of -1 is used to indicate that the device will remain connected until further notice, i.e. until another message indicates a ttd value of 0. In absence of this property, the connection status of the device is to be considered indeterminate. Backend Applications might use this information to determine a time window during which the device will be able to receive a command.    The body of the message MUST consist of a single AMQP Data section containing the telemetry data. The format and encoding of the data MUST be indicated by the content-type and (optional) content-encoding properties of the message.\nAny additional properties set by the client in either the properties or application-properties sections are preserved by Hono, i.e. these properties will also be contained in the message delivered to consumers.\nNorthbound Operations Receive Telemetry Data Hono delivers messages containing telemetry data reported by a particular device in the same order that they have been received in (using the Forward Telemetry Data operation). Hono MAY drop telemetry messages that it cannot deliver to any consumers. Reasons for this include that there are no consumers connected to Hono or the existing consumers are not able to process the messages from Hono fast enough.\nHono supports multiple non-competing Business Application consumers of telemetry data for a given tenant. Hono allows each Business Application to have multiple competing consumers for telemetry data for a given tenant to share the load of processing the messages.\nPreconditions\n Client has established an AMQP connection with Hono. Client has established an AMQP link in role receiver with Hono using source address telemetry/${tenant_id} where ${tenant_id} represents the ID of the tenant the client wants to retrieve telemetry data for.  Hono supports both AT MOST ONCE as well as AT LEAST ONCE delivery of telemetry messages. However, clients SHOULD use AT LEAST ONCE delivery in order to support end-to-end flow control and therefore SHOULD set the snd-settle-mode field to unsettled and the rcv-settle-mode field to first in their attach frame during link establishment.\nA client MAY indicate to Hono during link establishment that it wants to distribute the telemetry messages received for a given tenant among multiple consumers by including a link property subscription-name whose value is shared by all other consumers of the tenant. Hono ensures that messages from a given device are delivered to the same consumer. Note that this also means that telemetry messages MAY not be evenly distributed among consumers, e.g. when only a single device sends data. NB This feature is not supported yet.\nIn addition a client MAY include a boolean link property ordering-required with value false during link establishment in order to indicate to Hono that it does not require messages being delivered strictly in order per device but instead allows for messages being distributed evenly among the consumers. NB This feature is not supported yet.\nMessage Flow\nThe following sequence diagram illustrates the flow of messages involved in a Business Application receiving a telemetry data message from Hono. The delivery mode used is AT LEAST ONCE.\n  Receive Telemetry Data    AMQP 1.0 Messaging Network delivers telemetry message to Business Application.  Business Application acknowledges reception of message.    Note The Business Application can only consume telemetry messages that have been uploaded to Hono after the Business Application has established the link with the AMQP 1.0 Messaging Network. This is because telemetry messages are not durable, i.e. they are not persisted in Hono in order to be forwarded at a later time.  Message Format\nThe format of the messages containing the telemetry data is the same as for the Forward Telemetry Data operation.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/api/event/",
+	"title": "Event API Specification",
+	"tags": [],
+	"description": "",
+	"content": "The Event API is used by Protocol Adapters to send event messages downstream. Business Applications and other consumers use the API to receive messages published by devices belonging to a particular tenant.\nThe Event API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using AMQP 1.0 in order to invoke operations of the API as described in the following sections. Throughout the remainder of this page we will simply use AMQP when referring to AMQP 1.0.\nSouthbound Operations The following operations can be used by Protocol Adapters to forward event messages received from devices to downstream consumers like Business Applications.\nForward Event Preconditions\n Adapter has established an AMQP connection with the AMQP Messaging Network. Adapter has established an AMQP link in role sender with the AMQP Messaging Network using target address event/${tenant_id} where ${tenant_id} is the ID of the tenant that the client wants to upload event messages for. The device for which the adapter wants to send an event has been registered (see Device Registration API).  Hono supports AT LEAST ONCE delivery of Event messages only. A client therefore MUST use unsettled for the snd-settle-mode and first for the rcv-settle-mode fields of its attach frame during link establishment. All other combinations are not supported by Hono and may result in the termination of the link or connection (depending on the configuration of the AMQP Messaging Network).\nThe AMQP messages used to forward events to the AMQP Messaging Network MUST have their durable property set to true. The AMQP Messaging Network is expected to write such messages to a persistent store before settling the transfer with the accepted outcome.\nMessage Flow\nThe following sequence diagram illustrates the flow of messages involved in the MQTT Adapter forwarding an event to the downstream AMQP Messaging Network.\n  Forward event flow    Device 4711 publishes an event using MQTT QoS 1.  MQTT Adapter transfers data to AMQP 1.0 Messaging Network. AMQP 1.0 Messaging Network acknowledges reception of the message. MQTT Adapter acknowledges the reception of the message to the Device.   When the AMQP Messaging Network fails to settle the transfer of an event message or settles the transfer with any other outcome than accepted, the protocol adapter MUST NOT try to re-send such rejected messages but MUST indicate the failed transfer to the device if the transport protocol provides means to do so.\nMessage Format\nSee Telemetry API for definition of message format.\nNorthbound Operations Receive Events Hono delivers messages containing events reported by a particular device in the same order that they have been received in (using the Forward Event operation).\nHono supports multiple non-competing Business Application consumers of event messages for a given tenant. Hono allows each Business Application to have multiple competing consumers for event messages for a given tenant to share the load of processing the messages.\nPreconditions\n Client has established an AMQP connection with Hono. Client has established an AMQP link in role receiver with Hono using source address event/${tenant_id} where ${tenant_id} represents the ID of the tenant the client wants to retrieve event messages for.  Hono supports AT LEAST ONCE delivery of Event messages only. A client therefore MUST use unsettled for the snd-settle-mode and first for the rcv-settle-mode fields of its attach frame during link establishment. All other combinations are not supported by Hono and result in the termination of the link.\nMessage Flow\nThe following sequence diagram illustrates the flow of messages involved in a Business Application receiving an event message from Hono.\n  Receive event data flow (success)    AMQP 1.0 Messaging Network delivers event message to Business Application.  Business Application acknowledges reception of message.   Message Format\nSee Telemetry API for definition of message format.\nWell-known Event Message Types Hono defines several well-known event types which have specific semantics. Events of these types are identified by means of the AMQP message\u0026rsquo;s content-type.\nEmpty Notification An AMQP message containing this type of event does not have any payload so the body of the message MUST be empty.\nThe AMQP 1.0 properties an event sender needs to set for an empty notification event are defined in the Telemetry API.\nThe relevant properties are listed again in the following table:\n   Name Mandatory Location Type Description     content-type yes properties symbol MUST be set to application/vnd.eclipse-hono-empty-notification   ttd no application-properties int The time \u0026lsquo;til disconnect as described in the Telemetry API.    NB An empty notification can be used to indicate to a Business Application that a device is currently ready to receive an upstream message by setting the ttd property. Backend Applications may use this information to determine the time window during which the device will be able to receive a command.\nConnection Event Protocol Adapters may send this type of event to indicate that a connection with a device has been established or has ended. Note that such events can only be sent for authenticated devices, though, because an event is always scoped to a tenant and the tenant of a device is established as part of the authentication process.\nThe AMQP message for a connection event MUST contain the following properties in addition to the standard event properties:\n   Name Mandatory Location Type Description     content-type yes properties symbol Must be set to application/vnd.eclipse-hono-dc-notification+json   device_id yes application-properties string The ID of the authenticated device    Each connection event\u0026rsquo;s payload MUST contain a UTF-8 encoded string representation of a single JSON object with the following fields:\n   Name Mandatory Type Description     cause yes string The cause of the connection event. MUST be set to either connected or disconnected.   remote-id yes string An identifier of the device that is the subject of this event, e.g. an IP address:port, client id etc. The format and semantics of this identifier is specific to the protocol adapter and the transport protocol it supports.   source yes string The type name of the protocol adapter reporting the event, e.g. hono-mqtt.   data no object An arbitrary JSON object which may contain additional information about the occurrence of the event.    The example below might be used by the MQTT adapter to indicate that a connection with a device using client identifier mqtt-client-id-1 has been established:\n{ \u0026quot;cause\u0026quot;: \u0026quot;connected\u0026quot;, \u0026quot;remote-id\u0026quot;: \u0026quot;mqtt-client-id-1\u0026quot;, \u0026quot;source\u0026quot;: \u0026quot;hono-mqtt\u0026quot;, \u0026quot;data\u0026quot;: { \u0026quot;foo\u0026quot;: \u0026quot;bar\u0026quot; } } "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/api/command-and-control/",
+	"title": "Command &amp; Control API Specification",
+	"tags": [],
+	"description": "",
+	"content": "The Command \u0026amp; Control API of Eclipse Hono\u0026trade; is used by Business Applications to send commands to connected devices.\nCommands can be used to trigger actions on devices. Examples include updating a configuration property, installing a software component or switching the state of an actuator.\nHono distinguishes two types of commands. The first type is one-way only. In this case the sender of the command does not expect the device to send back a message in response to the command. This type of command is referred to as a one-way command in the remainder of this page. One-way commands may be used to e.g. notify a device about a change of state.\nThe second type of commands expects a response to be sent back from the device as a result of processing the command. In this case the response contains a status code which indicates whether the command could be processed successfully. If so, the response may also include data representing the result of processing the command. This type of command is plainly referred to as a command because it represents the default case.\nThe Command \u0026amp; Control API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using AMQP 1.0 in order to invoke operations of the API as described in the following sections. Throughout the remainder of this page we will simply use AMQP when referring to AMQP 1.0.\nSend a One-Way Command Business Applications use this operation to send a command to a device for which they do not expect to receive a response from the device.\nPreconditions\n The Business Application has established an AMQP connection with the AMQP 1.0 Network. The Business Application has established an AMQP link in role sender with the target address command/${tenant_id}, where ${tenant_id} is the ID of the tenant that the device belongs to. This link is used by the Business Application to send command messages.  The following sequence diagram illustrates the establishment of the required link:\n  Application connecting to the AMQP 1.0 Messaging Network   Message Format\nThe following table provides an overview of the properties the Business Application needs to set on a one-way command message.\n   Name Mandatory Location Type Description     to yes properties string MUST contain the target address command/${tenant_id}/${device_id} of the message, where ${device_id} is the ID of the device to send the message to.   subject yes properties string The name of the command to be executed by the device.   content-type no properties string If present, MUST contain a Media Type as defined by RFC 2046 which describes the semantics and format of the command\u0026rsquo;s input data contained in the message payload. However, not all protocol adapters will support this property as not all transport protocols provide means to convey this information, e.g. MQTT 3.1.1 has no notion of message headers.   message-id no properties string An identifier that uniquely identifies the message at the sender side.    The command message MAY contain arbitrary payload to be sent to the device in a single AMQP Data section. The value of the message\u0026rsquo;s subject property may provide a hint to the device regarding the format, encoding and semantics of the payload data.\nHono indicates the outcome of the operation by means of the following AMQP delivery states:\n   Delivery State Description     accepted The command has been delivered to the device for processing.   released The command has not been delivered to the device because the device is (currently) not connected.   rejected The command has not been delivered to the device because it does not contain all required information.    Note that Hono relies on the particular protocol adapter to deliver commands to devices. Depending on the used transport protocol and the adapter\u0026rsquo;s implementation, the accepted outcome may thus indicate any of the following:\n An attempt has been made to deliver the command to the device. However, it is unclear if the device has received (or processed) the command. The device has acknowledged the reception of the command but has not processed the command yet. The device has received and processed the command.  Examples\nThe following sequence diagram shows the successful delivery of a one-way command called switchOn to device 4711 of the DEFAULT_TENANT:\n  Successfully send a One-Way Command   The following sequence diagram shows how the delivery of the same one-way command fails because the device is not connected:\n  Device not connected   The following sequence diagram illustrates how a malformed command sent by a Business Application gets rejected:\n  Malformed Command message   Send a (Request/Response) Command Business Applications use this operation to send a command to a device for which they expect the device to send back a response.\n\nPreconditions\n The Business Application has established an AMQP connection with the AMQP 1.0 Network. The Business Application has established an AMQP link in role sender with the target address command/${tenant_id}, where ${tenant_id} is the ID of the tenant that the device belongs to. This link is used by the Business Application to send command messages. The Business Application has established an AMQP link in role receiver with the source address command_response/${tenant_id}/${reply_id}. This link is used by the Business Application to receive the response to the command from the device. This link’s source address is also used as the reply-to address for the request messages. The ${reply_id} may be any arbitrary string chosen by the application.  The following sequence diagram illustrates the establishment of the required links:\n  Application connecting to the AMQP 1.0 Messaging Network   Command Message Format\nThe following table provides an overview of the properties the Business Application needs to set on a command message.\n   Name Mandatory Location Type Description     to yes properties string MUST contain the target address command/${tenant_id}/${device_id} of the message, where ${device_id} is the ID of the device to send the message to.   subject yes properties string MUST contain the command name to be executed by a device.   content-type no properties string If present, MUST contain a Media Type as defined by RFC 2046 which describes the semantics and format of the command\u0026rsquo;s input data contained in the message payload. However, not all protocol adapters will support this property as not all transport protocols provide means to convey this information, e.g. MQTT 3.1.1 has no notion of message headers.   correlation-id no properties string MAY contain an ID used to correlate a response message to the original request. If set, it is used as the correlation-id property in the response, otherwise the value of the message-id property is used. Either this or the message-id property MUST be set.   message-id no properties string MAY contain an identifier that uniquely identifies the message at the sender side. Either this or the correlation-id property MUST be set.   reply-to yes properties string MUST contain the source address that the application expects to receive the response from. This address MUST be the same as the source address used for establishing the client\u0026rsquo;s receiver link (see Preconditions above).    The command message MAY contain arbitrary payload to be sent to the device in a single AMQP Data section. The value of the command message\u0026rsquo;s subject value may provide a hint to the device regarding the format, encoding and semantics of the payload data.\nHono uses following AMQP delivery states to indicate the outcome of sending the command to the device:\n   Delivery State Description     accepted The command has been delivered to the device for processing.   released The command has not been delivered to the device because the device is (currently) not connected.   rejected The command has not been delivered to the device because it does not contain all required information.    Note that Hono relies on the particular protocol adapter to deliver commands to devices. Depending on the used transport protocol and the adapter\u0026rsquo;s implementation, the accepted outcome may thus indicate any of the following:\n An attempt has been made to deliver the command to the device. However, it is unclear if the device has received (or processed) the command. The device has acknowledged the reception of the command but has not processed the command yet.  An application can determine the overall outcome of the operation by means of the response to the command that is sent back by the device. An application should consider execution of a command to have failed, if it does not receive a response within a reasonable amount of time.\nResponse Message Format\nThe following table provides an overview of the properties set on a message sent in response to a command.\n   Name Mandatory Location Type Description     content-type no properties string If present, MUST contain a Media Type as defined by RFC 2046 which describes the semantics and format of the command\u0026rsquo;s input data contained in the message payload. However, not all protocol adapters will support this property as not all transport protocols provide means to convey this information, e.g. MQTT 3.1.1 has no notion of message headers.   correlation-id yes properties string MUST contain the correlation ID used to match the command message with the response message containing the result of execution on the device.   device_id yes application-properties string The identifier of the device that sent the response.   status yes application-properties integer MUST indicate the status of the execution. See table below for possible values.   tenant_id yes application-properties string The identifier of the tenant that the device belongs to.    The status property must contain an HTTP 1.1 response status code:\n   Code Description     2xx The command has been processed successfully.   4xx The command could not be processed due to a client error, e.g. malformed message payload.   5xx The command could not be processed due to an internal problem at the device side.    The semantics of the individual codes are specific to the device and command. For status codes indicating an error (codes in the 400 - 599 range) the message body MAY contain a detailed description of the error that occurred.\nIf a command message response contains a payload, the body of the message MUST consist of a single AMQP Data section containing the response message data.\nExamples\nThe following sequence diagram illustrates how a Business Application sends a command called getReading to device 4711 of the DEFAULT_TENANT and receives a response from the device:\n  Successfully send a Command   The sending of a command may fail for the same reasons as those illustrated for sending a one-way command. Additionally, the sending of a command may be considered unsuccessful by an application if it does not receive the response from the device in a reasonable amount of time:\n  Command times out  "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/api/tenant/",
+	"title": "Tenant API Specification",
+	"tags": [],
+	"description": "",
+	"content": "The Tenant API is used by Hono\u0026rsquo;s protocol adapters to retrieve information that affects all devices belonging to a particular tenant. A tenant is a logical entity, which groups together a set of devices. The information registered for a tenant is used for example to determine if devices belonging to the tenant are allowed to connect to a certain protocol adapter or if devices are required to authenticate.\nThis document describes the Tenant API\u0026rsquo;s operations and the payload data format used by them. Please refer to Multi Tenancy for details regarding the way Hono supports multiple tenants.\nThe Tenant API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using an AMQP 1.0 client in order to invoke operations of the API as described in the following sections.\n\nPreconditions for invoking the Tenant API  Client has established an AMQP connection with the Tenant service. Client has established an AMQP link in role sender on the connection using target address tenant. This link is used by the client to send request messages to the Tenant service. Client has established an AMQP link in role receiver on the connection using source address tenant/${reply-to} where reply-to may be any arbitrary string chosen by the client. This link is used by the client to receive responses to the requests it has sent to the Tenant service. This link\u0026rsquo;s source address is also referred to as the reply-to address for the request messages.    Client connecting to Tenant service   Get Tenant Information Clients use this operation to retrieve information about a tenant.\nMessage Flow\nThe following sequence diagram illustrates the flow of messages involved in a Client retrieving tenant information.\n  Client retrieving tenant information   Request Message Format\nThe following table provides an overview of the properties a client needs to set on a message to get tenant information:\n   Name Mandatory Location AMQP Type Description     correlation-id no properties message-id MAY contain an ID used to correlate a response message to the original request. If set, it is used as the correlation-id property in the response, otherwise the value of the message-id property is used. Either this or the message-id property MUST be set.   message-id no properties string MAY contain an identifier that uniquely identifies the message at the sender side. Either this or the correlation-id property MUST be set.   reply-to yes properties string MUST contain the source address that the client wants to receive response messages from. This address MUST be the same as the source address used for establishing the client\u0026rsquo;s receive link (see Preconditions).   subject yes properties string MUST be set to get.    The body of the request message MUST consist of a single Data section containing a UTF-8 encoded string representation of a single JSON object.\nThe JSON object MUST contain exactly one of the following search criteria properties:\n   Name Mandatory JSON Type Description     subject-dn no string The subject DN of the trusted certificate authority\u0026rsquo;s public key in the format defined by RFC 2253.   tenant-id no string The identifier of the tenant to get.    The following request payload may be used to look up the tenant with identifier ACME Corporation:\n{ \u0026quot;tenant-id\u0026quot;: \u0026quot;ACME Corporation\u0026quot; }  The following request payload may be used to look up the tenant for which a trusted certificate authority with subject DN O=ACME Corporation, CN=devices has been configured:\n{ \u0026quot;subject-dn\u0026quot;: \u0026quot;CN=devices,O=ACME Corporation\u0026quot; }  Response Message Format\nThe following table provides an overview of the properties contained in a response message to a get tenant information request:\n   Name Mandatory Location AMQP Type Description     correlation-id yes properties message-id Contains the message-id (or the correlation-id, if specified) of the request message that this message is the response to.   content-type no properties string MUST be set to application/json if the invocation of the operation was successful and the body of the response message contains payload as described below.   status yes application-properties int Contains the status code indicating the outcome of the operation. Concrete values and their semantics are defined for each particular operation.   cache_control no application-properties string Contains an RFC 2616 compliant cache directive. The directive contained in the property MUST be obeyed by clients that are caching responses.    The response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     200 OK, The response message body contains the requested tenant information.   400 Bad Request, the request message did not contain all mandatory properties.   403 Forbidden, the client is not authorized to retrieve information for the given tenant.   404 Not Found, there is no tenant matching the given search criteria.    For status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred. In this case, the response message\u0026rsquo;s content-type property SHOULD be set accordingly.\nOtherwise the response message contains the information for the requested tenant as described in the following sections.\n\nTenant Information Format Tenant information is carried in a single Data section of the response message as a UTF-8 encoded string representation of a single JSON object. It is an error to include payload that is not of this type.\nThe table below provides an overview of the standard members defined for the JSON response object:\n   Name Mandatory JSON Type Description     adapters no array A list of configuration options valid for certain adapters only. The format of a configuration option is described here Adapter Configuration Format. NB If the element is provided then the list MUST NOT be empty. NB Only a single entry per type is allowed. If multiple entries for the same type are present it is handled as an error. NB If the element is omitted then all adapters are enabled in their default configuration.   defaults no object Arbitrary default properties for devices belonging to the tenant. The properties can be used by protocol adapters to augment downstream messages with missing information, e.g. setting a default content type or time-to-live.   enabled yes boolean If set to false the tenant is currently disabled. Protocol adapters MUST NOT allow devices of a disabled tenant to connect and MUST NOT accept data published by such devices.   minimum-message-size no number The minimum message size in bytes. If it is set then the payload size of the telemetry, event and command messages are calculated in accordance with the configured value and then reported to the metrics. See Metrics for more details.   resource-limits no object Any resource limits that should be enforced for the tenant, e.g. the maximum number of concurrent connections and the maximum data volume for a given period. Refer to Resource Limits Configuration Format for details.   tenant-id yes string The ID of the tenant.   tracing no object A set of options regarding the tracing of messages for the tenant. See Tracing Format for a definition of the content model of the object.   trusted-ca no array The list of trusted certificate authorities to use for validating certificates presented by devices of the tenant for authentication purposes. See Trusted Certificate Authority Format for a definition of the content model of the objects contained in the array. NB If the element is provided then the list MUST NOT be empty.    The JSON object MAY contain an arbitrary number of additional members with arbitrary names which can be of a scalar or a complex type. This allows for future well-known additions and also allows to add further information which might be relevant to a custom adapter only.\nExamples\nThe JSON structure below contains example information for tenant TEST_TENANT. Note that the structure contains some custom properties at both the root level (customer) as well as the adapter configuration level (deployment) and also defines a default TTL for downstream messages.\n{ \u0026quot;tenant-id\u0026quot;: \u0026quot;TEST_TENANT\u0026quot;, \u0026quot;defaults\u0026quot;: { \u0026quot;ttl\u0026quot;: 30 }, \u0026quot;enabled\u0026quot;: true, \u0026quot;customer\u0026quot;: \u0026quot;ACME Inc.\u0026quot;, \u0026quot;resource-limits\u0026quot;: { \u0026quot;max-connections\u0026quot;: 100000, \u0026quot;data-volume\u0026quot;: { \u0026quot;max-bytes\u0026quot;: 2147483648, \u0026quot;period\u0026quot;: { \u0026quot;mode\u0026quot;: \u0026quot;days\u0026quot;, \u0026quot;no-of-days\u0026quot;: 30 }, \u0026quot;effective-since\u0026quot;: \u0026quot;2019-07-27T14:30:00Z\u0026quot; } }, \u0026quot;adapters\u0026quot;: [ { \u0026quot;type\u0026quot;: \u0026quot;hono-mqtt\u0026quot;, \u0026quot;enabled\u0026quot;: true, \u0026quot;device-authentication-required\u0026quot;: true }, { \u0026quot;type\u0026quot;: \u0026quot;hono-http\u0026quot;, \u0026quot;enabled\u0026quot;: true, \u0026quot;device-authentication-required\u0026quot;: true, \u0026quot;deployment\u0026quot;: { \u0026quot;maxInstances\u0026quot;: 4 } } ] }  Tracing Format The table below provides an overview of the members defined for the tracing JSON object:\n   Name Mandatory Type Default Value Description     sampling-mode no string default Defines in how far OpenTracing spans created when processing messages for this tenant shall be recorded (sampled) by the tracing system. The value default lets the default sampling mechanism be used. The value all marks the spans related to this tenant so that they should all be sampled. The value none marks the spans as not to be sampled. The mode defined here may be overridden for a particular auth-id by means of the sampling-mode-per-auth-id property.   sampling-mode-per-auth-id no object  Defines in how far OpenTracing spans created when processing messages for this tenant and a particular auth-id shall be recorded (sampled) by the tracing system. The child properties have the auth-id as name. A child property value of default lets the default sampling mechanism be used. The child property value all marks the spans related to this tenant and the auth-id so that they should all be sampled. The child property value none marks the spans as not to be sampled. The mode defined for a particular auth-id has precedence over the value defined by the sampling-mode property.    Trusted CA Format The table below provides an overview of the members of a JSON object representing a trusted CA:\n   Name Mandatory Type Default Value Description     subject-dn yes string - The subject DN of the trusted root certificate in the format defined by RFC 2253.   public-key yes string - The Base64 encoded binary DER encoding of the trusted root certificate\u0026rsquo;s public key.   algorithm no string RSA The name of the public key algorithm. Supported values are RSA and EC.   auto-provisioning-enabled no boolean false If set to true, protocol adapters MAY request auto-provisioning of devices that authenticate with a client certificate issued by this CA. Otherwise, protocol adapters MUST NOT request auto-provisioning.    NB CAs of the same tenant MAY share the same subject DN, e.g. allowing for the definition of overlapping validity periods. However, CAs of different tenants MUST NOT share the same subject DN in order to allow for the unique look-up of a tenant by the subject DN of one of its trusted CAs.\nExamples\nBelow is an example payload for a response to a get request for tenant TEST_TENANT. The tenant is configured with two trusted certificate authorities, each using a different public key algorithm. Only one of them is configured to be used for auto-provisioning.\n{ \u0026quot;tenant-id\u0026quot; : \u0026quot;TEST_TENANT\u0026quot;, \u0026quot;enabled\u0026quot; : true, \u0026quot;trusted-ca\u0026quot;: [{ \u0026quot;subject-dn\u0026quot;: \u0026quot;CN=ca,OU=Hono,O=Eclipse\u0026quot;, \u0026quot;public-key\u0026quot;: \u0026quot;PublicKey==\u0026quot;, \u0026quot;auto-provisioning-enabled\u0026quot;: false, \u0026quot;algorithm\u0026quot;: \u0026quot;RSA\u0026quot; }, { \u0026quot;subject-dn\u0026quot;: \u0026quot;CN=ca,OU=Hono,O=ACME Inc.\u0026quot;, \u0026quot;public-key\u0026quot;: \u0026quot;ECKey==\u0026quot;, \u0026quot;auto-provisioning-enabled\u0026quot;: true, \u0026quot;algorithm\u0026quot;: \u0026quot;EC\u0026quot; }] }  Adapter Configuration Format The table below contains the properties which are used to configure a Hono protocol adapter:\n   Name Mandatory JSON Type Default Value Description     type yes string - The type of the adapter which this configuration belongs to.   enabled no boolean false If set to false the tenant is not allowed to receive / send data utilizing the given adapter.   device-authentication-required no boolean true If set to false, devices are not required to authenticate with the adapter before sending / receiving data.    Protocol adapters SHOULD use the configuration properties set for a tenant when interacting with devices of that tenant, e.g. in order to make authorization decisions etc.\nThe JSON object MAY contain an arbitrary number of additional members with arbitrary names of either scalar or complex type. This allows for future well-known additions and also allows to add further information which might be relevant to a custom adapter only.\nResource Limits Configuration Format The table below contains the properties which are used to configure a tenant\u0026rsquo;s resource limits:\n   Name Mandatory JSON Type Default Value Description     max-connections no number -1 The maximum number of concurrent connections allowed from devices of this tenant. The default value -1 indicates that no limit is set.   max-ttl no number -1 The maximum time-to-live (in seconds) to use for events published by devices of this tenant. Any default TTL value specified at either the tenant or device level will be limited to the max value specified here. If this property is set to a value greater than -1 and no default TTL is specified for a device, the max value will be used for events published by the device. A value of -1 (the default) indicates that no limit is set. Note that this property contains the TTL in seconds whereas the AMQP 1.0 specification defines a message\u0026rsquo;s ttl header to use milliseconds.   connection-duration no object - The maximum connection duration allowed for the given tenant. Refer to Connection Duration Configuration Format for details.   data-volume no object - The maximum data volume allowed for the given tenant. Refer to Data Volume Configuration Format for details.    Protocol adapters SHOULD use the max-connections property to determine if a device\u0026rsquo;s connection request should be accepted or rejected.\nProtocol adapters SHOULD use the max-ttl property to determine the effective time-to-live for events published by devices as follows:\n If a non-default max-ttl is set for the tenant, use that value as the effective ttl, otherwise set effective ttl to -1. If the event published by the device  contains a ttl header and effective ttl is not -1 and the ttl value (in seconds) provided by the device is smaller than the effective ttl, use the device provided ttl value as the new effective ttl. does not contain a ttl header but a default ttl value is configured for the device (with the device level taking precedence over the tenant level) and effective ttl is not -1 and the default value is smaller than the effective ttl, use the default ttl value as the new effective ttl.  If effective ttl is not -1, set the downstream event message\u0026rsquo;s ttl header to its value (in milliseconds).  The JSON object MAY contain an arbitrary number of additional members with arbitrary names of either scalar or complex type. This allows for future well-known additions and also allows to add further information which might be relevant to a custom adapter only.\nConnection Duration Configuration Format The table below contains the properties which are used to configure a tenant\u0026rsquo;s connection duration limit:\n   Name Mandatory JSON Type Default Value Description     effective-since yes string - The point in time at which the current settings became effective, i.e. the start of the first accounting period based on these settings. The value MUST be an ISO 8601 compliant combined date and time representation in extended format.   max-minutes no number -1 The maximum connection duration in minutes allowed for the tenant for each accounting period. MUST be an integer. Minus one indicates that no limit is set.   period no object - The mode and length of an accounting period, i.e. the resource usage is calculated based on the defined number of days or on a monthly basis. For more information, please refer to the resource limits period.    Protocol adapters that maintain connection state SHOULD use this information to determine if a connection request from a device should be accepted or not. For more information, please refer to the connection duration limit concept.\nData Volume Configuration Format The table below contains the properties which are used to configure a tenant\u0026rsquo;s data volume limit:\n   Name Mandatory JSON Type Default Value Description     effective-since yes string - The point in time at which the current settings became effective, i.e. the start of the first accounting period based on these settings. The value MUST be an ISO 8601 compliant combined date and time representation in extended format.   max-bytes no number -1 The maximum number of bytes allowed for the tenant for each accounting period. MUST be an integer. A negative value indicates that no limit is set.   period no object - The mode and length of an accounting period, i.e. the data usage can limited based on the defined number of days or on a monthly basis. For more information, please refer to the resource limits period.    Protocol adapters SHOULD use this information to determine if a message originating from or destined to a device should be accepted for processing.\nResource Limits Period Configuration Format The table below contains the properties that are used to configure a tenant\u0026rsquo;s resource limits period:\n   Name Mandatory JSON Type Default Value Description     mode yes string - The mode of the resource usage calculation. The default implementation supports two modes namely days and monthly.   no-of-days no number - When the mode is set as days, then this value represents the length of an accounting period , i.e. the number of days over which the resource usage is to be limited. MUST be a positive integer.    Delivery States used by the Tenant API A Tenant service implementation uses the following AMQP message delivery states when receiving request messages from clients:\n   Delivery State Description     ACCEPTED Indicates that the request message has been received and accepted for processing.   REJECTED Indicates that the request message has been received but cannot be processed. The disposition frame\u0026rsquo;s error field contains information regarding the reason why. Clients should not try to re-send the request using the same message properties and payload in this case.   "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/api/device-connection/",
+	"title": "Device Connection API Specification",
+	"tags": [],
+	"description": "",
+	"content": "The Device Connection API is used by Protocol Adapters to set and retrieve information about the connections from devices or gateways to the protocol adapters.\nThe Device Connection API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using an AMQP 1.0 client in order to invoke operations of the API as described in the following sections.\n\nPreconditions for invoking the Device Connection API  Client has established an AMQP connection with the Device Connection service. Client has established an AMQP link in role sender on the connection using target address device_con/${tenant_id}. This link is used by the client to send commands concerning device connections to Hono. Client has established an AMQP link in role receiver on the connection using source address device_con/${tenant_id}/${reply-to} where reply-to may be any arbitrary string chosen by the client. This link is used by the client to receive responses to the requests it has sent to the Device Connection service. This link\u0026rsquo;s source address is also referred to as the reply-to address for the request messages.    Client connecting to Device Connection service   Set last known Gateway for Device Clients use this command to set the gateway that last acted on behalf of a given device.\nAs this operation is invoked frequently by Hono\u0026rsquo;s components, implementors may choose to keep this information in memory. This API doesn\u0026rsquo;t mandate checks on the validity of the given device or gateway IDs in order not to introduce a dependency on the Device Registration API. However, implementations of this API may choose to perform such checks or impose a restriction on the overall amount of data that can be stored per tenant in order to protect against malicious requests.\nMessage Flow\n  Client sets the last known gateway for a device   Request Message Format\nThe following table provides an overview of the properties a client needs to set on a message to set the last known gateway for a device in addition to the Standard Request Properties.\n   Name Mandatory Location AMQP Type Description     subject yes properties string MUST be set to set-last-gw.   gateway_id yes application-properties string The identifier of the gateway that last acted on behalf of the device identified by the device_id property. If a device connects directly instead of through a gateway, the device\u0026rsquo;s identifier MUST be specified here.    The body of the message SHOULD be empty and will be ignored if it is not.\nResponse Message Format\nA response to a set last known gateway for device request contains the Standard Response Properties.\nThe response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     204 OK, the last known gateway for the device has been updated.   400 Bad Request, the last known gateway has not been updated due to invalid or missing data in the request.    Implementors of this API may return a 404 status code in order to indicate that no device and/or gateway with the given identifier exists for the given tenant. However, performing such a check is optional.\nFor status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred.\nGet last known Gateway for Device Clients use this command to retrieve the gateway that last acted on behalf of a given device.\nMessage Flow\n  Client retrieving the last known gateway for a device   Request Message Format\nThe following table provides an overview of the properties a client needs to set on a message to retrieve the last known gateway for a device in addition to the Standard Request Properties.\n   Name Mandatory Location AMQP Type Description     subject yes properties string MUST be set to get-last-gw.    The body of the message SHOULD be empty and will be ignored if it is not.\nResponse Message Format\nA response to a get last known gateway for device request contains the Standard Response Properties as well as the properties shown in the following table:\n   Name Mandatory Location AMQP Type Description     content-type no properties string MUST be set to application/json if the invocation of the operation was successful and the body of the response message contains payload as described below.    The result of a successful invocation is carried in a single Data section of the response message as a UTF-8 encoded string representation of a single JSON object. It is an error to include payload that is not of this type.\nThe response message JSON object has the following properties:\n   Name Mandatory JSON Type Description     gateway-id yes string The ID of the last known gateway for the device.   last-updated no string The date that the information about the last known gateway for the device was last updated. The value MUST be an ISO 8601 compliant combined date and time representation in extended format.    The response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     200 OK, the payload contains the gateway ID.   400 Bad Request, the request message does not contain all required information/properties.   404 Not Found, there is no last known gateway assigned to the device.    Implementors of this API may return a 404 status code in order to indicate that no device with the given identifier exists for the given tenant. However, performing such a check is optional.\nFor status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred.\nSet command-handling protocol adapter instance for device Clients use this command to set the protocol adapter instance that currently handles command \u0026amp; control messages for a given device.\nThis API doesn\u0026rsquo;t mandate checks on the validity of the given device in order not to introduce a dependency on the Device Registration API. However, implementations of this API may choose to perform such checks or impose a restriction on the overall amount of data that can be stored per tenant in order to protect against malicious requests.\nMessage Flow\n  Client sets the command-handling protocol adapter instance for device   Request Message Format\nThe following table provides an overview of the properties a client needs to set on a message to set the command-handling protocol adapter instance for a device in addition to the Standard Request Properties.\n   Name Mandatory Location AMQP Type Description     subject yes properties string MUST be set to set-cmd-handling-adapter-instance.   adapter_instance_id yes application-properties string The identifier of the protocol adapter instance that currently handles commands for the device or gateway identified by the device_id property.    The body of the message SHOULD be empty and will be ignored if it is not.\nResponse Message Format\nA response to a set command-handling adapter instance for device request contains the Standard Response Properties.\nThe response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     204 OK, the adapter instance for the device has been updated.   400 Bad Request, the command-handling adapter instance has not been updated due to invalid or missing data in the request.    Implementors of this API may return a 404 status code in order to indicate that no device with the given identifier exists for the given tenant. However, performing such a check is optional.\nFor status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred.\nRemove command-handling protocol adapter instance for device Clients use this command to remove the information, which protocol adapter instance is currently handling command \u0026amp; control messages for the given device. The mapping information is only removed, if the currently associated adapter instance matches the one given in the request.\nThis API doesn\u0026rsquo;t mandate checks on the validity of the given device in order not to introduce a dependency on the Device Registration API. However, implementations of this API may choose to perform such checks or impose a restriction on the overall amount of data that can be stored per tenant in order to protect against malicious requests.\nMessage Flow\n  Client removes the command-handling protocol adapter instance information for device   Request Message Format\nThe following table provides an overview of the properties a client needs to set on a message to remove the mapping information regarding the command-handling protocol adapter instance for a device in addition to the Standard Request Properties.\n   Name Mandatory Location AMQP Type Description     subject yes properties string MUST be set to remove-cmd-handling-adapter-instance.   adapter_instance_id yes application-properties string The identifier of the protocol adapter instance to remove the mapping information for. Only if this adapter instance is currently associated with the device or gateway identified by the device_id property, the mapping entry will be removed.    The body of the message SHOULD be empty and will be ignored if it is not.\nResponse Message Format\nA response to a remove command-handling adapter instance for device request contains the Standard Response Properties.\nThe response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     204 OK, the adapter instance mapping information for the device has been removed.   400 Bad Request, the request message does not contain all required properties.   404 Not Found, there is no matching command-handling adapter instance assigned to the device.    Implementors of this API may return a 404 status code in order to indicate that no device with the given identifier exists for the given tenant. However, performing such a check is optional. In case the currently mapped adapter instance doesn\u0026rsquo;t match the given adapter instance id, a 412 status code may also be returned instead of 404.\nFor status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred.\nGet command-handling protocol adapter instances for device Clients use this command to get information about the adapter instances that can handle command \u0026amp; control messages for the given device.\nAs part of the request message, the client is supposed to provide the list of gateways that may act on behalf of the given device. The client may get this list via the Device Registration API\u0026rsquo;s assert Device Registration operation.\nThis API doesn\u0026rsquo;t mandate checks on the validity of the given device and the gateway list in order not to introduce a dependency on the Device Registration API.\nThe command implementation MUST determine the adapter instances by applying the following rules (in the given order):\n If an adapter instance is associated with the given device, this adapter instance is returned as the single returned list entry. Otherwise, if there is an adapter instance registered for the last known gateway associated with the given device, this adapter instance is returned as the single returned list entry. The last known gateway has to be contained in the given list of gateways for this case. Otherwise, all adapter instances associated with any of the given gateway identifiers are returned.  That means that for a device communicating via a gateway, the result is reduced to a single element list if an adapter instance for the device itself or its last known gateway is found. The adapter instance registered for the device itself is given precedence in order to ensure that a gateway having subscribed to commands for that particular device is chosen over a gateway that has subscribed to commands for all devices of a tenant.\nMessage Flow\n  Client retrieving the list of command-handling adapter instances for a device   Request Message Format\nThe following table provides an overview of the properties a client needs to set on a message to retrieve the command-handling adapter instances for a device in addition to the Standard Request Properties.\n   Name Mandatory Location AMQP Type Description     content-type yes properties string MUST be set to application/json.   subject yes properties string MUST be set to get-cmd-handling-adapter-instances.    The body of the message MUST consist of a single AMQP Data section containing a UTF-8 encoded string representation of a single JSON object. The JSON object has the following properties:\n   Name Mandatory JSON Type Description     gateway-ids yes array The IDs of the gateways that may act on behalf of the given device. This list may be obtained via the Device Registration API\u0026rsquo;s assert Device Registration operation.    Example of a request payload:\n{ \u0026quot;gateway-ids\u0026quot;: [\u0026quot;gw-1\u0026quot;, \u0026quot;gw-2\u0026quot;, \u0026quot;gw-3\u0026quot;] }  Response Message Format\nA response to a get command-handling adapter instances for device request contains the Standard Response Properties as well as the properties shown in the following table:\n   Name Mandatory Location AMQP Type Description     content-type no properties string MUST be set to application/json if the invocation of the operation was successful and the body of the response message contains payload as described below.    The result of a successful invocation is carried in a single Data section of the response message as a UTF-8 encoded string representation of a single JSON object. It is an error to include payload that is not of this type.\nThe response message JSON object has the following properties:\n   Name Mandatory JSON Type Description     adapter-instances yes array A non-empty array of JSON objects that represent the command-handling adapter instances along with the device or gateway id.    Each entry in the adapter-instances array has the following properties:\n   Name Mandatory JSON Type Description     adapter-instance-id yes string The ID of the protocol adapter instance handling command \u0026amp; control messages for the device given in the device-id property.   device-id yes string The ID of the gateway or device that the protocol adapter instance given by the adapter-instance-id is handling command \u0026amp; control messages for. This ID is not necessarily the device_id given in the request message, it may be the ID of one of the gateways acting on behalf of the device.    An example of a response message with a single adapter instance result, returned for example if an adapter instance is registered for the given device:\n{ \u0026quot;adapter-instances\u0026quot;: [ { \u0026quot;adapter-instance-id\u0026quot;: \u0026quot;adapter-1\u0026quot;, \u0026quot;device-id\u0026quot;: \u0026quot;4711\u0026quot; } ] }  An example of a response message with multiple contained adapter instances, returned for example if no adapter instance is registered for the given device or its last used gateway, and therefore a list of all adapter instances for the gateways of the device is returned:\n{ \u0026quot;adapter-instances\u0026quot;: [ { \u0026quot;adapter-instance-id\u0026quot;: \u0026quot;adapter-1\u0026quot;, \u0026quot;device-id\u0026quot;: \u0026quot;gw-1\u0026quot; }, { \u0026quot;adapter-instance-id\u0026quot;: \u0026quot;adapter-1\u0026quot;, \u0026quot;device-id\u0026quot;: \u0026quot;gw-2\u0026quot; } ] }  The response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     200 OK, the payload contains the adapter instances.   400 Bad Request, the request message does not contain all required information/properties.   404 Not Found, there is no command-handling adapter instance assigned to the device.    Implementors of this API may also return a 404 status code in order to indicate that no device with the given identifier exists for the given tenant. However, performing such a check is optional.\nFor status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred.\nStandard Message Properties Due to the nature of the request/response message pattern of the operations of the Device Connection API, there are some standard properties shared by all of the request and response messages exchanged as part of the operations.\nStandard Request Properties The following table provides an overview of the properties shared by all request messages regardless of the particular operation being invoked.\n   Name Mandatory Location AMQP Type Description     subject yes properties string MUST be set to the value defined by the particular operation being invoked.   correlation-id no properties message-id MAY contain an ID used to correlate a response message to the original request. If set, it is used as the correlation-id property in the response, otherwise the value of the message-id property is used. Either this or the message-id property MUST be set.   message-id no properties string MAY contain an identifier that uniquely identifies the message at the sender side. Either this or the correlation-id property MUST be set.   reply-to yes properties string MUST contain the source address that the client wants to received response messages from. This address MUST be the same as the source address used for establishing the client\u0026rsquo;s receive link (see Preconditions).   device_id yes application-properties string MUST contain the ID of the device that is subject to the operation.    Standard Response Properties The following table provides an overview of the properties shared by all response messages regardless of the particular operation being invoked.\n   Name Mandatory Location AMQP Type Description     correlation-id yes properties message-id Contains the message-id (or the correlation-id, if specified) of the request message that this message is the response to.   status yes application-properties int Contains the status code indicating the outcome of the operation. Concrete values and their semantics are defined for each particular operation.   cache_control no application-properties string Contains an RFC 2616 compliant cache directive. The directive contained in the property MUST be obeyed by clients that are caching responses.    Delivery States Hono uses the following AMQP message delivery states when receiving request messages from clients:\n   Delivery State Description     ACCEPTED Indicates that the request message has been received and accepted for processing.   REJECTED Indicates that Hono has received the request but was not able to process it. The error field contains information regarding the reason why. Clients should not try to re-send the request using the same message properties in this case.   "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/api/device-registration/",
+	"title": "Device Registration API Specification",
+	"tags": [],
+	"description": "",
+	"content": "The Device Registration API is used by Hono\u0026rsquo;s protocol adapters to get information about devices connecting to the adapters.\nThe Device Registration API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using an AMQP 1.0 client in order to invoke operations of the API as described in the following sections.\n\nPreconditions for invoking the Device Registration API  Client has established an AMQP connection with the Device Registration service. Client has established an AMQP link in role sender on the connection using target address registration/${tenant_id}. This link is used by the client to send request messages to the Device Registration service. Client has established an AMQP link in role receiver on the connection using source address registration/${tenant_id}/${reply-to} where reply-to may be any arbitrary string chosen by the client. This link is used by the client to receive responses to the requests it has sent to the Device Registration service. This link\u0026rsquo;s source address is also referred to as the reply-to address for the request messages.    Client connecting to Device Registration service   Assert Device Registration Clients use this command to verify that a device is registered for a particular tenant and is enabled.\nMessage Flow\nThe following sequence diagram illustrates the flow of messages involved in a Client asserting a device\u0026rsquo;s registration status.\n  Client asserting a device\u0026#39;s registration status   Request Message Format\nThe following table provides an overview of the properties a client needs to set on a message to assert a device\u0026rsquo;s registration status:\n   Name Mandatory Location AMQP Type Description     correlation-id no properties message-id MAY contain an ID used to correlate a response message to the original request. If set, it is used as the correlation-id property in the response, otherwise the value of the message-id property is used. Either this or the message-id property MUST be set.   device_id yes application-properties string MUST contain the ID of the device that is subject to the operation.   gateway_id no application-properties string The identifier of the gateway that wants to get an assertion on behalf of another device (given in the device_id property).\nAn implementation SHOULD verify that the gateway exists, is enabled and is authorized to get an assertion for, and thus send data on behalf of, the device.   message-id no properties string MAY contain an identifier that uniquely identifies the message at the sender side. Either this or the correlation-id property MUST be set.   reply-to yes properties string MUST contain the source address that the client wants to received response messages from. This address MUST be the same as the source address used for establishing the client\u0026rsquo;s receive link (see Preconditions).   subject yes properties string MUST be set to assert.    The body of the message SHOULD be empty and will be ignored if it is not.\nResponse Message Format\nThe following table provides an overview of the properties contained in a response message to an assert request:\n   Name Mandatory Location AMQP Type Description     correlation-id yes properties message-id Contains the message-id (or the correlation-id, if specified) of the request message that this message is the response to.   content-type no properties string MUST be set to application/json if the invocation of the operation was successful and the body of the response message contains payload as described below.   status yes application-properties int Contains the status code indicating the outcome of the operation. Concrete values and their semantics are defined below.   cache_control no application-properties string Contains an RFC 2616 compliant cache directive. The directive contained in the property MUST be obeyed by clients that are caching responses.    In case of a successful invocation of the operation, the body of the response message consists of a single Data section containing a UTF-8 encoded string representation of a single JSON object having the following properties:\n   Name Mandatory JSON Type Description     device-id yes string The ID of the device that is subject of the assertion.   via no array The IDs (JSON strings) of gateways which may act on behalf of the device. This property MUST be set if any gateways are registered for the device. If the assertion request contained a gateway_id property and the response\u0026rsquo;s status property has value 200 (indicating a successful assertion) then the array MUST at least contain the gateway ID from the request.   defaults no object Default values to be used by protocol adapters for augmenting messages from devices with missing information like a content type. It is up to the discretion of a protocol adapter if and how to use the given default values when processing messages published by the device.    Below is an example for a payload of a response to an assert request for device 4711 which also includes a default content-type:\n{ \u0026quot;device-id\u0026quot;: \u0026quot;4711\u0026quot;, \u0026quot;via\u0026quot;: [\u0026quot;4712\u0026quot;], \u0026quot;defaults\u0026quot;: { \u0026quot;content-type\u0026quot;: \u0026quot;application/vnd.acme+json\u0026quot; } }  The response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     200 OK, the device is registered for the given tenant and is enabled. The response message body contains the asserted device\u0026rsquo;s registration status.   400 Bad Request, the request message did not contain all mandatory properties.   403 Forbidden, the gateway with the given gateway id either does not exist, is not enabled or is not authorized to get an assertion for the device with the given device id.   404 Not Found, there is no device registered with the given device id within the given tenant id or the device is not enabled.    For status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred. In this case, the response message\u0026rsquo;s content-type property SHOULD be set accordingly.\nDelivery States The Device Registration service uses the following AMQP message delivery states when receiving request messages from clients:\n   Delivery State Description     ACCEPTED Indicates that the request message has been received and accepted for processing.   REJECTED Indicates that the request message has been received but cannot be processed. The disposition frame\u0026rsquo;s error field contains information regarding the reason why. Clients should not try to re-send the request using the same message properties in this case.   "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/api/credentials/",
+	"title": "Credentials API Specification",
+	"tags": [],
+	"description": "",
+	"content": "The Credentials API is used by Protocol Adapters to retrieve credentials used to authenticate Devices connecting to the adapter. In particular, the API supports to look up shared secrets which are often used by IoT devices by means of username/password based authentication schemes.\nCredentials are of a certain type which indicates which authentication mechanism the credentials can be used with. Each set of credentials also contains an authentication identity which is the identity claimed by the device during authentication. This authentication identity is usually different from the device-id the device has been registered under. A device may have multiple sets of credentials, using arbitrary authentication identities.\nThe Credentials API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using an AMQP 1.0 client in order to invoke operations of the API as described in the following sections.\n\nPreconditions for invoking the Credentials API  Client has established an AMQP connection with the Credentials service. Client has established an AMQP link in role sender on the connection using target address credentials/${tenant_id}. This link is used by the client to send commands to the Credentials service. Client has established an AMQP link in role receiver on the connection using source address credentials/${tenant_id}/${reply-to} where reply-to may be any arbitrary string chosen by the client. This link is used by the client to receive responses to the requests it has sent to the Credentials service. This link\u0026rsquo;s source address is also referred to as the reply-to address for the request messages.    Client connecting to Credentials service   Get Credentials Protocol adapters use this command to look up credentials of a particular type for a device identity.\nMessage Flow\n  Client looking up credentials for a device   Request Message Format\nThe following table provides an overview of the properties a client needs to set on an get credentials message.\n   Name Mandatory Location AMQP Type Description     correlation-id no properties message-id MAY contain an ID used to correlate a response message to the original request. If set, it is used as the correlation-id property in the response, otherwise the value of the message-id property is used. Either this or the message-id property MUST be set.   message-id no properties string MAY contain an identifier that uniquely identifies the message at the sender side. Either this or the correlation-id property MUST be set.   reply-to yes properties string MUST contain the source address that the client wants to receive response messages from. This address MUST be the same as the source address used for establishing the client\u0026rsquo;s receive link (see Preconditions).   subject yes properties string MUST contain the value get.    The body of the request MUST consist of a single Data section containing a UTF-8 encoded string representation of a single JSON object having the following members:\n   Name Mandatory JSON Type Description     type yes string The type of credentials to look up. Potential values include (but are not limited to) psk, x509-cert, hashed-password etc.   auth-id yes string The authentication identifier to look up credentials for.   client-certificate no string The client certificate the device authenticated with. If present, it MUST be the DER encoding of the (validated) X.509 client certificate as a Base64 encoded byte array and it\u0026rsquo;s subject DN MUST match the auth-id.    The client-certificate property MAY be used by the service implementation for auto-provisioning of devices. To do so, the device registry needs to create credentials (and registration data) for the device if they do not already exist.\nAdditionally, the body MAY contain arbitrary properties that service implementations can use to determine a device\u0026rsquo;s identity.\nThe following request payload may be used to look up the hashed password for a device with the authentication identifier sensor1:\n{ \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor1\u0026quot; }  The following request payload may be used to look up or create x509-cert credentials for a device with the authentication identifier CN=device-1,O=ACME Corporation:\n{ \u0026quot;type\u0026quot;: \u0026quot;x509-cert\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;CN=device-1,O=ACME Corporation\u0026quot;, \u0026quot;client-certificate\u0026quot;: \u0026quot;DeviceCert==\u0026quot; }  Response Message Format\nA response to a get credentials request contains the following properties:\n   Name Mandatory Location AMQP Type Description     correlation-id yes properties message-id Contains the message-id (or the correlation-id, if specified) of the request message that this message is the response to.   content-type no properties string MUST be set to application/json if the invocation of the operation was successful and the body of the response message contains payload as described below.   status yes application-properties int Contains the status code indicating the outcome of the operation. Concrete values and their semantics are defined below.   cache_control no application-properties string Contains an RFC 2616 compliant cache directive. The directive contained in the property MUST be obeyed by clients that are caching responses.    The response message payload MUST contain credential information as defined in Credentials Format if the status is 200 or 201.\nThe response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     200 OK, the payload contains the credentials for the authentication identifier.   201 Created, the payload contains the newly created credentials for the authentication identifier.   400 Bad Request, the request message did not contain all mandatory properties or the subject DN of the certificate does not match the authentication identifier.   404 Not Found, there are no credentials registered matching the criteria.    For status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred. In this case, the response message\u0026rsquo;s content-type property SHOULD be set accordingly.\nDelivery States The Credentials service uses the following AMQP message delivery states when receiving request messages from clients:\n   Delivery State Description     ACCEPTED Indicates that the request message has been received and accepted for processing.   REJECTED Indicates that the request message has been received but cannot be processed. The disposition frame\u0026rsquo;s error field contains information regarding the reason why. Clients should not try to re-send the request using the same message properties in this case.    Credentials Format Credential data is carried in the body of an AMQP message as part of a single Data section. The message\u0026rsquo;s content-type property must be set to application/json.\nThe credential data is contained in the Data section as a UTF-8 encoded string representation of a single JSON object. It is an error to include payload that is not of this type.\nThe table below provides an overview of the standard members defined for the JSON object:\n   Name Mandatory JSON Type Default Value Description     device-id yes string  The ID of the device to which the credentials belong.   type yes string  The credential type name. The value may be arbitrarily chosen by clients but SHOULD reflect the particular type of authentication mechanism the credentials are to be used with. Possible values include (but are not limited to) psk, x509-cert, hashed-password etc.   auth-id yes string  The identity that the device should be authenticated as.   enabled no boolean true If set to false the credentials are not supposed to be used to authenticate devices any longer. This may e.g. be used to disable a particular mechanism for authenticating the device. NB It is the responsibility of the protocol adapter to make use of this information.   secrets yes array  A list of secrets scoped to a particular time period. See Secrets Format for details. NB This array must contain at least one element - an empty array is considered an error.    For each set of credentials the combination of auth-id and type MUST be unique within a tenant.\nThe device registry may choose to not return information which is not suitable for authentication a device. This includes for example the enabled property. If set to false, then the device registry may choose to treat this request as if no credentials would be found. For secrets for example, this could mean that the device registry does not return secrets which are not valid at the current point in time.\nNB Care needs to be taken that the value for the authentication identifier is compliant with the authentication mechanism(s) it is supposed to be used with. For example, when using standard HTTP Basic authentication, the username part of the Basic Authorization header value (which corresponds to the auth-id) MUST not contain any colon (:) characters, because the colon character is used as the separator between username and password. Similar constraints may exist for other authentication mechanisms, so the authentication identifier needs to be chosen with the anticipated mechanism(s) being used in mind. Otherwise, devices may fail to authenticate with protocol adapters, even if the credentials provided by the device match the credentials registered for the device. In general, using only characters from the [a-zA-Z0-9_-] range for the authentication identifier should be compatible with most mechanisms.\nSecrets Format Each set of credentials may contain arbitrary secrets scoped to a particular validity period during which the secrets may be used for authenticating a device. The validity periods MAY overlap in order to support the process of changing a secret on a device that itself doesn\u0026rsquo;t support the definition of multiple secrets for gapless authentication across adjacent validity periods.\nThe table below contains the properties used to define the validity period of a single secret:\n   Name Mandatory JSON Type Default Value Description     not-before no string null The point in time from which on the secret may be used to authenticate devices. If not null, the value MUST be an ISO 8601 compliant combined date and time representation in extended format. NB It is up to the discretion of the protocol adapter to make use of this information.   not-after no string null The point in time until which the secret may be used to authenticate devices. If not null, the value MUST be an ISO 8601 compliant combined date and time representation in extended format. NB It is up to the discretion of the protocol adapter to make use of this information.    Examples Below is an example for a payload containing a hashed password for device 4711 with auth-id sensor1 using SHA512 as the hashing function with a 4 byte salt (Base64 encoding of 0x32AEF017). Note that the payload does not contain a not-before property, thus it may be used immediately up until X-mas eve 2017.\n{ \u0026quot;device-id\u0026quot;: \u0026quot;4711\u0026quot;, \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor1\u0026quot;, \u0026quot;enabled\u0026quot;: true, \u0026quot;secrets\u0026quot;: [{ \u0026quot;not-after\u0026quot;: \u0026quot;2017-12-24T19:00:00+0100\u0026quot;, \u0026quot;pwd-hash\u0026quot;: \u0026quot;AQIDBAUGBwg=\u0026quot;, \u0026quot;salt\u0026quot;: \u0026quot;Mq7wFw==\u0026quot;, \u0026quot;hash-function\u0026quot;: \u0026quot;sha-512\u0026quot; }] }  The next example contains two pre-shared keys with overlapping validity periods for device myDevice with PSK identity little-sensor2.\n{ \u0026quot;device-id\u0026quot;: \u0026quot;myDevice\u0026quot;, \u0026quot;type\u0026quot;: \u0026quot;psk\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;little-sensor2\u0026quot;, \u0026quot;enabled\u0026quot;: true, \u0026quot;secrets\u0026quot;: [{ \u0026quot;not-after\u0026quot;: \u0026quot;2017-07-01T00:00:00+0100\u0026quot;, \u0026quot;key\u0026quot;: \u0026quot;cGFzc3dvcmRfb2xk\u0026quot; },{ \u0026quot;not-before\u0026quot;: \u0026quot;2017-06-29T00:00:00+0100\u0026quot;, \u0026quot;key\u0026quot;: \u0026quot;cGFzc3dvcmRfbmV3\u0026quot; }] }  Credential Verification Protocol Adapters are responsible for authenticating devices when they connect. The Credentials API provides the Get Credentials operation to support Protocol Adapters in doing so as illustrated below:\nThe following sequence diagram illustrates the flow of messages involved in a Protocol Adapter authenticating a device. This is shown for the MQTT Protocol Adapter as example how a device authenticates with a username and a hashed-password. The mechanism can be transferred to other protocols in a similar manner.\n  MQTT Adapter authenticates device using the Credentials service   Protocol adapters MUST comply with the following rules when verifying credentials presented by a device:\n Credentials that have their enabled property set to false MUST NOT be used for authentication. Adapters MUST only consider secrets for authentication which\n have their not-before property set to either null or the current or a past point in time and have their not-after property set to either null or the current or a future point in time.   Standard Credential Types The following sections define some standard credential types and their properties. Applications are encouraged to make use of these types. However, the types are not enforced anywhere in Hono and clients may of course add application specific properties to the credential types.\nCommon Properties All credential types used with Hono MUST contain device-id, type, auth-id, enabled and secrets properties as defined in Credentials Format.\nHashed Password A credential type for storing a (hashed) password for a device.\nExample:\n{ \u0026quot;device-id\u0026quot;: \u0026quot;4711\u0026quot;, \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor1\u0026quot;, \u0026quot;secrets\u0026quot;: [{ \u0026quot;pwd-hash\u0026quot;: \u0026quot;AQIDBAUGBwg=\u0026quot;, \u0026quot;salt\u0026quot;: \u0026quot;Mq7wFw==\u0026quot;, \u0026quot;hash-function\u0026quot;: \u0026quot;sha-512\u0026quot; }] }     Name Mandatory JSON Type Default Description     type yes string  The credential type name, always hashed-password.   auth-id yes string  The identity that the device should be authenticated as.   pwd-hash yes string  The password hash (see table below for details).   salt no string  The Base64 encoding of the salt used in the password hash (see table below for details).   hash-function no string sha-256 The name of the hash function used to create the password hash. The hash functions supported by Hono are described in the table below.    NB It is strongly recommended to use salted password hashes only. Furthermore, the salt should be unique per user and password, so no lookup table or rainbow table attacks can be used to crack the salt-hashed password. Whenever a password is updated for a user, the salt should change as well.\nNB The example above does not contain any of the not-before, not-after and enabled properties, thus the credentials can be used at any time according to the rules defined in Credential Verification.\nThe table below describes the hash functions supported by Hono and how they map to the secret structure.\n   Name Salt Usage Salt Location Password Hash Format     sha-256 optional salt field The Base64 encoding of the bytes resulting from applying the sha-256 hash function to the byte array consisting of the salt bytes (if a salt is used) and the UTF-8 encoding of the clear text password.   sha-512 optional salt field The Base64 encoding of the bytes resulting from applying the sha-512 hash function to the byte array consisting of the salt bytes (if a salt is used) and the UTF-8 encoding of the clear text password.   bcrypt mandatory pwd-hash value The output of applying the Bcrypt hash function to the clear text password. The salt is contained in the password hash.\nNB Hono (currently) uses Spring Security for matching clear text passwords against Bcrypt hashes. However, this library only supports hashes containing the $2a$ prefix (see https://github.com/fpirsch/twin-bcrypt#about-prefixes) so Hono will fail to verify any passwords for which the corresponding Bcrypt hashes returned by the Credentials service contain e.g. the $2y$ prefix.    Pre-Shared Key A credential type for storing a Pre-shared Key as used in TLS handshakes.\nExample:\n{ \u0026quot;device-id\u0026quot;: \u0026quot;4711\u0026quot;, \u0026quot;type\u0026quot;: \u0026quot;psk\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;little-sensor2\u0026quot;, \u0026quot;secrets\u0026quot;: [{ \u0026quot;key\u0026quot;: \u0026quot;AQIDBAUGBwg=\u0026quot; }] }     Name Mandatory JSON Type Description     type yes string The credential type name, always psk.   auth-id yes string The PSK identity.   key yes string The Base64 encoded bytes representing the shared (secret) key.    NB The example above does not contain any of the not-before, not-after and enabled properties, thus the credentials can be used at any time according to the rules defined in Credential Verification.\nX.509 Certificate A credential type for storing the RFC 2253 formatted subject DN of a client certificate that is used to authenticate the device as part of a TLS handshake.\nExample:\n{ \u0026quot;device-id\u0026quot;: \u0026quot;4711\u0026quot;, \u0026quot;type\u0026quot;: \u0026quot;x509-cert\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;CN=device-1,O=ACME Corporation\u0026quot;, \u0026quot;secrets\u0026quot;: [{}] }     Name Mandatory JSON Type Description     type yes string The credential type name, always x509-cert.   auth-id yes string The subject DN of the client certificate in the format defined by RFC 2253.    NB The example above does not contain any of the not-before, not-after and enabled properties. The not-before and not-after properties should be omitted if the validity period is the same as the period indicated by the client certificate\u0026rsquo;s corresponding properties. It is still necessary to provide a (empty) JSON object in the secrets array, though.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/api/authentication/",
+	"title": "Authentication API Specification",
+	"tags": [],
+	"description": "",
+	"content": "The Authentication API is used to retrieve a token asserting a subject\u0026rsquo;s identity and granted authorities. Other service implementations use such a token to make authorization decisions on a client\u0026rsquo;s request to read or write from/to a resource or to invoke a certain operation.\nThe Authentication API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to an Authentication service using an AMQP 1.0 client in order to invoke operations of the API as described in the following sections.\nNote that a component implementing this API will most likely need to also provide means to add, alter or remove identities and authorities as well. However, Hono itself does not require this kind of functionality, thus this kind of functionality is considered out of scope of this API.\nIn a real world environment there will often already be an identity management system in place. In such cases it can make sense to just implement a facade exposing the Authentication API operations and mapping them to the underlying existing system\u0026rsquo;s functionality.\nGet Token Clients use this operation to\n verify a set of credentials and retrieve a token asserting the authenticated subject\u0026rsquo;s identity and granted authorities.  Message Flow\nThe following sequence diagram illustrates the flow of messages involved in a Client retrieving a token.\n  Get Token message flow    The Client and Authentication service have agreed to use the SASL PLAIN mechanism for authenticating the client. The Client therefore sends the credentials of the identity it wants to retrieve a token for. The Authentication service successfully verifies the credentials and establishes the authorization ID.  The Authentication service completes the SASL exchange with a successful outcome (SASL OK).  The Client continues by opening an AMQP connection with the Authentication service. The Authentication service creates a token asserting the authorization ID and authorities established during the SASL exchange and associates it with the connection. The Client opens a receiving link using source address cbs.  The Authentication service opens the link and sends the token associated with the connection to the Client.  The Client closes the connection.  Token Message Format\nOn successful establishment of the receiving link with the client as described above, the server sends a message to the client containing a token asserting the identity and authorities of the client that has been authenticated as part of establishing the underlying AMQP connection.\nThe following table provides an overview of the properties of the message sent to the client.\n   Name Location Type Value     type application-properties string amqp:jwt    The message\u0026rsquo;s body consists of a single AMQP 1.0 AmqpValue section which contains the UTF-8 representation of a JSON Web Token as defined in Token Format.\nToken Format The token returned by the get Token operation is a cryptographically signed JSON Web Token as defined by RFC 7519.\nThe token contains the following mandatory claims:\n   Name Type Value     sub RFC 7519, Section 4.1.2 The authorization ID of the authenticated client. This represents the asserted identity.   exp RFC 7519, Section 4.1.4 The point in time after which the claims contained in this token must be considered no longer valid. Clients MUST NOT use any information from a token that has expired.    The subject\u0026rsquo;s authorities on resources and operations are represented by additional JWT claims with a name identifying the resource or operation and a value containing the activities the subject is allowed to perform. The following activities are supported:\n READ - The client is allowed to establish a receiving link using the resource\u0026rsquo;s node address as the link\u0026rsquo;s source address. WRITE - The client is allowed to establish a sending link using the resource\u0026rsquo;s node address as the link\u0026rsquo;s target address. EXECUTE - The client is allowed to invoke an operation on an endpoint, i.e. send a message over a link with a subject representing the operation name and the link\u0026rsquo;s target address representing the API endpoint\u0026rsquo;s node address.  The allowed activities are encoded in a claim\u0026rsquo;s value by means of simply concatenating the activities\u0026rsquo; initial characters (R, W, E).\nThe token may contain any number of additional claims which may be ignored by clients that do not understand their meaning.\nResource Authorities A client\u0026rsquo;s authority on a resource is represented by a JWT claim with a name containing the resource node address prefixed with r: and a value containing the activities the client is allowed to perform on the resource. The node address MAY contain one or more wildcard (*) characters to represent any string.\nExample:\nAssuming a client which is allowed to\n send and consume events for tenant my-tenant and consume telemetry data for all tenants  the corresponding claims (in the token\u0026rsquo;s JSON representation) would look like this:\n{ ... \u0026quot;r:event/my-tenant\u0026quot;: \u0026quot;RW\u0026quot;, \u0026quot;r:telemetry/*\u0026quot;: \u0026quot;R\u0026quot;, ... }  Operation Authorities A client\u0026rsquo;s authority to invoke an endpoint\u0026rsquo;s operation(s) is represented by a JWT claim with a name containing the endpoint\u0026rsquo;s node address and operation identifier prefixed with o: and a value of E (for EXECUTE). The endpoint node address MAY contain one or more wildcard (*) characters to represent any string. The operation identifier is the subject value defined by the corresponding API for the operation. The operation identifier MAY be set to * to represent any operation of the endpoint.\nExample:\nAssuming a client which is allowed to\n invoke the Device Registration API\u0026rsquo;s assert Registration operation for any tenant and invoke all methods of the Credentials API for tenant my-tenant  the corresponding claims (in the token\u0026rsquo;s JSON representation) would look like this:\n{ ... \u0026quot;o:registration/*:assert\u0026quot;: \u0026quot;E\u0026quot;, \u0026quot;o:credentials/my-tenant:*\u0026quot;: \u0026quot;E\u0026quot;, ... } "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/api/management/",
+	"title": "Device Registry Management API Specification",
+	"tags": [],
+	"description": "",
+	"content": "  window.onload = function() { const ui = SwaggerUIBundle({ url: \"device-registry-v1.yaml\", dom_id: '#swagger-ui', deepLinking: true, presets: [ SwaggerUIBundle.presets.apis, SwaggerUIStandalonePreset ], plugins: [ SwaggerUIBundle.plugins.DownloadUrl ], layout: \"StandaloneLayout\", docExpansion: \"none\", defaultModelRendering: \"model\", defaultModelExpandDepth: 0, defaultModelsExpandDepth: -1, validatorUrl: null }) window.ui = ui }  "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/api/metrics/",
+	"title": "Metrics",
+	"tags": [],
+	"description": "",
+	"content": "Eclipse Hono\u0026trade;\u0026rsquo;s components report several metrics which may be used to gain some insight into the running system. For instance, the HTTP adapter reports the number of successfully processed telemetry messages. Some of these metrics are considered part of Hono\u0026rsquo;s external interface. This section describes the semantics and format of the metrics, how they can be retrieved and how to interpret actual values.\nReported Metrics Hono uses Micrometer in combination with Spring Boot to internally collect metrics. Those metrics can be exported to different back ends. Please refer to Configuring Metrics for details.\nThe example deployment by default uses Prometheus as the metrics back end.\nWhen deploying to Kubernetes/OpenShift, the metrics reported by Hono may contain environment specific tags (like the pod name) which are added by the Prometheus scraper. However, those tags are not part of the Hono metrics definition.\nHono applications may report other metrics in addition to the ones defined here. In particular, all components report metrics regarding the JVM\u0026rsquo;s internal state, e.g. memory consumption and garbage collection status. Those metrics are not considered part of Hono\u0026rsquo;s official metrics definition. However, all those metrics will still contain tags as described below.\nCommon Metrics Tags for common metrics are:\n   Tag Value Description     host string The name of the host that the component reporting the metric is running on   component-type adapter, service The type of component reporting the metric   component-name string The name of the component reporting the metric.    The names of Hono\u0026rsquo;s standard components are as follows:\n   Component component-name     Auth Server hono-auth   Device Registry hono-registry   AMQP adapter hono-amqp   CoAP adapter hono-coap   HTTP adapter hono-http   Kura adapter hono-kura-mqtt   MQTT adapter hono-mqtt   Lora adapter hono-lora   Sigfox adapter hono-sigfox    Protocol Adapter Metrics Additional tags for protocol adapters are:\n   Name Value Description     direction one-way, request, response The direction in which a Command \u0026amp; Control message is being sent:\none-way indicates a command sent to a device for which the sending application doesn\u0026rsquo;t expect to receive a response.\nrequest indicates a command request message sent to a device.\nresponse indicates a command response received from a device.   qos 0, 1, unknown The quality of service used for a telemetry or event message.\n0 indicates at most once,\n1 indicates at least once and\nnone indicates unknown delivery semantics.   status forwarded, unprocessable, undeliverable The processing status of a message.\nforwarded indicates that the message has been forwarded to a downstream consumer\nunprocessable indicates that the message has not been processed not forwarded, e.g. because the message was malformed\nundeliverable indicates that the message could not be forwarded, e.g. because there is no downstream consumer or due to an infrastructure problem   tenant string The identifier of the tenant that the metric is being reported for   ttd command, expired, none A status indicating the outcome of processing a TTD value contained in a message received from a device.\ncommand indicates that a command for the device has been included in the response to the device\u0026rsquo;s request for uploading the message.\nexpired indicates that a response without a command has been sent to the device.\nnone indicates that either no TTD value has been specified by the device or that the protocol adapter does not support it.   type telemetry, event The type of (downstream) message that the metric is being reported for.    Metrics provided by the protocol adapters are:\n   Metric Type Tags Description     hono.commands.received Timer host, component-type, component-name, tenant, type, status, direction The time it took to process a message conveying a command or a response to a command.   hono.commands.payload DistributionSummary host, component-type, component-name, tenant, type, status, direction The number of bytes conveyed in the payload of a command message.   hono.connections.authenticated Gauge host, component-type, component-name, tenant Current number of connected, authenticated devices.  NB This metric is only supported by protocol adapters that maintain connection state with authenticated devices. In particular, the HTTP adapter does not support this metric.   hono.connections.unauthenticated Gauge host, component-type, component-name Current number of connected, unauthenticated devices.  NB This metric is only supported by protocol adapters that maintain connection state with authenticated devices. In particular, the HTTP adapter does not support this metric.   hono.connections.authenticated.duration Timer host, component-type, component-name, tenant The overall amount of time that authenticated devices have been connected to protocol adapters.  NB This metric is only supported by protocol adapters that maintain connection state with authenticated devices. In particular, the HTTP adapter does not support this metric.   hono.messages.received Timer host, component-type, component-name, tenant, type, status, qos, ttd The time it took to process a message conveying telemetry data or an event.   hono.messages.payload DistributionSummary host, component-type, component-name, tenant, type, status The number of bytes conveyed in the payload of a telemetry or event message.    Minimum Message Size If a minimum message size is configured for a tenant, then the payload size of the telemetry, event and command messages are calculated in accordance with the configured value and then reported to the metrics by the AMQP, HTTP and MQTT protocol adapters. If minimum message size is not configured for a tenant then the actual message payload size is reported.\nAssume that the minimum message size for a tenant is configured as 4096 bytes (4KB). The payload size of an incoming message with size 1KB is calculated as 4KB by the protocol adapters and reported to the metrics system. For an incoming message of size 10KB, it is reported as 12KB.\nService Metrics Hono\u0026rsquo;s service components do not report any metrics at the moment.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/deployment/",
+	"title": "Deployment",
+	"tags": [],
+	"description": "",
+	"content": " Deployment Learn how to deploy Eclipse Hono\u0026trade; to various container orchestration platforms.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/deployment/helm-based-deployment/",
+	"title": "Helm based Deployment",
+	"tags": [],
+	"description": "",
+	"content": "Eclipse Hono\u0026trade;\u0026rsquo;s components are provided as container images which can be run on arbitrary container orchestration platforms. This page describes the steps necessary to deploy Hono to a Kubernetes cluster using the Helm package manager.\nInstalling Hono Hono\u0026rsquo;s Helm chart is available from the Eclipse IoT Packages chart repository. Please refer to the chart\u0026rsquo;s README for instructions regarding installation and configuration.\nDeploying custom Container Images The chart by default installs Hono\u0026rsquo;s pre-built container images. In some cases it might be desirable to build Hono from source, e.g. in order to use a different metrics back end or to use Jaeger tracing.\nThe container images created as part of the build process need to be made available to the Kubernetes cluster that Hono should be installed to. This usually requires the images to be pushed to a (private) container registry that the cluster can pull them from. Please refer to the documentation of the employed Kubernetes service provider for details regarding the setup and configuration of a private container registry.\nDeploying via a private Registry The first step is getting the source code of Hono. Please refer to Building from Source for details. Once the source code has been retrieved, the build process can be started using the following command:\n# in base directory of Hono working tree: mvn clean install -Pbuild-docker-image,metrics-prometheus  After the build process has finished, the custom container images need to be pushed to the registry so that the Kubernetes cluster can pull them from there during deployment. Assuming that the images should be tagged with 1.0.3-CUSTOM and the container registry name is my.registry.io, the following command can be used to tag the locally built images and push them to the registry:\n# in base directory of Hono working tree: ./push_hono_images.sh 1.0.3-CUSTOM my.registry.io   Note You may need to log in to the (private) container registry before pushing the images.  The image names that Hono should use for starting up containers can be configured in a YAML file:\ndeviceRegistryExample: imageName: \u0026quot;my.registry.io/eclipse/hono-service-device-registry-file:1.0.3-CUSTOM\u0026quot; authServer: imageName: \u0026quot;my.registry.io/eclipse/hono-service-auth:1.0.3-CUSTOM\u0026quot; deviceConnectionService: imageName: \u0026quot;my.registry.io/eclipse/hono-service-device-connection:1.0.3-CUSTOM\u0026quot; adapters: amqp: imageName: \u0026quot;my.registry.io/eclipse/hono-adapter-amqp-vertx:1.0.3-CUSTOM\u0026quot; mqtt: imageName: \u0026quot;my.registry.io/eclipse/hono-adapter-mqtt-vertx:1.0.3-CUSTOM\u0026quot; http: imageName: \u0026quot;my.registry.io/eclipse/hono-adapter-http-vertx:1.0.3-CUSTOM\u0026quot;  Assuming that the YAML file is called imageNames.yaml, installation can then be done using:\nhelm install --dependency-update -n hono -f imageNames.yaml eclipse-hono eclipse-iot/hono  Deploying to Minikube When using Minikube as the deployment target, things are a little easier. Minikube comes with an embedded Docker daemon which can be used to build the container images instead of using a local Docker daemon, thus eliminating the need to push the images to a registry altogether. In order to use Minikube\u0026rsquo;s Docker daemon, the following command needs to be run:\neval $(minikube docker-env)  This will set the Docker environment variables to point to Minikube\u0026rsquo;s Docker daemon which can then be used for building the container images and storing them locally in the Minikube VM.\nIn any case the build process can be started using the following command:\n# in base directory of Hono working tree: mvn clean install -Pbuild-docker-image,metrics-prometheus  The newly built images can then be deployed using Helm:\nhelm install --dependency-update -n hono eclipse-hono eclipse-iot/hono  Using Jaeger Tracing Hono\u0026rsquo;s components are instrumented using OpenTracing to allow tracking of the distributed processing of messages flowing through the system. The Hono chart can be configured to report tracing information to the Jaeger tracing system. The Spans reported by the components can then be viewed in a web browser.\nIn order for Hono\u0026rsquo;s components to use the Jaeger client for reporting tracing information, the container images need to be built with the jaeger Maven profile. Please refer to Monitoring \u0026amp; Tracing for details. The newly built images also need to be made available to the target Kubernetes cluster as described in the two previous sections.\nThe chart can be configured to deploy and use an example Jaeger back end by means of setting the jaegerBackendExample.enabled property to true when running Helm:\nhelm install --dependency-update -n hono --set jaegerBackendExample.enabled=true eclipse-hono eclipse-iot/hono  This will create a Jaeger back end instance suitable for testing purposes and will configure all deployed Hono components to use the Jaeger back end.\nThe following command can then be used to return the IP address with which the Jaeger UI can be accessed in a browser (ensure minikube tunnel is running when using minikube):\nkubectl get service hono-jaeger-query --output='jsonpath={.status.loadBalancer.ingress[0].ip}' -n hono  If no example Jaeger back end should be deployed but instead an existing Jaeger installation should be used, the chart\u0026rsquo;s jaegerAgentConf property can be set to environment variables which are passed in to the Jaeger Agent that is deployed with each of Hono\u0026rsquo;s components.\nhelm install --dependency-update -n hono --set jaegerAgentConf.REPORTER_TYPE=tchannel --set jaegerAgentConf.REPORTER_TCHANNEL_HOST_PORT=my-jaeger-collector:14267 eclipse-hono eclipse-iot/hono  Deploying to Azure Kubernetes Service (AKS) The following chapter describes how to use Azure Kubernetes Service (AKS) as a deployment target that has been set up as described in the Setting up a Kubernetes Cluster guide.\nFirst we build the docker images and push them into the ACR. Note that if you define a custom image tag you have to provide the helm with the image tags as described in the chapters above.\n# Resource group where the ACR is deployed. acr_resourcegroupname={YOUR_ACR_RG} # Name of your ACR. acr_registry_name={YOUR_ACR_NAME} # Full name of the ACR. acr_login_server=$acr_registry_name.azurecr.io # Authenticate your docker daemon with the ACR. az acr login --name $ACR_NAME # Build images. cd hono mvn install -Pbuild-docker-image -Ddocker.registry=$acr_login_server # Push images to ACR. ./push_hono_images.sh 1.0.0-SNAPSHOT $acr_login_server  Now we can retrieve settings from the deployment for the following steps:\n# Resource group of the AKS deployment resourcegroup_name=hono aks_cluster_name=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.aksClusterName.value -o tsv` http_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.httpPublicIPAddress.value -o tsv` amqp_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.amqpPublicIPAddress.value -o tsv` mqtt_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.mqttPublicIPAddress.value -o tsv` registry_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.registryPublicIPAddress.value -o tsv` network_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.networkPublicIPAddress.value -o tsv`  Note: add the following lines in case you opted for the Azure Service Bus variant:\nservice_bus_namespace=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.serviceBusNamespaceName.value -o tsv` service_bus_key_name=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.serviceBusKeyName.value -o tsv` service_bus_key=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.serviceBusKey.value -o tsv`  Next we prepare the k8s environment:\nk8s_namespace=honons kubectl create namespace $k8s_namespace  Finally install Hono. Leveraging the managed-premium-retain storage in combination with deviceRegistry.resetFiles=false parameter is optional but ensures that Device registry storage will retain future update deployments.\n# in Hono working tree directory: hono/deploy helm install target/deploy/helm/eclipse-hono/ \\ --dep-up \\ --name hono \\ --namespace $k8s_namespace \\ --set adapters.mqtt.svc.annotations.\u0026quot;service\\.beta\\.kubernetes\\.io/azure-load-balancer-resource-group\u0026quot;=$resourcegroup_name \\ --set adapters.http.svc.annotations.\u0026quot;service\\.beta\\.kubernetes\\.io/azure-load-balancer-resource-group\u0026quot;=$resourcegroup_name \\ --set adapters.amqp.svc.annotations.\u0026quot;service\\.beta\\.kubernetes\\.io/azure-load-balancer-resource-group\u0026quot;=$resourcegroup_name \\ --set deviceRegistryExample.svc.annotations.\u0026quot;service\\.beta\\.kubernetes\\.io/azure-load-balancer-resource-group\u0026quot;=$resourcegroup_name \\ --set amqpMessagingNetworkExample.dispatchRouter.svc.annotations.\u0026quot;service\\.beta\\.kubernetes\\.io/azure-load-balancer-resource-group\u0026quot;=$resourcegroup_name \\ --set deviceRegistryExample.storageClass=managed-premium-retain \\ --set deviceRegistryExample.resetFiles=false \\ --set adapters.mqtt.svc.loadBalancerIP=$mqtt_ip_address \\ --set adapters.http.svc.loadBalancerIP=$http_ip_address \\ --set adapters.amqp.svc.loadBalancerIP=$amqp_ip_address \\ --set deviceRegistryExample.svc.loadBalancerIP=$registry_ip_address \\ --set amqpMessagingNetworkExample.dispatchRouter.svc.loadBalancerIP=$network_ip_address  Note: add the following lines in case you opted for the Azure Service Bus variant:\n# Router update required to work together with Azure Service Bus --set amqpMessagingNetworkExample.dispatchRouter.imageName=quay.io/enmasse/qdrouterd-base:1.8.0 \\ --set amqpMessagingNetworkExample.broker.type=servicebus \\ --set amqpMessagingNetworkExample.broker.servicebus.saslUsername=$service_bus_key_name \\ --set amqpMessagingNetworkExample.broker.servicebus.saslPassword=$service_bus_key \\ --set amqpMessagingNetworkExample.broker.servicebus.host=$service_bus_namespace.servicebus.windows.net \\  Have fun with Hono on Microsoft Azure!\nNext steps:\nYou can follow the steps as described in the Getting Started guide with the following differences:\nCompared to a plain k8s deployment Azure provides us DNS names with static IPs for the Hono endpoints. To retrieve them:\nHTTP_ADAPTER_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.httpPublicIPFQDN.value -o tsv` AMQP_ADAPTER_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.amqpPublicIPFQDN.value -o tsv` MQTT_ADAPTER_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.mqttPublicIPFQDN.value -o tsv` REGISTRY_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.registryPublicIPFQDN.value -o tsv` AMQP_NETWORK_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.networkPublicIPFQDN.value -o tsv`  As Azure Service Bus does not support auto creation of queues you have to create a queue per tenant (ID), e.g. after you have created your tenant run:\naz servicebus queue create --resource-group $resourcegroup_name \\ --namespace-name $service_bus_namespace \\ --name $MY_TENANT "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/deployment/openshift/",
+	"title": "OpenShift / OKD",
+	"tags": [],
+	"description": "",
+	"content": "In Hono version 1.0 we dropped the OpenShift specific deployment using the source-to-image (S2I) model, in favor of the Helm charts and the Eclipse IoT Packages project.\nYou can still deploy to OpenShift and OKD, using the Helm charts. And you can also use routes to expose services. Deploying using S2I is also still possible, however the Hono project simply no longer provides out-of-the box scripts for doing so.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/deployment/create-kubernetes-cluster/",
+	"title": "Setting up a Kubernetes Cluster",
+	"tags": [],
+	"description": "",
+	"content": "This guide describes how to set up a Kubernetes cluster which can be used to run Eclipse Hono\u0026trade;.\nHono can be deployed to any Kubernetes cluster running version 1.11 or newer. This includes OpenShift (Origin) which is built on top of Kubernetes.\nThe Kubernetes web site provides instructions for setting up a (local) cluster on bare metal and/or virtual infrastructure from scratch or for provisioning a managed Kubernetes cluster from one of the popular cloud providers.\n\nSetting up a local Development Environment The easiest option is to set up a single-node cluster running on a local VM using the Minikube project. This kind of setup is sufficient for evaluation and development purposes. Please refer to Minikube\u0026rsquo;s getting started guide for instructions on how to set up a cluster locally.\nThe recommended settings for a Minikube VM used for running Hono\u0026rsquo;s example setup are as follows:\n cpus: 2 memory: 8192 (MB)  The command to start the VM will look something like this:\nminikube start --cpus 2 --memory 8192  After the Minikube VM has started successfully, the minikube tunnel command should be run in order to support Hono\u0026rsquo;s services being deployed using the LoadBalancer type. Please refer to the Minikube Loadbalancer docs for details.\n Setting Kubernetes Version Minikube will use the most recent Kubernetes version that was available when it has been compiled by default. Hono should run on any version of Kubernetes starting with 1.13.6. However, it has been tested with several specific versions only. The most recent version known to work is 1.15.4 so if you experience any issues with running Hono on another version, please try to deploy to 1.15.4 before raising an issue. You can use Minikube\u0026rsquo;s --kubernetes-version command line switch to set a particular version.  Setting up a Production Environment Setting up a multi-node Kubernetes cluster is a more advanced topic. Please follow the corresponding links provided in the Kubernetes documentation.\nSetting up an Environment on Microsoft Azure This chapter describes how Hono can be deployed on Microsoft Azure. It includes:\n Azure Resource Manager (ARM) templates for an automated infrastructure deployment. Helm based deployment of Hono to Azure Kubernetes Service (AKS). Push Hono docker images to an Azure Container Registry (ACR). Optional Azure Service Bus as broker for the Hono AMQP 1.0 Messaging Network instead of a self hosted ActiveMQ Artemis. Virtual Network (VNet) service endpoints ensure protected communication between AKS and Azure Service Bus.   Use for demos only This deployment model is not meant for productive use but rather for evaluation as well as demonstration purposes or as a baseline to evolve a production grade Application architecture out of it which includes Hono.  Prerequisites  An Azure subscription. Azure CLI installed to setup the infrastructure. kubectl and helm installed to deploy Hono into Azure Kubernetes Service (AKS)  Setup As described here we will create an explicit service principal. Later we add roles to this principal to access the Azure Container Registry (ACR).\n# Create service principal service_principal=`az ad sp create-for-rbac --name http://honoServicePrincipal --skip-assignment --output tsv` app_id_principal=`echo $service_principal | cut -f1 -d ' '` password_principal=`echo $service_principal | cut -f4 -d ' '` object_id_principal=`az ad sp show --id $app_id_principal --query objectId --output tsv`  Note: it might take a few seconds until the principal is available for the next steps.\nNow we create the Azure Container Registry instance and provide read access to the service principal.\n# Resource group where the ACR is deployed. acr_resourcegroupname={YOUR_ACR_RG} # Name of your ACR. acr_registry_name={YOUR_ACR_NAME} # Full name of the ACR. acr_login_server=$acr_registry_name.azurecr.io az acr create --resource-group $acr_resourcegroupname --name $acr_registry-name --sku Basic acr_id_access_registry=`az acr show --resource-group $acr_resourcegroupname --name $acr_registry_name --query \u0026quot;id\u0026quot; --output tsv` az role assignment create --assignee $app_id_principal --scope $acr_id_access_registry --role Reader  With the next command we will use the provided Azure Resource Manager (ARM) templates to setup the AKS cluster. This might take a while.\nresourcegroup_name=hono az group create --name $resourcegroup_name --location \u0026quot;westeurope\u0026quot; unique_solution_prefix=myprefix cd deploy/src/main/deploy/azure/ az group deployment create --name HonoBasicInfrastructure --resource-group $resourcegroup_name --template-file arm/honoInfrastructureDeployment.json --parameters uniqueSolutionPrefix=$unique_solution_prefix servicePrincipalObjectId=$object_id_principal servicePrincipalClientId=$app_id_principal servicePrincipalClientSecret=$password_principal  Notes:\n add the following parameter in case you want to opt for the Azure Service Bus as broker in the Hono AMQP 1.0 Messaging Network instead of deploying a (self-hosted) ActiveMQ Artemis into AKS: serviceBus=true add the following parameter to define the k8s version of the AKS cluster. The default as defined in the template might not be supported in your target Azure region, e.g. kubernetesVersion=1.14.6  After the deployment is complete you can set your cluster in kubectl.\naz aks get-credentials --resource-group $resourcegroup_name --name $aks_cluster_name  Next create retain storage for the device registry.\nkubectl apply -f managed-premium-retain.yaml  Now Hono can be installed to the AKS cluster as describe in the Helm based installation guide.\nMonitoring You can monitor your cluster using Azure Monitor for containers.\nNavigate to https://portal.azure.com -\u0026gt; your resource group -\u0026gt; your kubernetes cluster\nOn an overview tab you fill find an information about your cluster (status, location, version, etc.). Also, here you will find a Monitor Containers link. Navigate to Monitor Containers and explore metrics and statuses of your Cluster, Nodes, Controllers and Containers.\nCleaning up Use the following command to delete all created resources once they are no longer needed:\naz group delete --name $resourcegroup_name --yes --no-wait "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/deployment/resource-limitation/",
+	"title": "Limiting Resource Usage",
+	"tags": [],
+	"description": "",
+	"content": "Deploying Eclipse Hono\u0026trade; to a container orchestration platform is easy thanks to the provided Docker images. This page provides some guidance for configuring the resource consumption of these containers in order to make sure that they get enough memory and CPU to run properly, but to also make sure that individual containers do not use up all the resources causing other containers to starve.\nDocker itself provides means to limit a container\u0026rsquo;s consumption of memory and CPU resources by means of command line options that can be set when starting up a container. Both Kubernetes and OpenShift leverage this mechanism when defining resource limits of a pod. Please refer to the corresponding documentation of Docker, Kubernetes and OpenShift for details regarding the particular syntax to be used.\nJava\u0026rsquo;s View of the World Hono\u0026rsquo;s service components are implemented in Java. When the corresponding Docker container for such a service is started, the only process being run inside the container is therefore a Java virtual machine (JVM). On startup, the JVM tries to determine the amount of memory and the number of CPU cores that it can use to execute workloads. By default the JVM queries the operating system for the corresponding parameters and adjusts its runtime parameters accordingly, e.g. it will by default limit the size of its heap memory to a quarter of the total memory available in order to leave enough memory for other processes running on the same system.\nThis is a reasonable approach when running on bare metal or a VM where other processes are expected to be running on the same machine, thus competing for the same computing resources. However, containers are usually configured to run a single process only so that it makes more sense to dedicate almost all of the available resources to running that process, leaving the (small) rest for the operating system itself.\nAs described above, a Docker container can easily be configured with a limit for memory and CPU resources that it may use during runtime. These limits are set and enforced using Linux CGroups.\nLimiting a Component\u0026rsquo;s Memory Consumption Starting with Java 9, the JVM will correctly determine the total memory and number of CPUs available when running inside of a container. All of the Docker images provided by Hono run with OpenJDK 11 by default, thus ensuring that the JVM considers any memory limits configured for the container when configuring its heap during startup. However, the default algorithm will still only allocate a quarter of the (limited) amount of memory, thus leaving a lot of memory available to the container unused.\nThe following JVM options can be used in Java 9 and later in order to change this behavior:\n -XX:MinRAMPercentage, -XX:MaxRAMPercentage and -XX:InitialRAMPercentage can be used to set the (minimum, maximum and initial) percentage of total memory that may be allocated for the heap. A value of 70-80% should work if no other processes are running in the same container.  Kubernetes In Kubernetes (and OpenShift) the resource limits for a pod, and thus the container(s) that are part of the pod, can be configured in the corresponding PodSpec. The following example from the HTTP adapter\u0026rsquo;s Kubernetes Deployment resource descriptor illustrates the mechanism:\napiVersion: apps/v1beta1 kind: Deployment metadata: name: hono-adapter-http-vertx spec: template: metadata: labels: app: hono-adapter-http-vertx version: \u0026quot;${project.version}\u0026quot; group: ${project.groupId} spec: containers: - image: eclipse/hono-adapter-http-vertx:${project.version} name: eclipse-hono-adapter-http-vertx resources: limits: memory: \u0026quot;256Mi\u0026quot; ports: - containerPort: 8080 protocol: TCP env: - name: SPRING_CONFIG_LOCATION value: file:///etc/hono/ - name: SPRING_PROFILES_ACTIVE value: dev - name: LOGGING_CONFIG value: classpath:logback-spring.xml - name: _JAVA_OPTIONS value: \u0026quot;-XX:MinRAMPercentage=80 -XX:MaxRAMPercentage=80\u0026quot; volumeMounts: - mountPath: /etc/hono name: conf readOnly: true volumes: - name: conf secret: secretName: hono-adapter-http-vertx-conf  The resources property defines the overall limit of 256 MB of memory that the pod may use. The _JAVA_OPTIONS environment variable is again used to configure the JVM to use 80% of the total memory for its heap.\nLimiting the Number of Device Connections Hono supports limiting the overall number of simultaneously connected devices per tenant. Please refer to the connections limit concept for more information. The limit needs to be configured at the tenant level using the resource-limits configuration property. Please refer to the Tenant API for configuration details.\nLimiting the Overall Connection Time Hono supports configuring limits based on the overall amount of time that the devices have already been connected to protocol adapters for a tenant. Please refer to the connection duration limit for more information. Before accepting any connection requests from the devices, the protocol adapters verify that the configured connection duration limit is not exceeded. If the limit has been already reached, then the connection request is rejected. The limit needs to be configured at the tenant level using the resource-limits configuration property. Please refer to the Tenant API for configuration details.\nLimiting the Data Volume Hono supports limiting the amount of data that devices of a tenant can publish to Hono during a given time interval. Please refer to the messages limit concept for more information. The limit needs to be configured at the tenant level using the resource-limits configuration property. Please refer to the Tenant API for configuration details.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/architecture/",
+	"title": "Architecture",
+	"tags": [],
+	"description": "",
+	"content": " Architecture Get an overview of the architecture of Eclipse Hono\u0026trade;.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/architecture/component-view/",
+	"title": "Component View",
+	"tags": [],
+	"description": "",
+	"content": "This page describes the high level components constituting an Eclipse Hono\u0026trade; instance and their relations to each other.\nTop Level The diagram below provides an overview of the top level logical components.\n  The MQTT and HTTP Adapters use the Device Registry to authenticate Devices connecting to the adapters and asserting their registration status. The adapters then forward the telemetry data and events received from the devices to the AMQP 1.0 Messaging Network for delivery to Business Applications. Business applications also use the messaging network to send commands to connected devices.\nThe Device Registry uses the Auth Server to authenticate the protocol adapters during connection establishment.\nAll interactions between the components are based on AMQP 1.0 message exchanges as defined by the\n Credentials API, Tenant API, Device Registration API, Device Connection API, Command \u0026amp; Control API, Telemetry API and Event API.  Device Registry The diagram below provides an overview of the Device Registry component\u0026rsquo;s internal structure.\n  The Device Registry component implements the Credentials API, Tenant API, Device Registration API and Device Connection API. Clients opening a connection to SimpleDeviceRegistryServer are authenticated by means of an external service accessed via the Auth port. The FileBasedCredentialsService, FileBasedTenantService and FileBasedRegistrationService store all data in the local file system. The MapBasedDeviceConnectionService keeps all data in memory. The Device Registry is therefore not recommended to be used in production environments because the component cannot easily scale out horizontally. It is mainly intended to be used for demonstration purposes and PoCs. In real world scenarios, a more sophisticated implementation should be used that is designed to scale out, e.g. using a persistent store for keeping device registration information that can be shared by multiple instances.\nAMQP 1.0 Messaging Network The AMQP 1.0 Messaging Network is not per se a component being developed as part of Hono. Instead, Hono comes with a default implementation of the messaging network relying on artifacts provided by other open source projects. The default implementation currently consists of a single Apache Qpid Dispatch Router instance connected to a single Apache Artemis broker instance. Note that this setup is useful for development purposes but will probably not meet requirements regarding e.g. scalability of real world use cases.\nThe diagram below provides an overview of the default implementation of the Messaging Network component used with Hono.\n  Scaling out messaging infrastructure is a not a trivial task. Hono does not provide an out-of-the-box solution to this problem but instead integrates with the EnMasse project which aims at providing Messaging as a Service infrastructure.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/architecture/auth/",
+	"title": "Authentication/Authorization",
+	"tags": [],
+	"description": "",
+	"content": "This page describes how authentication and authorization of devices, consumers (back end applications) and system components works in Hono.\nRequirements  Devices are authenticated and authorized when they connect to a protocol adapter. Consumers are authenticated and authorized when they connect to a Dispatch Router instance. System components are authenticated and authorized when they connect to each other. Credentials and authorization rules can be managed centrally, i.e. credentials and rules do not need to be configured manually on each component.  How it works today The following diagram provides an overview of the components involved in use cases requiring authentication and authorization.\n  Device Auth Both the HTTP adapter as well as the MQTT adapter require devices to authenticate during connection establishment by default. Both rely on the Credentials API to help in verifying credentials provided by a device. Please refer to Device Authentication for a general overview of Hono\u0026rsquo;s approach to authenticating devices and to the protocol adapter user guides for specifics regarding how devices can authenticate to the corresponding protocol adapters.\nSystem Component Auth Client components opening an AMQP connection to a server component are authenticated using SASL PLAIN as specified in RFC 4422. The server component takes the authentication information provided by the client component and opens a connection to the Auth Server, using the credentials provided by the client in its SASL PLAIN exchange with the server component. On successful authentication the Auth Server issues a JSON Web Token (JWT) asserting the client\u0026rsquo;s identity and its granted authorities to the server component. The server component then attaches this token to its AMQP connection with the client and from then on uses it to make authorization decisions regarding the client\u0026rsquo;s requests. See Authentication API for details regarding the authentication process and the format of the tokens issued by the Auth Server.\nBased on the components shown above, the following sequence diagram shows how the MQTT Adapter connects to the Device Registry and gets authenticated transparently using the Auth Server.\n  Client components are authorized whenever they open a new AMQP link on an existing connection to the server. When a client tries to open a receiver link, the server checks if the client is authorized to read from the source address the client has specified in its AMQP attach frame. Analogously, when a client tries to open a sender link, the server checks if the client is authorized to write to the target address from the client\u0026rsquo;s attach frame.\nService implementations may additionally authorize individual (request) messages received from the client, e.g. based on the message\u0026rsquo;s subject property which is used by Hono\u0026rsquo;s AMQP 1.0 based APIs to indicate the operation to invoke. In such a case the server checks if the client is authorized to execute the operation indicated by the message subject on the link\u0026rsquo;s target address.\nApplication Auth Business Applications connect to the AMQP 1.0 Messaging Network in order to consume telemetry data and events and send commands to devices. It is therefore the responsibility of the AMQP Network to properly authenticate and authorize the application.\nThe Apache Qpid Dispatch Router which is used in Hono\u0026rsquo;s example deployment can be configured to authenticate consumers using arbitrary SASL mechanisms. Access to addresses for receiving messages can be restricted to certain identities. The Dispatch Router instance which is used in the example deployment is configured to delegate authentication of clients to the Auth Server by means of its Auth Service Plugin mechanism. This mechanism works in a very similar way as described above for the authentication of system components. The main difference is that the clients\u0026rsquo; authorities are not transferred by means of a JSON Web Token but instead are carried in a property of the Auth Server\u0026rsquo;s AMQP open frame.\nManagement of Identities and Authorities The identities and corresponding authorities that the Auth Server uses for verifying credentials and issuing tokens are defined in a configuration file (services/auth/src/main/resources/permissions.json) read in during start-up of the Auth Server. These authorities are used for authenticating and authorizing system components as well as Business Applications.\nPlease refer to the Dispatch Router documentation for details regarding configuration of Dispatch Router security.\nFuture Approach In the long run Hono will still use tokens for authenticating clients but will use a policy based approach for authorizing requests, i.e. authorization decisions will be made by a central policy enforcement component. Hono services will pass in the client\u0026rsquo;s token, the resource being accessed and the intended action along with potentially other attributes to the policy enforcement component which will then make the authorization decision based on the configured rules (policy) and return the outcome to the component.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/categories/",
+	"title": "Categories",
+	"tags": [],
+	"description": "",
+	"content": ""
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/1.2/tags/",
+	"title": "Tags",
+	"tags": [],
+	"description": "",
+	"content": ""
+}]
\ No newline at end of file
diff --git a/docs/1.2/index.xml b/docs/1.2/index.xml
new file mode 100644
index 0000000..ef790d9
--- /dev/null
+++ b/docs/1.2/index.xml
@@ -0,0 +1,477 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>Documentation on Eclipse Hono&amp;trade; Vers.: 1.2</title>
+    <link>https://www.eclipse.org/hono/docs/1.2/</link>
+    <description>Recent content in Documentation on Eclipse Hono&amp;trade; Vers.: 1.2</description>
+    <generator>Hugo -- gohugo.io</generator>
+    <language>en-us</language>
+    
+	<atom:link href="https://www.eclipse.org/hono/docs/1.2/index.xml" rel="self" type="application/rss+xml" />
+    
+    
+    <item>
+      <title>Device Identity</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/concepts/device-identity/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/concepts/device-identity/</guid>
+      <description>&lt;p&gt;This page describes how devices are represented and identified throughout Hono and its APIs.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Multi-Tenancy</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/concepts/tenancy/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/concepts/tenancy/</guid>
+      <description>Hono is designed to structure the set of all internally managed data and data streams into strictly isolated subsets. This includes the registration data and credentials of devices, internal users that are used for authentication, and the Business Applications that are part of such subsets as well.
+This way of strict isolation is generally known as multi-tenancy, where a tenant is the term for such a subset. Such an isolation is essential for enabling a scalable distributed architecture to handle independent subsets as if each subset had its own installation (which would be much harder to maintain and would not benefit from runtime cost sharing).</description>
+    </item>
+    
+    <item>
+      <title>Device Provisioning</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/concepts/device-provisioning/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/concepts/device-provisioning/</guid>
+      <description>This page describes how devices are provisioned in Hono, i.e. how their digital representation is generated. For each device, registration information is stored that defines a device identity. Each device belongs to exactly one tenant. Each device must have at least one set of credentials that are used to authenticate to Hono.
+To get an understanding of what is meant by the terms tenant, device registration and credentials, it is recommended to read the Device Identity page first.</description>
+    </item>
+    
+    <item>
+      <title>Connecting Devices</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/concepts/connecting-devices/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/concepts/connecting-devices/</guid>
+      <description>One of the most important features of Eclipse Hono&amp;trade; is to abstract away the specific communication protocols used by devices. This page describes the different ways of how devices can be connected to Hono. Before a device can connect to Hono and upload data or receive commands from downstream applications, it needs to be provisioned to the system. As part of device provisioning, the device is associated with the tenant that it belongs to and gets assigned a logical identifier which is unique within the tenant.</description>
+    </item>
+    
+    <item>
+      <title>Device Notifications</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/concepts/device-notifications/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/concepts/device-notifications/</guid>
+      <description>&lt;p&gt;&lt;em&gt;Business Applications&lt;/em&gt; need to know when an attempt to send a command to device is feasible, e.g. because the device is then known to be connected to a protocol adapter. &lt;em&gt;Devices&lt;/em&gt; and &lt;em&gt;Protocol Adapters&lt;/em&gt; can indicate to &lt;em&gt;Business Applications&lt;/em&gt; a device&amp;rsquo;s intent to e.g. receive commands using specific &lt;em&gt;notifications&lt;/em&gt;.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Command &amp; Control</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/concepts/command-and-control/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/concepts/command-and-control/</guid>
+      <description>&lt;p&gt;&lt;em&gt;Business applications&lt;/em&gt; can send commands to devices following the &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/command-and-control/&#34;&gt;Command &amp;amp; Control API&lt;/a&gt;. This concept page describes how this API is used by applications to send commands and describes how Hono&amp;rsquo;s protocol adapters process the commands so that they reach their target device.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Resource limits</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/concepts/resource-limits/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/concepts/resource-limits/</guid>
+      <description>Resource limits such as the maximum number of device connections allowed per tenant or the allowed data volume of the messages over a period of time per tenant can be set in Hono.
+Hono specifies an API ResourceLimitChecks that is used by the protocol adapters for the verification of the configured resource limits. A default implementation of this API is shipped with Hono. This default implementation uses the live metrics data retrieved from a Prometheus server to verify the resource-limits, if configured.</description>
+    </item>
+    
+    <item>
+      <title>Connection Events</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/concepts/connection-events/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/concepts/connection-events/</guid>
+      <description>Hono&amp;rsquo;s protocol adapters can use connection events to indicate the connection status of a device. In particular, an adapter can notify downstream components about a newly established connection with a device or about a device having disconnected. The connection status of devices using stateful protocols like MQTT and AMQP can usually be determined quite easily because these protocols often require peers to explicitly open or close a connection and often also support a kind of heart beat which can be used to determine if a connection is still alive.</description>
+    </item>
+    
+    <item>
+      <title>Device Registry</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/user-guide/device-registry/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/user-guide/device-registry/</guid>
+      <description>&lt;p&gt;The Device Registry component provides exemplary implementations of Hono&amp;rsquo;s &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/tenant/&#34;&gt;Tenant API&lt;/a&gt;, &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/device-registration/&#34;&gt;Device Registration API&lt;/a&gt; and &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/credentials/&#34;&gt;Credentials API&lt;/a&gt;.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>HTTP Adapter</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/user-guide/http-adapter/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/user-guide/http-adapter/</guid>
+      <description>&lt;p&gt;The HTTP protocol adapter exposes HTTP based endpoints for Eclipse Hono&amp;trade;&amp;rsquo;s south bound Telemetry, Event and Command &amp;amp; Control APIs.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>MQTT Adapter</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/user-guide/mqtt-adapter/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/user-guide/mqtt-adapter/</guid>
+      <description>&lt;p&gt;The MQTT protocol adapter exposes an MQTT topic hierarchy for publishing telemetry data and events to downstream consumers and for receiving commands from applications and sending back responses.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>AMQP Adapter</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/user-guide/amqp-adapter/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/user-guide/amqp-adapter/</guid>
+      <description>&lt;p&gt;The AMQP protocol adapter allows clients (devices or gateway components) supporting the AMQP 1.0 protocol to publish messages to Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry, Event and Command &amp;amp; Control endpoints.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>CoAP Adapter</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/user-guide/coap-adapter/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/user-guide/coap-adapter/</guid>
+      <description>&lt;p&gt;The CoAP protocol adapter exposes &lt;a href=&#34;https://tools.ietf.org/html/rfc7252&#34;&gt;CoAP&lt;/a&gt; based endpoints for Eclipse Hono&amp;trade;&amp;rsquo;s south bound Telemetry, Event and Command &amp;amp; Control APIs.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Kura Adapter</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/user-guide/kura-adapter/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/user-guide/kura-adapter/</guid>
+      <description>&lt;p&gt;The Kura protocol adapter exposes an MQTT topic hierarchy allowing Eclipse Kura&amp;trade; based gateways to publish &lt;em&gt;control&lt;/em&gt; and &lt;em&gt;data&lt;/em&gt; messages to Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry and Event endpoints.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Sigfox Adapter</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/user-guide/sigfox-adapter/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/user-guide/sigfox-adapter/</guid>
+      <description>&lt;p&gt;The Sigfox protocol adapter exposes an HTTP endpoint for connecting up with
+the Sigfox backend for publishing telemetry, events and use command &amp;amp; control.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Load Tests with JMeter</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/user-guide/jmeter_load_tests/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/user-guide/jmeter_load_tests/</guid>
+      <description>&lt;p&gt;Eclipse Hono&amp;trade; comes with an &lt;a href=&#34;https://jmeter.apache.org&#34;&gt;Apache JMeter&lt;/a&gt; plugin which provides &lt;em&gt;samplers&lt;/em&gt; that can be used in JMeter test plans to send and receive telemetry/event data.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Common Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/common-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/common-config/</guid>
+      <description>&lt;p&gt;Many Hono components support a common set of configuration options. This section
+describes those options.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Auth Server Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/auth-server-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/auth-server-config/</guid>
+      <description>&lt;p&gt;The Auth Server component exposes a service endpoint implementing Eclipse Hono&amp;trade;&amp;rsquo;s &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/authentication/&#34;&gt;Authentication&lt;/a&gt; API. Other services use this component for authenticating clients and retrieving a token asserting the client&amp;rsquo;s identity and corresponding authorities.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Device Registry Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/device-registry-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/device-registry-config/</guid>
+      <description>&lt;p&gt;The Device Registry component provides an exemplary implementation of Eclipse Hono&amp;trade;&amp;rsquo;s &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/device-registration/&#34;&gt;Device Registration&lt;/a&gt;,
+&lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/credentials/&#34;&gt;Credentials&lt;/a&gt;, &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/tenant/&#34;&gt;Tenant&lt;/a&gt; and &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/device-connection/&#34;&gt;Device Connection&lt;/a&gt; APIs.&lt;/p&gt;
+
+&lt;p&gt;Protocol adapters use these APIs to determine a device&amp;rsquo;s registration status, e.g. if it is enabled and if it is registered with a particular tenant, and to authenticate a device before accepting any data for processing from it.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Configuring the Device Connection Service</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/device-connection-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/device-connection-config/</guid>
+      <description>&lt;p&gt;The Device Connection service provides an implementation of Eclipse Hono&amp;trade;&amp;rsquo;s &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/device-connection/&#34;&gt;Device Connection API&lt;/a&gt;.&lt;/p&gt;
+
+&lt;p&gt;Protocol adapters use this API to store and retrieve information about the gateway that a device is using to connect to Hono&amp;rsquo;s protocol adapters. This information is necessary for routing commands to the particular protocol adapter instance that the gateway used by the device is connected to.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>HTTP Adapter Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/http-adapter-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/http-adapter-config/</guid>
+      <description>&lt;p&gt;The HTTP protocol adapter exposes a HTTP based API for Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry and Event endpoints.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>AMQP Adapter Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-adapter-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-adapter-config/</guid>
+      <description>&lt;p&gt;The AMQP protocol adapter allows clients (devices and gateway components) that speaks AMQP 1.0 to publish telemetry messages and events to Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry and Event endpoints.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>MQTT Adapter Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/mqtt-adapter-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/mqtt-adapter-config/</guid>
+      <description>&lt;p&gt;The MQTT protocol adapter exposes an MQTT topic hierarchy for publishing messages and events to Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry and Event endpoints.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Kura Adapter Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/kura-adapter-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/kura-adapter-config/</guid>
+      <description>&lt;p&gt;The Kura protocol adapter exposes an MQTT topic hierarchy allowing Eclipse Kura&amp;trade; based gateways to publish &lt;em&gt;control&lt;/em&gt; and &lt;em&gt;data&lt;/em&gt; messages to Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry and Event endpoints.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Hono Client Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/hono-client-configuration/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/hono-client-configuration/</guid>
+      <description>&lt;p&gt;The &lt;code&gt;org.eclipse.hono.client.HonoConnection&lt;/code&gt; factory can be used to create AMQP 1.0 connections to Hono&amp;rsquo;s service components.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>AMQP 1.0 Messaging Network Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-network-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-network-config/</guid>
+      <description>&lt;p&gt;The &lt;em&gt;Qpid Dispatch Router&lt;/em&gt;, together with the &lt;em&gt;Apache Artemis&lt;/em&gt; message broker, serves as the default &lt;em&gt;AMQP 1.0 Messaging Network&lt;/em&gt; that is used in Hono&amp;rsquo;s example deployment as described in the &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/deployment/&#34;&gt;Deployment Guides&lt;/a&gt;.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Secure Communication</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/secure_communication/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/secure_communication/</guid>
+      <description>&lt;p&gt;The individual components of an Eclipse Hono&amp;trade; installation, e.g. the protocol adapters, &lt;em&gt;AMQP Messaging Network&lt;/em&gt;, &lt;em&gt;Hono Auth&lt;/em&gt; etc., and the clients attaching to Hono in order to send and receive data all communicate with each other using AMQP 1.0 over TCP. The Hono components and the clients will usually not be located on the same local network but will probably communicate over public networking infrastructure. For most use cases it is therefore desirable, if not necessary, to provide for confidentiality of the data being transferred between these components. This section describes how Hono supports confidentiality by means of &lt;em&gt;Transport Layer Security&lt;/em&gt; (TLS) and how to configure it.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Monitoring &amp; Tracing</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/admin-guide/monitoring-tracing-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/admin-guide/monitoring-tracing-config/</guid>
+      <description>&lt;p&gt;The individual components of an Eclipse Hono&amp;trade; installation need to work together in order to provide their functionality to devices and applications. Under normal circumstances these interactions work flawlessly. However, due to the nature of distributed systems, any one (or more) of the components may crash or become otherwise unavailable due to arbitrary reasons. This page describes how Hono supports operations teams by providing insights into the individual service components and their interactions with each other by means of reporting metrics and tracing the processing of individual messages through the system.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Building from Source</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/dev-guide/building_hono/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/dev-guide/building_hono/</guid>
+      <description>Hono can be deployed using the pre-built Docker images available from our Docker Hub repositories. However, customizing and/or extending Hono&amp;rsquo;s functionality requires building the images from source code.
+This page provides step by step instructions for getting the source code and building the Hono&amp;rsquo;s Docker images from it.
+Prerequisites for building Hono Docker Creating Hono&amp;rsquo;s container images using the Hono build process requires a Docker daemon running either locally or on another host you have access to.</description>
+    </item>
+    
+    <item>
+      <title>AMQP Adapter Client for Java</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/dev-guide/amqp_adapter_client/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/dev-guide/amqp_adapter_client/</guid>
+      <description>Eclipse Hono&amp;trade; comes with a Java client for the AMQP adapter. It is intended for the implementation of (prototype) devices, (protocol) gateways or (end-to-end) tests. The client is based on Eclipse Vert.x.
+The starting point is the class AmqpAdapterClientFactory.
+The factory provides methods to get a receiver for receiving commands and a sender for each of the following actions:
+ send a telemetry message send an event message send a response to a previously received command   Do not re-use sender instances The senders manage the underlying AMQP sender links, which are restored after temporary interruption of the connection (HonoConnection manages the automatic reconnection).</description>
+    </item>
+    
+    <item>
+      <title>Consuming Messages from Java</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/dev-guide/java_client_consumer/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/dev-guide/java_client_consumer/</guid>
+      <description>To illustrate how Eclipse Hono&amp;trade; can be integrated with Java code, a simple application is provided that consumes telemetry and event data for devices belonging to the default tenant.
+It also includes support for Command and Control:
+if indicated by a received downstream message that contains a ttd value (refer to Device notifications for details) it tries to send a command to the device. If the value of ttd indicates that the device stays connected for an unlimited time (ttd == -1), the application will periodically repeat to send a command until notified the device is disconnected again (ttd == 0).</description>
+    </item>
+    
+    <item>
+      <title>Implement a Custom Hono HTTP Protocol Adapter</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/dev-guide/custom_http_adapter/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/dev-guide/custom_http_adapter/</guid>
+      <description>&lt;p&gt;Eclipse Hono&amp;trade; comes with a default &lt;em&gt;HTTP Adapter&lt;/em&gt; which can be used to interact with devices via HTTP.
+The default HTTP Adapter also serves as a blueprint for implementing a &lt;em&gt;custom&lt;/em&gt; HTTP protocol adapter.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Telemetry API Specification</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/telemetry/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/telemetry/</guid>
+      <description>&lt;p&gt;The &lt;em&gt;Telemetry&lt;/em&gt; API is used by &lt;em&gt;Protocol Adapters&lt;/em&gt; to send telemetry data downstream.
+&lt;em&gt;Business Applications&lt;/em&gt; and other consumers use the API to receive data published by devices belonging to a particular tenant.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Event API Specification</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/event/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/event/</guid>
+      <description>&lt;p&gt;The &lt;em&gt;Event&lt;/em&gt; API is used by &lt;em&gt;Protocol Adapters&lt;/em&gt; to send event messages downstream.
+&lt;em&gt;Business Applications&lt;/em&gt; and other consumers use the API to receive messages published by devices belonging to a particular tenant.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Command &amp; Control API Specification</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/command-and-control/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/command-and-control/</guid>
+      <description>&lt;p&gt;The &lt;em&gt;Command &amp;amp; Control&lt;/em&gt; API of Eclipse Hono&amp;trade; is used by &lt;em&gt;Business Applications&lt;/em&gt; to send commands to connected devices.&lt;/p&gt;
+
+&lt;p&gt;Commands can be used to trigger actions on devices. Examples include updating a configuration property, installing a software component or switching the state of an actuator.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Tenant API Specification</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/tenant/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/tenant/</guid>
+      <description>&lt;p&gt;The &lt;em&gt;Tenant API&lt;/em&gt; is used by Hono&amp;rsquo;s protocol adapters to retrieve information that affects all devices belonging to a particular tenant.
+A tenant is a logical entity, which groups together a set of devices. The information registered for a tenant is used for example to
+determine if devices belonging to the tenant are allowed to connect to a certain protocol adapter or if devices are required to authenticate.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Device Connection API Specification</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/device-connection/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/device-connection/</guid>
+      <description>&lt;p&gt;The &lt;em&gt;Device Connection API&lt;/em&gt; is used by &lt;em&gt;Protocol Adapters&lt;/em&gt; to set and retrieve information about the connections from devices or gateways to the protocol adapters.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Device Registration API Specification</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/device-registration/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/device-registration/</guid>
+      <description>&lt;p&gt;The &lt;em&gt;Device Registration API&lt;/em&gt; is used by Hono&amp;rsquo;s protocol adapters to get information about devices connecting to the adapters.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Credentials API Specification</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/credentials/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/credentials/</guid>
+      <description>&lt;p&gt;The &lt;em&gt;Credentials API&lt;/em&gt; is used by &lt;em&gt;Protocol Adapters&lt;/em&gt; to retrieve credentials used to authenticate &lt;em&gt;Devices&lt;/em&gt; connecting to the adapter. In particular, the API supports to look up &lt;em&gt;shared secrets&lt;/em&gt; which are often used by IoT devices by means of &lt;em&gt;username/password&lt;/em&gt; based authentication schemes.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Authentication API Specification</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/authentication/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/authentication/</guid>
+      <description>&lt;p&gt;The &lt;em&gt;Authentication API&lt;/em&gt; is used to retrieve a &lt;em&gt;token&lt;/em&gt; asserting a subject&amp;rsquo;s identity and granted authorities. Other service implementations use such a token to make authorization decisions on a client&amp;rsquo;s request to read or write from/to a resource or to invoke a certain operation.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Device Registry Management API Specification</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/management/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/management/</guid>
+      <description>  window.onload = function() { const ui = SwaggerUIBundle({ url: &#34;device-registry-v1.yaml&#34;, dom_id: &#39;#swagger-ui&#39;, deepLinking: true, presets: [ SwaggerUIBundle.presets.apis, SwaggerUIStandalonePreset ], plugins: [ SwaggerUIBundle.plugins.DownloadUrl ], layout: &#34;StandaloneLayout&#34;, docExpansion: &#34;none&#34;, defaultModelRendering: &#34;model&#34;, defaultModelExpandDepth: 0, defaultModelsExpandDepth: -1, validatorUrl: null }) window.ui = ui }  </description>
+    </item>
+    
+    <item>
+      <title>Metrics</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/api/metrics/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/api/metrics/</guid>
+      <description>&lt;p&gt;Eclipse Hono&amp;trade;&amp;rsquo;s components report several metrics which may be used to gain some insight
+into the running system. For instance, the HTTP adapter reports the number of successfully
+processed telemetry messages. Some of these metrics are considered part of Hono&amp;rsquo;s external
+interface. This section describes the semantics and format of the metrics, how they can be retrieved
+and how to interpret actual values.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Helm based Deployment</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/deployment/helm-based-deployment/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/deployment/helm-based-deployment/</guid>
+      <description>&lt;p&gt;Eclipse Hono&amp;trade;&amp;rsquo;s components are provided as container images which can be run on arbitrary container orchestration platforms.
+This page describes the steps necessary to deploy Hono to a &lt;a href=&#34;https://kubernetes.io&#34;&gt;Kubernetes&lt;/a&gt; cluster using the
+&lt;a href=&#34;https://helm.sh&#34;&gt;Helm package manager&lt;/a&gt;.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>OpenShift / OKD</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/deployment/openshift/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/deployment/openshift/</guid>
+      <description>In Hono version 1.0 we dropped the OpenShift specific deployment using the source-to-image (S2I) model, in favor of the Helm charts and the Eclipse IoT Packages project.
+You can still deploy to OpenShift and OKD, using the Helm charts. And you can also use routes to expose services. Deploying using S2I is also still possible, however the Hono project simply no longer provides out-of-the box scripts for doing so.</description>
+    </item>
+    
+    <item>
+      <title>Setting up a Kubernetes Cluster</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/deployment/create-kubernetes-cluster/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/deployment/create-kubernetes-cluster/</guid>
+      <description>&lt;p&gt;This guide describes how to set up a Kubernetes cluster which can be used to run Eclipse Hono&amp;trade;.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Limiting Resource Usage</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/deployment/resource-limitation/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/deployment/resource-limitation/</guid>
+      <description>&lt;p&gt;Deploying Eclipse Hono&amp;trade; to a container orchestration platform is easy thanks to the provided Docker images. This page provides some guidance for configuring the resource consumption of these containers in order to make sure that they get enough memory and CPU to run properly, but to also make sure that individual containers do not use up all the resources causing other containers to starve.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Component View</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/architecture/component-view/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/architecture/component-view/</guid>
+      <description>&lt;p&gt;This page describes the high level components constituting an Eclipse Hono&amp;trade; instance and their relations to each other.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Authentication/Authorization</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/architecture/auth/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/architecture/auth/</guid>
+      <description>&lt;p&gt;This page describes how authentication and authorization of devices, consumers (back end applications) and system components works in Hono.&lt;/p&gt;</description>
+    </item>
+    
+  </channel>
+</rss>
\ No newline at end of file
diff --git a/docs/1.2/sitemap.xml b/docs/1.2/sitemap.xml
new file mode 100644
index 0000000..53997f5
--- /dev/null
+++ b/docs/1.2/sitemap.xml
@@ -0,0 +1,1609 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
+  xmlns:xhtml="http://www.w3.org/1999/xhtml">
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/concepts/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/concepts/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/concepts/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/concepts/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/concepts/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/concepts/device-identity/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/concepts/device-identity/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/concepts/device-identity/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/concepts/device-identity/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/concepts/device-identity/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/device-identity/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/concepts/tenancy/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/concepts/tenancy/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/concepts/tenancy/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/tenancy/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/concepts/device-provisioning/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/concepts/device-provisioning/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/concepts/device-provisioning/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/concepts/device-provisioning/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/device-provisioning/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/concepts/connecting-devices/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/concepts/connecting-devices/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/concepts/connecting-devices/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/concepts/connecting-devices/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/connecting-devices/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/concepts/device-notifications/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/concepts/device-notifications/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/concepts/device-notifications/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/device-notifications/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/concepts/command-and-control/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/concepts/command-and-control/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/concepts/command-and-control/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/command-and-control/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/concepts/resource-limits/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/concepts/resource-limits/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/concepts/resource-limits/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/concepts/resource-limits/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/concepts/resource-limits/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/resource-limits/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/concepts/connection-events/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/concepts/connection-events/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/concepts/connection-events/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/concepts/connection-events/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/concepts/connection-events/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/connection-events/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/user-guide/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/user-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/user-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/user-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/user-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/user-guide/device-registry/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/user-guide/device-registry/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/user-guide/device-registry/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/device-registry/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/user-guide/http-adapter/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/user-guide/http-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/user-guide/http-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/user-guide/http-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/user-guide/http-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/http-adapter/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/user-guide/mqtt-adapter/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/user-guide/mqtt-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/user-guide/mqtt-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/user-guide/mqtt-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/user-guide/mqtt-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/mqtt-adapter/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/user-guide/amqp-adapter/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/user-guide/amqp-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/user-guide/amqp-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/user-guide/amqp-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/user-guide/amqp-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/amqp-adapter/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/user-guide/coap-adapter/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/user-guide/coap-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/user-guide/coap-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/coap-adapter/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/user-guide/kura-adapter/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/user-guide/kura-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/user-guide/kura-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/user-guide/kura-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/user-guide/kura-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/kura-adapter/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/user-guide/sigfox-adapter/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/user-guide/sigfox-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/user-guide/sigfox-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/user-guide/sigfox-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/user-guide/sigfox-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/sigfox-adapter/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/user-guide/jmeter_load_tests/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/user-guide/jmeter_load_tests/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/user-guide/jmeter_load_tests/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/user-guide/jmeter_load_tests/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/user-guide/jmeter_load_tests/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/jmeter_load_tests/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/admin-guide/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/admin-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/admin-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/admin-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/admin-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/admin-guide/common-config/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/admin-guide/common-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/admin-guide/common-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/admin-guide/common-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/admin-guide/common-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/common-config/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/admin-guide/auth-server-config/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/admin-guide/auth-server-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/admin-guide/auth-server-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/admin-guide/auth-server-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/admin-guide/auth-server-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/auth-server-config/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/admin-guide/device-registry-config/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/admin-guide/device-registry-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/admin-guide/device-registry-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/device-registry-config/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/admin-guide/device-connection-config/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/admin-guide/device-connection-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/admin-guide/device-connection-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/admin-guide/device-connection-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/admin-guide/device-connection-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/device-connection-config/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/admin-guide/http-adapter-config/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/admin-guide/http-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/admin-guide/http-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/admin-guide/http-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/admin-guide/http-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/http-adapter-config/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-adapter-config/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/admin-guide/amqp-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/admin-guide/amqp-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/admin-guide/amqp-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/admin-guide/amqp-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-adapter-config/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/admin-guide/mqtt-adapter-config/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/admin-guide/mqtt-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/admin-guide/mqtt-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/admin-guide/mqtt-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/admin-guide/mqtt-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/mqtt-adapter-config/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/admin-guide/kura-adapter-config/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/admin-guide/kura-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/admin-guide/kura-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/admin-guide/kura-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/admin-guide/kura-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/kura-adapter-config/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/admin-guide/hono-client-configuration/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/admin-guide/hono-client-configuration/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/admin-guide/hono-client-configuration/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/admin-guide/hono-client-configuration/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/admin-guide/hono-client-configuration/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/hono-client-configuration/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-network-config/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/admin-guide/amqp-network-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/admin-guide/amqp-network-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/admin-guide/amqp-network-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/admin-guide/amqp-network-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-network-config/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/admin-guide/secure_communication/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/admin-guide/secure_communication/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/admin-guide/secure_communication/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/admin-guide/secure_communication/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/admin-guide/secure_communication/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/secure_communication/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/admin-guide/monitoring-tracing-config/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/admin-guide/monitoring-tracing-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/admin-guide/monitoring-tracing-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/admin-guide/monitoring-tracing-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/admin-guide/monitoring-tracing-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/monitoring-tracing-config/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/dev-guide/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/dev-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/dev-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/dev-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/dev-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/dev-guide/building_hono/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/dev-guide/building_hono/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/dev-guide/building_hono/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/dev-guide/building_hono/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/dev-guide/building_hono/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/building_hono/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/dev-guide/amqp_adapter_client/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/dev-guide/amqp_adapter_client/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/dev-guide/amqp_adapter_client/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/amqp_adapter_client/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/dev-guide/java_client_consumer/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/dev-guide/java_client_consumer/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/dev-guide/java_client_consumer/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/dev-guide/java_client_consumer/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/dev-guide/java_client_consumer/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/java_client_consumer/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/dev-guide/custom_http_adapter/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/dev-guide/custom_http_adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/dev-guide/custom_http_adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/dev-guide/custom_http_adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/dev-guide/custom_http_adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/custom_http_adapter/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/api/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/api/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/api/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/api/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/api/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/api/telemetry/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/api/telemetry/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/api/telemetry/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/api/telemetry/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/api/telemetry/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/telemetry/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/api/event/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/api/event/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/api/event/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/api/event/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/api/event/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/event/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/api/command-and-control/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/api/command-and-control/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/api/command-and-control/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/api/command-and-control/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/api/command-and-control/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/command-and-control/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/api/tenant/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/api/tenant/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/api/tenant/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/api/tenant/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/api/tenant/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/tenant/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/api/device-connection/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/api/device-connection/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/api/device-connection/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/api/device-connection/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/api/device-connection/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/device-connection/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/api/device-registration/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/api/device-registration/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/api/device-registration/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/api/device-registration/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/api/device-registration/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/device-registration/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/api/credentials/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/api/credentials/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/api/credentials/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/api/credentials/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/api/credentials/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/credentials/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/api/authentication/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/api/authentication/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/api/authentication/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/api/authentication/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/api/authentication/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/authentication/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/api/management/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/api/management/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/api/management/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/api/management/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/api/management/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/management/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/api/metrics/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/api/metrics/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/api/metrics/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/api/metrics/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/api/metrics/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/metrics/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/deployment/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/deployment/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/deployment/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/deployment/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/deployment/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/deployment/helm-based-deployment/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/deployment/helm-based-deployment/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/deployment/helm-based-deployment/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/deployment/helm-based-deployment/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/deployment/helm-based-deployment/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/helm-based-deployment/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/deployment/openshift/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/deployment/openshift/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/deployment/openshift/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/deployment/openshift/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/deployment/openshift/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/openshift/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/deployment/create-kubernetes-cluster/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/deployment/create-kubernetes-cluster/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/deployment/create-kubernetes-cluster/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/deployment/create-kubernetes-cluster/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/deployment/create-kubernetes-cluster/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/create-kubernetes-cluster/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/deployment/resource-limitation/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/deployment/resource-limitation/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/deployment/resource-limitation/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/deployment/resource-limitation/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/deployment/resource-limitation/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/resource-limitation/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/architecture/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/architecture/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/architecture/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/architecture/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/architecture/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/architecture/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/architecture/component-view/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/architecture/component-view/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/architecture/component-view/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/architecture/component-view/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/architecture/component-view/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/architecture/component-view/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/architecture/auth/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/architecture/auth/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/architecture/auth/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/architecture/auth/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/architecture/auth/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/architecture/auth/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/categories/</loc>
+    <priority>0</priority>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/categories/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/categories/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/categories/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/categories/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/categories/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/1.2/tags/</loc>
+    <priority>0</priority>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/tags/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/tags/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/tags/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/tags/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/tags/"
+                />
+  </url>
+  
+</urlset>
\ No newline at end of file
diff --git a/docs/1.2/tags/index.html b/docs/1.2/tags/index.html
new file mode 100644
index 0000000..13f7488
--- /dev/null
+++ b/docs/1.2/tags/index.html
@@ -0,0 +1,2435 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Tags :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Tags :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Tags :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/tags//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/tags/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/tags/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/tags/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/tags/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/tags/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/tags/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            Tags
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Tags</h1>
+          
+
+        
+
+
+
+
+<footer class=" footline" >
+	
+</footer>
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
diff --git a/docs/1.2/tags/index.xml b/docs/1.2/tags/index.xml
new file mode 100644
index 0000000..2f578dc
--- /dev/null
+++ b/docs/1.2/tags/index.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>Tags on Eclipse Hono&amp;trade; Vers.: 1.2</title>
+    <link>https://www.eclipse.org/hono/docs/1.2/tags/</link>
+    <description>Recent content in Tags on Eclipse Hono&amp;trade; Vers.: 1.2</description>
+    <generator>Hugo -- gohugo.io</generator>
+    <language>en-us</language>
+    
+	<atom:link href="https://www.eclipse.org/hono/docs/1.2/tags/index.xml" rel="self" type="application/rss+xml" />
+    
+    
+  </channel>
+</rss>
\ No newline at end of file
diff --git a/docs/1.2/user-guide/amqp-adapter/index.html b/docs/1.2/user-guide/amqp-adapter/index.html
new file mode 100644
index 0000000..185fdc9
--- /dev/null
+++ b/docs/1.2/user-guide/amqp-adapter/index.html
@@ -0,0 +1,3116 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>AMQP Adapter :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="AMQP Adapter :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="AMQP Adapter :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/user-guide/amqp-adapter//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/user-guide/amqp-adapter/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item active">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/user-guide/amqp-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/amqp-adapter/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/user-guide/amqp-adapter/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/user-guide/amqp-adapter/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/user-guide/amqp-adapter/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/user-guide/amqp-adapter.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/user-guide/'>User Guide</a> > AMQP Adapter
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#device-authentication">Device Authentication</a>
+<ul>
+<li><a href="#sasl-plain-authentication">SASL PLAIN Authentication</a></li>
+<li><a href="#sasl-external-authentication">SASL EXTERNAL Authentication</a></li>
+</ul></li>
+<li><a href="#resource-limit-checks">Resource Limit Checks</a>
+<ul>
+<li><a href="#connection-limits">Connection Limits</a></li>
+<li><a href="#connection-duration-limits">Connection Duration Limits</a></li>
+<li><a href="#message-limits">Message Limits</a></li>
+</ul></li>
+<li><a href="#connection-event">Connection Event</a></li>
+<li><a href="#link-establishment">Link Establishment</a></li>
+<li><a href="#error-handling">Error Handling</a></li>
+<li><a href="#amqp-command-line-client">AMQP Command-line Client</a></li>
+<li><a href="#publishing-telemetry-data">Publishing Telemetry Data</a></li>
+<li><a href="#publish-telemetry-data-authenticated-device">Publish Telemetry Data (authenticated Device)</a></li>
+<li><a href="#publish-telemetry-data-unauthenticated-device">Publish Telemetry Data (unauthenticated Device)</a></li>
+<li><a href="#publish-telemetry-data-authenticated-gateway">Publish Telemetry Data (authenticated Gateway)</a></li>
+<li><a href="#publishing-events">Publishing Events</a></li>
+<li><a href="#publish-an-event-authenticated-device">Publish an Event (authenticated Device)</a></li>
+<li><a href="#publish-an-event-unauthenticated-device">Publish an Event (unauthenticated Device)</a></li>
+<li><a href="#publish-an-event-authenticated-gateway">Publish an Event (authenticated Gateway)</a></li>
+<li><a href="#command-control">Command &amp; Control</a>
+<ul>
+<li><a href="#receiving-commands">Receiving Commands</a></li>
+<li><a href="#sending-a-response-to-a-command">Sending a Response to a Command</a></li>
+<li><a href="#examples">Examples</a></li>
+</ul></li>
+<li><a href="#downstream-meta-data">Downstream Meta Data</a>
+<ul>
+<li><a href="#event-message-time-to-live">Event Message Time-to-live</a></li>
+</ul></li>
+<li><a href="#tenant-specific-configuration">Tenant specific Configuration</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>AMQP Adapter</h1>
+          
+
+        
+
+
+<p>The AMQP protocol adapter allows clients (devices or gateway components) supporting the AMQP 1.0 protocol to publish messages to Eclipse Hono&trade;&rsquo;s Telemetry, Event and Command &amp; Control endpoints.</p>
+
+<h2 id="device-authentication">Device Authentication</h2>
+
+<p>By default, all Hono protocol adapters require clients (devices or gateway components) to authenticate during connection establishment. This is the preferred way for devices to publish data via protocol adapters. The AMQP adapter supports both the <a href="https://tools.ietf.org/html/rfc4616">SASL PLAIN</a> and <a href="https://tools.ietf.org/html/rfc4422">SASL EXTERNAL</a> authentication mechanisms. The former uses a <em>username</em> and <em>password</em> to authenticate to the adapter while the latter uses a client certificate.</p>
+
+<p>In this guide, we will give examples for publishing telemetry data and events for <em>authenticated</em> (using SASL PLAIN) and <em>unauthenticated</em> clients.</p>
+
+<p><strong>NB</strong> The AMQP adapter can be configured to <em>allow</em> unauthenticated devices to connect by setting configuration variable <code>HONO_AMQP_AUTHENTICATION_REQUIRED</code> to <code>false</code>.</p>
+
+<h3 id="sasl-plain-authentication">SASL PLAIN Authentication</h3>
+
+<p>The AMQP adapter supports authenticating clients using a <em>username</em> and <em>password</em>. This means that clients need to provide a <em>username</em> and a <em>password</em> when connecting to the AMQP adapter. If the adapter is configured for multi-tenancy (i.e <code>HONO_AMQP_SINGLE_TENANT</code> is set to <code>false</code>), then the <em>username</em> must match the pattern [<em>auth-id@tenant</em>], e.g. <code>sensor1@DEFAULT_TENANT</code>. Otherwise the <code>DEFAULT_TENANT</code> is assumed and the tenant-id can be omitted from the username.</p>
+
+<p>The adapter verifies the credentials provided by the client against the credentials the <a href="/hono/docs/1.2/admin-guide/common-config/#credentials-service-connection-configuration">configured Credentials service</a> has on record for the client. If the credentials match, then authentication is successful and the client device can proceed to publish messages to Hono.</p>
+
+<p>The examples below refer to devices <code>4711</code> and <code>gw-1</code> of tenant <code>DEFAULT_TENANT</code> using <em>auth-ids</em> <code>sensor1</code> and <code>gw1</code> and corresponding passwords. The example deployment as described in the <a href="/hono/docs/1.2/deployment/">Deployment Guides</a> comes pre-configured with the corresponding entities in its device registry component.</p>
+
+<p><strong>NB</strong> There is a subtle difference between the <em>device identifier</em> (<em>device-id</em>) and the <em>auth-id</em> a device uses for authentication. See <a href="/hono/docs/1.2/concepts/device-identity/">Device Identity</a> for a discussion of the concepts.</p>
+
+<h3 id="sasl-external-authentication">SASL EXTERNAL Authentication</h3>
+
+<p>When a device uses a client certificate for authentication, the TLS handshake is initiated during TCP connection establishment. If no trust anchor is configured for the AMQP adapter, the TLS handshake will succeed only if the certificate has not yet expired. Once the TLS handshake completes and a secure connection is established, the certificate&rsquo;s signature is checked during the SASL handshake. To complete the SASL handshake and authenticate the client, the adapter performs the following steps:</p>
+
+<ul>
+<li>Adapter extracts the client certificate&rsquo;s <em>Issuer DN</em> and uses it to</li>
+<li>us the Tenant service to look up the tenant that the client belongs to. In order for the lookup to succeed, the tenant’s trust anchor needs to be configured by means of registering the <a href="/hono/docs/1.2/api/tenant/#trusted-ca-format">trusted certificate authority</a>.</li>
+<li>If the lookup succeeds, the Tenant service returns the tenant, thus implicitly establishing the tenant that the device belongs to.</li>
+<li>Adapter validates the device’s client certificate using the registered trust anchor for the tenant.</li>
+<li>Finally, adapter authenticates the client certificate using Hono&rsquo;s credentials API. In this step, the adapter uses the client certificate’s <em>Subject DN</em> (as authentication identifier) and <code>x509-cert</code> (for the credentials type) in order to determine the device ID.</li>
+</ul>
+
+<p><strong>NB</strong> The AMQP adapter needs to be configured for TLS in order to support this mechanism.</p>
+
+<h2 id="resource-limit-checks">Resource Limit Checks</h2>
+
+<p>The adapter performs additional checks regarding <a href="/hono/docs/1.2/concepts/resource-limits/">resource limits</a> when a client tries to connect and/or
+send a message to the adapter.</p>
+
+<h3 id="connection-limits">Connection Limits</h3>
+
+<p>The adapter fails the SASL handshake with a client</p>
+
+<ul>
+<li>if the maximum number of simultaneously connected devices for the client&rsquo;s tenant is reached, or</li>
+<li>if the maximum number of connections per protocol adapter instance is reached.</li>
+</ul>
+
+<h3 id="connection-duration-limits">Connection Duration Limits</h3>
+
+<p>The adapter fails the SASL handshake with a client if the
+<a href="/hono/docs/1.2/concepts/resource-limits/#connection-duration-limit">connection duration limit</a> that has been configured
+for the client’s tenant is exceeded.</p>
+
+<h3 id="message-limits">Message Limits</h3>
+
+<p>The adapter</p>
+
+<ul>
+<li>fails the SASL handshake with a client and</li>
+<li>rejects any AMQP 1.0 message containing
+
+<ul>
+<li>telemetry data or an event uploaded by a client</li>
+<li>a command sent by a north bound application</li>
+</ul></li>
+</ul>
+
+<p>if the <a href="/hono/docs/1.2/concepts/resource-limits/">message limit</a> that has been configured for the device’s tenant is exceeded.</p>
+
+<h2 id="connection-event">Connection Event</h2>
+
+<p>The AMQP Adapter can send a <a href="/hono/docs/1.2/api/event/#connection-event">Connection Event</a> once the connection with a device has been successfully established or ended. Note that this requires the <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/#service-configuration"><code>HONO_CONNECTION_EVENTS_PRODUCER</code></a> configuration property to be explicitly set to <code>events</code>.</p>
+
+<h2 id="link-establishment">Link Establishment</h2>
+
+<p>The AMQP adapter supports the <a href="http://docs.oasis-open.org/amqp/anonterm/v1.0/anonterm-v1.0.html">Anonymous Terminus for Message Routing</a> specification
+and requires clients to create a single sender link using the <code>null</code> target address for publishing all types of messages to the AMQP adapter.</p>
+
+<p>Using <em>AT MOST ONCE</em> delivery semantics, the client will not wait for the message to be accepted and settled by the downstream consumer. However, with <em>AT LEAST ONCE</em>, the client sends the message and waits for the message to be delivered to and accepted by the downstream consumer. If the message cannot be delivered due to a failure, the client will be notified.</p>
+
+<p>The client indicates its preferred message delivery mode by means of the <em>snd-settle-mode</em> and <em>rcv-settle-mode</em> fields of its <em>attach</em> frame during link establishment. Clients should use <code>mixed</code> as the <em>snd-settle-mode</em> and <code>first</code> as the <em>rcv-settle-mode</em> in order to be able to use the same link for sending all types of messages using different delivery semantics as described in the following sections.</p>
+
+<h2 id="error-handling">Error Handling</h2>
+
+<p>The AMQP adapter distinguishes between two types of errors when a message is published using <em>at least once</em>:</p>
+
+<ul>
+<li>An error caused by the client side, e.g invalid message address, content-type, adapter disabled for tenant etc.</li>
+<li>An error caused by the server side, e.g no downstream consumers registered, downstream connection loss etc.</li>
+</ul>
+
+<p>For a client side error, the adapter settles the message transfer with the <em>rejected</em> outcome and provides an error description in the corresponding disposition frame. In the case of a server-side error, the adapter settles the message with the <em>released</em> outcome, indicating to the client that the message itself was OK but it cannot be delivered due to a failure beyond the control of the client. In the latter case, a client may attempt to re-send the message unaltered.</p>
+
+<h2 id="amqp-command-line-client">AMQP Command-line Client</h2>
+
+<p>For purposes of demonstrating the usage of the AMQP adapter, the <strong>Hono CLI Module</strong> contains an AMQP command-line client for interacting with the AMQP adapter. The client can be used to send telemetry or events and to receive/respond to command request messages.</p>
+
+<p>The command-line client supports the following parameters (with default values):</p>
+
+<ul>
+<li><code>--spring.profiles.active=amqp-send</code>: Profile for sending telemetry data or events to Hono.</li>
+<li><code>--spring.profiles.active=amqp-command</code>: Profile for receiving and responding to command request messages.</li>
+<li><code>--message.address</code>: The AMQP 1.0 message address (default: <code>telemetry</code>)</li>
+<li><code>--message.payload</code>: The message payload body (default: <code>'{&quot;temp&quot;: 5}'</code>)</li>
+<li><code>--hono.client.host</code>: The host name that the AMQP adapter is running on (default: <code>localhost</code>)</li>
+<li><code>--hono.client.port</code>: The port that the adapter is listening for incoming connections (default: <code>5672</code>)</li>
+</ul>
+
+<p>To run the client to send a telemetry message to Hono, open a terminal and execute the following:</p>
+
+<pre><code class="language-sh"># in directory: hono/cli/target/
+java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=sensor1@DEFAULT_TENANT --hono.client.password=hono-secret
+
+Accepted{}
+</code></pre>
+
+<p>The client prints the outcome of the operation to standard out. The outcome above (<code>Accepted</code>) indicates that the request to upload the data has succeeded.</p>
+
+<p><strong>NB</strong>
+There are two JAR files in the hono/cli/target directory. The JAR to use for the client is the <code>hono-cli-$VERSION-exec.jar</code> and not the <code>hono-cli-$VERSION.jar</code> file. Running the latter will not work and will output the message: <code>no main manifest attribute, in hono-cli-$VERSION.jar</code></p>
+
+<h2 id="publishing-telemetry-data">Publishing Telemetry Data</h2>
+
+<p>The client indicates the delivery mode to use when uploading telemetry messages by means of the <em>settled</em> and <em>rcv-settle-mode</em> properties of the AMQP <em>transfer</em> frame(s) it uses for uploading the message. The AMQP adapter will accept messages using a delivery mode according to the following table:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">settled</th>
+<th align="left">rcv-settle-mode</th>
+<th align="left">Delivery semantics</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>false</code></td>
+<td align="left"><code>first</code></td>
+<td align="left">The adapter will forward the message to the downstream AMQP 1.0 Messaging Network and will forward any AMQP <em>disposition</em> frame received from the AMQP 1.0 Messaging Network to the client <em>as is</em>. It is up to the client&rsquo;s discretion if and how it processes the disposition frame. The adapter will accept any re-delivered message. Sending <em>unsettled</em> messages allows for clients to implement either <em>AT LEAST ONCE</em> or <em>AT MOST ONCE</em> delivery semantics, depending on whether a client actually waits for and considers the disposition frames it receives from the adapter or not. This is the recommended mode for uploading telemetry data.</td>
+</tr>
+
+<tr>
+<td align="left"><code>true</code></td>
+<td align="left"><code>first</code></td>
+<td align="left">The adapter will acknowledge and settle any received message spontaneously before forwarding it to the downstream AMQP 1.0 Messaging Network. The adapter will ignore any AMQP <em>disposition</em> frames it receives from the AMQP 1.0 Messaging Network. Sending <em>pre-settled</em> messages allows for clients to implement <em>AT MOST ONCE</em> delivery semantics only. This is the fastest mode of delivery but has the drawback of less reliable end-to-end flow control and potential loss of messages without notice.</td>
+</tr>
+</tbody>
+</table>
+
+<p>All other combinations are not supported by the adapter and will result in the message being ignored (pre-settled) or rejected (unsettled).</p>
+
+<h2 id="publish-telemetry-data-authenticated-device">Publish Telemetry Data (authenticated Device)</h2>
+
+<p>The AMQP adapter supports publishing of telemetry data to Hono&rsquo;s Telemetry API. Telemetry messages can be published using either <em>AT LEAST ONCE</em> or <em>AT MOST ONCE</em> delivery semantics.</p>
+
+<ul>
+<li>Message Address: <code>telemetry</code> or <code>t</code>
+
+<ul>
+<li>This refers to the <code>to</code> property of the message.</li>
+</ul></li>
+<li>Settlement Mode: <code>presettled</code> (<em>AT MOST ONCE</em>) or <code>unsettled</code> (<em>AT LEAST ONCE</em>)</li>
+<li>Authentication: SASL PLAIN or SASL EXTERNAL</li>
+<li>Message Body:
+
+<ul>
+<li>(optional) Arbitrary payload</li>
+</ul></li>
+<li>Message properties:
+
+<ul>
+<li>(optional) Arbitrary properties (content-type, correlation-id, &hellip;)</li>
+</ul></li>
+<li>Disposition Frames:
+
+<ul>
+<li>Accepted: Message successfully processed by the adapter.</li>
+<li>Released: Message cannot be processed and should be redelivered.</li>
+<li>Rejected: Adapter rejects the message due to one of the following:
+
+<ul>
+<li>(<code>hono:bad-request</code>): Request rejected due to a bad client request.</li>
+<li>(<code>amqp:unauthorized-access</code>): Request rejected because the adapter is disabled for tenant.</li>
+<li>(<code>amqp:precondition-failed</code>): Request does not fulfill certain requirements e.g adapter cannot assert device registration etc.</li>
+<li>(<code>amqp:resource-limit-exceeded</code>): Request rejected because the message limit for the given tenant is exceeded.</li>
+</ul></li>
+</ul></li>
+</ul>
+
+<p>When a device publishes data to the <code>telemetry</code> address, the AMQP adapter automatically determines the device&rsquo;s identity and tenant during the authentication process.</p>
+
+<p><strong>Example</strong></p>
+
+<p>Publish some JSON data for device <code>4711</code>:</p>
+
+<pre><code class="language-sh"># in directory: hono/cli/target/
+java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=sensor1@DEFAULT_TENANT --hono.client.password=hono-secret
+</code></pre>
+
+<p>Notice that we only supplied a new value for the message address, leaving the other default values.</p>
+
+<p>Publish some JSON data for device <code>4711</code> using a client certificate for authentication:</p>
+
+<pre><code class="language-sh"># in directory: hono/cli/target/
+java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.port=5671 --hono.client.certPath=config/hono-demo-certs-jar/device-4711-cert.pem --hono.client.keyPath=config/hono-demo-certs-jar/device-4711-key.pem --hono.client.trustStorePath=config/hono-demo-certs-jar/trusted-certs.pem --hono.client.hostnameVerificationRequired=false
+</code></pre>
+
+<h2 id="publish-telemetry-data-unauthenticated-device">Publish Telemetry Data (unauthenticated Device)</h2>
+
+<ul>
+<li>Message Address: <code>telemetry/${tenant-id}/${device-id}</code> or <code>t/${tenant-id}/${device-id}</code></li>
+<li>Settlement Mode: <code>presettled</code> (AT MOST ONCE) or <code>unsettled</code> (AT LEAST ONCE)</li>
+<li>Authentication: none</li>
+<li>Message Body:
+
+<ul>
+<li>(optional) Arbitrary payload</li>
+</ul></li>
+<li>Message properties:
+
+<ul>
+<li>(optional) Arbitrary properties (content-type, correlation-id, &hellip;)</li>
+</ul></li>
+<li>Disposition Frames:
+
+<ul>
+<li>Accepted: Message successfully processed by the adapter.</li>
+<li>Released: Message cannot be processed and should be redelivered.</li>
+<li>Rejected: Adapter rejects the message due to:
+
+<ul>
+<li>(<code>hono:bad-request</code>): A bad client request (e.g invalid content-type).</li>
+<li>(<code>amqp:unauthorized-access</code>): The adapter is disabled for tenant.</li>
+<li>(<code>amqp:precondition-failed</code>): Request not fulfilling certain requirements.</li>
+<li>(<code>amqp:resource-limit-exceeded</code>): Request rejected because the message limit for the given tenant is exceeded.</li>
+</ul></li>
+</ul></li>
+</ul>
+
+<p>Note how verbose the address is for unauthenticated devices. This address can be used by devices that have not authenticated to the protocol adapter. This requires the <code>HONO_AMQP_AUTHENTICATION_REQUIRED</code> configuration property to be explicitly set to <code>false</code> before starting the protocol adapter.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Publish some JSON data for device <code>4711</code>:</p>
+
+<pre><code class="language-sh"># in directory: hono/cli/target/
+java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --message.address=t/DEFAULT_TENANT/4711
+</code></pre>
+
+<h2 id="publish-telemetry-data-authenticated-gateway">Publish Telemetry Data (authenticated Gateway)</h2>
+
+<p>A device that publishes data on behalf of another device is called a gateway device. The message address is used by <em>gateway</em> components to publish data <em>on behalf of</em> other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like <a href="https://www.sigfox.com">SigFox</a> or <a href="https://lora-alliance.org/">LoRa</a>. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the message address is used to identify the device that the gateway publishes data for.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>A gateway connecting to the adapter using <code>gw@DEFAULT_TENANT</code> as username and <code>gw-secret</code> as password and then publishing some JSON data for device <code>4711</code>:</p>
+
+<pre><code class="language-sh"># in directory: hono/cli/target/
+java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=gw@DEFAULT_TENANT --hono.client.password=gw-secret --message.address=t/DEFAULT_TENANT/4711
+</code></pre>
+
+<p>In this example, we are using message address <code>t/DEFAULT_TENANT/4711</code> which contains the device that the gateway is publishing the message for.</p>
+
+<h2 id="publishing-events">Publishing Events</h2>
+
+<p>The adapter supports <em>AT LEAST ONCE</em> delivery of <em>Event</em> messages only. A client therefore MUST set the <em>settled</em> property to <code>false</code> and the <em>rcv-settle-mode</em> property to <code>first</code> in all <em>transfer</em> frame(s) it uses for uploading events. All other combinations are not supported by the adapter and result in the message being rejected.</p>
+
+<h2 id="publish-an-event-authenticated-device">Publish an Event (authenticated Device)</h2>
+
+<ul>
+<li>Message Address: <code>event</code> or <code>e</code></li>
+<li>Settlement Mode: <code>unsettled</code> (AT LEAST ONCE)</li>
+<li>Authentication: SASL PLAIN or SASL EXTERNAL</li>
+<li>Message Body:
+
+<ul>
+<li>(optional) Arbitrary payload</li>
+</ul></li>
+<li>Message properties:
+
+<ul>
+<li>(optional) Arbitrary properties (content-type, correlation-id, &hellip;)</li>
+</ul></li>
+<li>Disposition Frames:
+
+<ul>
+<li>Accepted: Message successfully processed by the adapter.</li>
+<li>Released: Message cannot be processed and should be redelivered.</li>
+<li>Rejected: Adapter rejects the message due to:
+
+<ul>
+<li>(<code>hono:bad-request</code>): A bad client request (e.g invalid content-type).</li>
+<li>(<code>amqp:unauthorized-access</code>): The adapter is disabled for tenant.</li>
+<li>(<code>amqp:precondition-failed</code>): Request not fulfilling certain requirements.</li>
+<li>(<code>amqp:resource-limit-exceeded</code>): Request rejected because the message limit for the given tenant is exceeded.</li>
+</ul></li>
+</ul></li>
+</ul>
+
+<p>This is the preferred way for devices to publish events. It is available only if the protocol adapter has been configured to require devices to authenticate (which is the default).</p>
+
+<p><strong>Example</strong></p>
+
+<p>Upload a JSON string for device <code>4711</code>:</p>
+
+<pre><code class="language-sh"># in directory: hono/cli/target/
+java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=sensor1@DEFAULT_TENANT --hono.client.password=hono-secret --message.address=event --message.payload='{&quot;alarm&quot;: 1}'
+</code></pre>
+
+<h2 id="publish-an-event-unauthenticated-device">Publish an Event (unauthenticated Device)</h2>
+
+<ul>
+<li>Message Address: <code>event/${tenant-id}/${device-id}</code> or <code>e/${tenant-id}/${device-id}</code></li>
+<li>Settlement Mode: <code>unsettled</code> (AT LEAST ONCE)</li>
+<li>Message Body:
+
+<ul>
+<li>(optional) Arbitrary payload</li>
+</ul></li>
+<li>Message properties:
+
+<ul>
+<li>(optional) Arbitrary properties (content-type, correlation-id, &hellip;)</li>
+</ul></li>
+<li>Disposition Frames:
+
+<ul>
+<li>Accepted: Message successfully processed by the adapter.</li>
+<li>Released: Message cannot be processed and should be redelivered.</li>
+<li>Rejected: Adapter rejects the message due to:
+
+<ul>
+<li>(<code>hono:bad-request</code>): A bad client request (e.g invalid content-type).</li>
+<li>(<code>amqp:unauthorized-access</code>): The adapter is disabled for tenant.</li>
+<li>(<code>amqp:precondition-failed</code>): Request not fulfilling certain requirements.</li>
+<li>(<code>amqp:resource-limit-exceeded</code>): Request rejected because the message limit for the given tenant is exceeded.</li>
+</ul></li>
+</ul></li>
+</ul>
+
+<p>This address format is used by devices that have not authenticated to the protocol adapter. Note that this requires the
+<code>HONO_AMQP_AUTHENTICATION_REQUIRED</code> configuration property to be explicitly set to <code>false</code>.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Publish some JSON data for device <code>4711</code>:</p>
+
+<pre><code class="language-sh"># in directory: hono/cli/target/
+java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --message.address=e/DEFAULT_TENANT/4711 --message.payload='{&quot;alarm&quot;: 1}'
+</code></pre>
+
+<h2 id="publish-an-event-authenticated-gateway">Publish an Event (authenticated Gateway)</h2>
+
+<p><strong>Examples</strong></p>
+
+<p>A gateway connecting to the adapter using <code>gw@DEFAULT_TENANT</code> as username and <code>gw-secret</code> as password and then publishing some JSON data for device <code>4711</code>:</p>
+
+<pre><code class="language-sh"># in directory: hono/cli/target/
+java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=gw@DEFAULT_TENANT --hono.client.password=gw-secret --message.address=e/DEFAULT_TENANT/4711
+</code></pre>
+
+<p>In this example, we are using message address <code>e/DEFAULT_TENANT/4711</code> which contains the device that the gateway is publishing the message for.</p>
+
+<h2 id="command-control">Command &amp; Control</h2>
+
+<p>The AMQP adapter enables devices to receive commands that have been sent by business applications by means of opening a receiver link using a device specific <em>source address</em> as described below. When a device no longer wants to receive commands anymore, it can simply close the link.</p>
+
+<p>When a device has successfully opened a receiver link for commands, the adapter sends an <a href="/hono/docs/1.2/api/event/#empty-notification">empty notification</a> on behalf of the device to the downstream AMQP 1.0 Messaging Network with the <em>ttd</em> header set to <code>-1</code>, indicating that the device will be ready to receive commands until further notice. Analogously, the adapter sends an empty notification with the <em>ttd</em> header set to <code>0</code> when a device closes the link or disconnects.</p>
+
+<p>Devices send their responses to commands by means of sending an AMQP message with properties specific to the command that has been executed. The AMQP adapter accepts responses being published using either <em>at most once</em> (QoS 0) or <em>at least once</em> (QoS 1) delivery semantics. The device must send the command response messages using the same (sender) link that it uses for sending telemetry data and events.</p>
+
+<p>The AMQP adapter checks the configured <a href="/hono/docs/1.2/concepts/resource-limits/">message limit</a> before accepting any command requests and responses. In case of incoming command requests from business applications or the command responses from devices, if the message limit is exceeded, the Adapter rejects the message with the reason <code>amqp:resource-limit-exceeded</code>.</p>
+
+<h3 id="receiving-commands">Receiving Commands</h3>
+
+<p>A device MUST use the following source address in its <em>attach</em> frame to open a link for receiving commands:</p>
+
+<ul>
+<li><code>command</code> (authenticated device)</li>
+<li><code>command</code> (authenticated gateway receiving commands for all devices it acts on behalf of)</li>
+<li><code>command/${tenant}/${device-id}</code> (unauthenticated device)</li>
+<li><code>command/${tenant}/${device-id}</code> (authenticated gateway receiving commands for a specific device it acts on behalf of)</li>
+</ul>
+
+<p>The adapter supports <em>AT LEAST ONCE</em> delivery of command messages only. A client therefore MUST use <code>unsettled</code> for the <em>snd-settle-mode</em> and <code>first</code> for the <em>rcv-settle-mode</em> fields of its <em>attach</em> frame during link establishment. All other combinations are not supported and result in the termination of the link.</p>
+
+<p>Once the link has been established, the adapter will send command messages having the following properties:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>subject</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">Contains the name of the command to be executed.</td>
+</tr>
+
+<tr>
+<td align="left"><em>reply-to</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">Contains the address to which the command response should be sent. This property will be empty for <em>one-way</em> commands.</td>
+</tr>
+
+<tr>
+<td align="left"><em>correlation-id</em></td>
+<td align="center">no</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">This property will be empty for <em>one-way</em> commands, otherwise it will contain the identifier used to correlate the response with the command request.</td>
+</tr>
+
+<tr>
+<td align="left"><em>device_id</em></td>
+<td align="center">no</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">This property will only be set if an authenticated gateway has connected to the adapter. It will contain the id of the device (connected to the gateway) that the command is targeted at.</td>
+</tr>
+</tbody>
+</table>
+
+<p>Authenticated gateways will receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway. Corresponding devices have to be configured so that they can be used with a gateway. See <a href="/hono/docs/1.2/admin-guide/device-registry-config/#configuring-gateway-devices">Configuring Gateway Devices</a> for details.</p>
+
+<p>A gateway can open a link to receive commands for <em>all</em> devices it acts on behalf of. An authenticated gateway can also open a receiver link for commands targeted at a <em>specific</em> device.</p>
+
+<p>When processing an incoming command message, the protocol adapter will give precedence to a device-specific command consumer matching the command target device, whether it was created by a gateway or by the device itself. If multiple such consumer links have been created, by multiple gateways and/or from the device itself, the gateway or device that last created the consumer link will get the command messages.</p>
+
+<p>If no device-specific command consumer exists for a command target device, but <em>one</em> gateway, that may act on behalf of the device, has opened a generic, device-unspecific command consumer link, then the command message is sent to that gateway.</p>
+
+<p>If <em>multiple</em> gateways have opened a generic command consumer link, the protocol adapter may have to decide to which gateway a particular command message will be sent to.
+In case the command target device has already sent a telemetry, event or command response message via a gateway and if that gateway has opened a command consumer link, that gateway will be chosen. Otherwise one gateway that may act on behalf of the command target device and that has opened a command consumer link will be chosen randomly to receive the command message.</p>
+
+<h3 id="sending-a-response-to-a-command">Sending a Response to a Command</h3>
+
+<p>A device only needs to respond to commands that contain a <em>reply-to</em> address and a <em>correlation-id</em>. However, if the application expects a response, then devices must publish a response back to the application. Devices may use the same anonymous sender link for this purpose that they also use for sending telemetry data and events.</p>
+
+<p>The adapter supports <em>AT LEAST ONCE</em> delivery of command response messages only. A client therefore MUST set the <em>settled</em> property to <code>true</code> and the <em>rcv-settle-mode</em> property to <code>first</code> in all <em>transfer</em> frame(s) it uses for uploading command responses. All other combinations are not supported by the adapter and result in the message being rejected.</p>
+
+<p>The table below provides an overview of the properties that must be set on a command response message:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="center">Mandatory</th>
+<th align="left">Location</th>
+<th align="left">Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>to</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST contain the value of the <em>reply-to</em> property of the command request message.</td>
+</tr>
+
+<tr>
+<td align="left"><em>correlation-id</em></td>
+<td align="center">yes</td>
+<td align="left"><em>properties</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">MUST contain the value of the <em>correlation-id</em> property of the command request message.</td>
+</tr>
+
+<tr>
+<td align="left"><em>status</em></td>
+<td align="center">yes</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>integer</em></td>
+<td align="left">MUST contain a status code indicating the outcome of processing the command at the device (see <a href="/hono/docs/1.2/api/command-and-control/">Command &amp; Control API</a> for details).</td>
+</tr>
+</tbody>
+</table>
+
+<h3 id="examples">Examples</h3>
+
+<p>The AMQP adapter client can be used to simulate a device which receives commands and sends responses back to the application. The command line client is used to simulate an application sending commands to devices and receiving command responses from devices.</p>
+
+<p>Start the AMQP adapter client, as follows:</p>
+
+<pre><code class="language-sh"># in directory: hono/cli/target/
+java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-command --hono.client.username=sensor1@DEFAULT_TENANT --hono.client.password=hono-secret
+</code></pre>
+
+<p>After successfully starting the client, a message indicating that the device is ready to receive commands will be printed to standard output. The device is now waiting to receive commands from applications.</p>
+
+<p>To send a command to the device, open a new terminal shell and start the command application, as shown below:</p>
+
+<pre><code class="language-sh"># in directory: hono/cli/
+java -jar target/hono-cli-*-exec.jar --hono.client.host=localhost --hono.client.username=consumer@HONO --hono.client.password=verysecret --spring.profiles.active=command,ssl
+</code></pre>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Note</h4>
+    <div>Change into the <code>cli</code> directory before running the command above to start the command application. If you change into the target directory (i.e <code>cli/target</code>), then the client will not be able to locate to certificate needed to connect to the messaging network.</div>
+</div>
+
+
+<p>Once the command application starts successfully, enter a command name, payload and content-type of the command to send to the device.</p>
+
+<pre><code class="language-plaintext">&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt; Enter name of command for device [DEFAULT_TENANT:4711] (prefix with 'ow:' to send one-way command):
+setBrightness
+&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt; Enter command payload:
+some-payload
+&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt; Enter content type:
+text/plain
+</code></pre>
+
+<p>After sending the command, the device (i.e. AMQP command client) will print out the command name and payload that it receives and automatically sends a command response to the application.</p>
+
+<pre><code class="language-plaintext">Received Command Message : [Command name: setBrightness, Command payload: some-payload]
+Command response sent [outcome: Accepted{}]
+</code></pre>
+
+<h2 id="downstream-meta-data">Downstream Meta Data</h2>
+
+<p>The adapter includes the following meta data in the application properties of messages being sent downstream:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="left">Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>device_id</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The identifier of the device that the message originates from.</td>
+</tr>
+
+<tr>
+<td align="left"><em>orig_adapter</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">Contains the adapter&rsquo;s <em>type name</em> which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The AMQP adapter&rsquo;s type name is <code>hono-amqp</code>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>orig_address</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">Contains the AMQP <em>target address</em> that the device has used to send the data.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The adapter also considers <em>defaults</em> registered for the device at either the <a href="/hono/docs/1.2/api/tenant/#tenant-information-format">tenant</a> or the <a href="/hono/docs/1.2/api/device-registration/#assert-device-registration">device level</a>. The values of the default properties are determined as follows:</p>
+
+<ol>
+<li>If the message already contains a non-empty property of the same name, the value if unchanged.</li>
+<li>Otherwise, if a default property of the same name is defined in the device&rsquo;s registration information, that value is used.</li>
+<li>Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.</li>
+</ol>
+
+<p>Note that of the standard AMQP 1.0 message properties only the <em>content-type</em> and <em>ttl</em> can be set this way to a default value.</p>
+
+<h3 id="event-message-time-to-live">Event Message Time-to-live</h3>
+
+<p>Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers.
+In most cases the AMQP Messaging Network can be configured with a maximum <em>time-to-live</em> to apply to the events so that the events will be removed
+from the persistent store if no consumer has attached to receive the event before the message expires.</p>
+
+<p>In order to support environments where the AMQP Messaging Network cannot be configured accordingly, the protocol adapter supports setting a
+downstream event message&rsquo;s <em>ttl</em> property based on the default <em>ttl</em> and <em>max-ttl</em> values configured for a tenant/device as described in the <a href="/hono/docs/1.2/api/tenant/#resource-limits-configuration-format">Tenant API</a>.</p>
+
+<h2 id="tenant-specific-configuration">Tenant specific Configuration</h2>
+
+<p>The adapter uses the <a href="/hono/docs/1.2/api/tenant/#get-tenant-information">Tenant API</a> to retrieve <em>tenant specific configuration</em> for adapter type <code>hono-amqp</code>.
+The following properties are (currently) supported:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="left">Type</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>enabled</em></td>
+<td align="left"><em>boolean</em></td>
+<td align="left"><code>true</code></td>
+<td align="left">If set to <code>false</code> the adapter will reject all data from devices belonging to the tenant and respond with a <code>amqp:unauthorized-access</code> as the error condition value for rejecting the message.</td>
+</tr>
+</tbody>
+</table>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/user-guide/coap-adapter/index.html b/docs/1.2/user-guide/coap-adapter/index.html
new file mode 100644
index 0000000..51fd322
--- /dev/null
+++ b/docs/1.2/user-guide/coap-adapter/index.html
@@ -0,0 +1,3422 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>CoAP Adapter :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="CoAP Adapter :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="CoAP Adapter :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/user-guide/coap-adapter//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/user-guide/coap-adapter/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item active">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/user-guide/coap-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/coap-adapter/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/user-guide/coap-adapter/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/user-guide/coap-adapter.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/user-guide/'>User Guide</a> > CoAP Adapter
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#device-authentication">Device Authentication</a>
+<ul>
+<li><a href="#psk">PSK</a></li>
+</ul></li>
+<li><a href="#message-limits">Message Limits</a></li>
+<li><a href="#coap-content-format-codes">CoAP Content Format Codes</a></li>
+<li><a href="#publish-telemetry-data-authenticated-device">Publish Telemetry Data (authenticated Device)</a></li>
+<li><a href="#publish-telemetry-data-unauthenticated-device">Publish Telemetry Data (unauthenticated Device)</a></li>
+<li><a href="#publish-telemetry-data-authenticated-gateway">Publish Telemetry Data (authenticated Gateway)</a></li>
+<li><a href="#publish-an-event-authenticated-device">Publish an Event (authenticated Device)</a></li>
+<li><a href="#publish-an-event-unauthenticated-device">Publish an Event (unauthenticated Device)</a></li>
+<li><a href="#publish-an-event-authenticated-gateway">Publish an Event (authenticated Gateway)</a></li>
+<li><a href="#command-control">Command &amp; Control</a>
+<ul>
+<li><a href="#commands-handled-by-gateways">Commands handled by gateways</a></li>
+<li><a href="#sending-a-response-to-a-command-authenticated-device">Sending a Response to a Command (authenticated Device)</a></li>
+<li><a href="#sending-a-response-to-a-command-unauthenticated-device">Sending a Response to a Command (unauthenticated Device)</a></li>
+<li><a href="#sending-a-response-to-a-command-authenticated-gateway">Sending a Response to a Command (authenticated Gateway)</a></li>
+</ul></li>
+<li><a href="#downstream-meta-data">Downstream Meta Data</a>
+<ul>
+<li><a href="#event-message-time-to-live">Event Message Time-to-live</a></li>
+</ul></li>
+<li><a href="#tenant-specific-configuration">Tenant specific Configuration</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>CoAP Adapter</h1>
+          
+
+        
+
+
+<p>The CoAP protocol adapter exposes <a href="https://tools.ietf.org/html/rfc7252">CoAP</a> based endpoints for Eclipse Hono&trade;&rsquo;s south bound Telemetry, Event and Command &amp; Control APIs.</p>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Experimental</h4>
+    <div>The CoAP adapter has not yet reached the level of maturity of the other standard adapters. In particular, the resources implemented by the adapter might
+still be subject to change.</div>
+</div>
+
+
+<h2 id="device-authentication">Device Authentication</h2>
+
+<p>The CoAP adapter by default requires clients (devices or gateway components) to authenticate during connection establishment.
+The adapter (currently) only supports <a href="https://tools.ietf.org/html/rfc4279">PSK</a> as part of a DTLS handshake for that purpose.
+Additional variants mentioned in <a href="https://tools.ietf.org/html/rfc7252#section-9">Securing CoAP</a> might be added in the future.</p>
+
+<p>The adapter tries to authenticate the device using these mechanisms in the following order</p>
+
+<h3 id="psk">PSK</h3>
+
+<p>The <em>identity</em> provided in the ClientKeyExchange must have the form <em>auth-id@tenant</em>, e.g. <code>sensor1@DEFAULT_TENANT</code>.
+The adapter performs the handshake using the credentials the <a href="/hono/docs/1.2/admin-guide/common-config/#credentials-service-connection-configuration">configured Credentials service</a>
+has on record for the client. The adapter uses the Credentials API&rsquo;s <em>get</em> operation to retrieve the credentials on record
+with the <em>tenant</em> and <em>auth-id</em> provided by the device in the <em>identity</em> and <code>psk</code> as the <em>type</em> of secret as query parameters.</p>
+
+<p>The examples below refer to devices <code>4711</code> and <code>gw-1</code> of tenant <code>DEFAULT_TENANT</code> using <em>auth-ids</em> <code>sensor1</code> and <code>gw1</code> and
+corresponding secrets. The example deployment as described in the <a href="/hono/docs/1.2/deployment/">Deployment Guides</a> comes pre-configured
+with the corresponding entities in its device registry component.
+Please refer to the <a href="/hono/docs/1.2/api/credentials/#standard-credential-types">Credentials API</a> for details regarding the different
+types of secrets.</p>
+
+<p><strong>NB</strong> There is a subtle difference between the <em>device identifier</em> (<em>device-id</em>) and the <em>auth-id</em> a device uses for authentication. See <a href="/hono/docs/1.2/concepts/device-identity/">Device Identity</a> for a discussion of the concepts.</p>
+
+<h2 id="message-limits">Message Limits</h2>
+
+<p>Before accepting any telemetry or event or command messages, the CoAP adapter verifies that the configured <a href="/hono/docs/1.2/concepts/resource-limits/#messages-limit">message limit</a> is not exceeded.
+For CoAP currently only the messages limit is verified, the connections limit is not available. If the limit is exceeded then the incoming message is discarded with the status code <code>429 Too Many Requests</code>.</p>
+
+<h2 id="coap-content-format-codes">CoAP Content Format Codes</h2>
+
+<p>CoAP doesn&rsquo;t use a textual identifier for content types. Instead numbers are used, which are maintained by the <a href="https://www.iana.org/">IANA</a>.
+The <a href="https://www.iana.org/assignments/core-parameters/core-parameters.xhtml#content-formats">IANA - CoAP Content Formats</a> page lists all
+(currently) registered codes and the corresponding media types.</p>
+
+<h2 id="publish-telemetry-data-authenticated-device">Publish Telemetry Data (authenticated Device)</h2>
+
+<p>The device is authenticated using PSK.</p>
+
+<ul>
+<li>URI: <code>/telemetry</code></li>
+<li>Method: <code>POST</code></li>
+<li>Type:
+
+<ul>
+<li><code>CON</code>: <em>at least once</em> delivery semantics</li>
+<li><code>NON</code>: <em>at most once</em> delivery semantics</li>
+</ul></li>
+<li>Request Options:
+
+<ul>
+<li>(optional) <code>content-format</code>: The type of payload contained in the request body. Required, if request contains payload.</li>
+</ul></li>
+<li>Query Parameters:
+
+<ul>
+<li>(optional) <code>hono-ttd</code>: The number of seconds the device will wait for the response.</li>
+<li>(optional) <code>empty</code>: Marks the request as an <a href="/hono/docs/1.2/api/event/#empty-notification">empty notification</a>.</li>
+</ul></li>
+<li>Request Body:
+
+<ul>
+<li>(optional) Arbitrary payload encoded according to the given content type. Maybe empty, if <code>URI-query: empty</code> is provided.</li>
+</ul></li>
+<li>Response Options:
+
+<ul>
+<li>(optional) <code>content-format</code>: A media type describing the semantics and format of payload contained in the response body.
+This option will only be present if the response contains a command to be executed by the device which requires input data.
+Note that this option will be empty if the media type contained in the command (AMQP) message&rsquo;s <em>content-type</em> property cannot
+be mapped to one of the registered CoAP <em>content-format</em> codes.</li>
+<li>(optional) <code>location-query</code>: The <code>hono-command</code> query parameter contains the name of the command to execute.
+This option will only be present if the response contains a command to be executed by the device.</li>
+<li>(optional) <code>location-path</code>: The location path is <code>command</code> for one-way-commands and
+<code>command_response/&lt;command-request-id&gt;</code> for commands expecting  a response.
+In the latter case, the <em>location-path</em> option contains exactly the URI-path that the device must use when sending its
+response to the command.
+This option will only be present if the response contains a command to be executed by the device.</li>
+</ul></li>
+<li>Response Body:
+
+<ul>
+<li>(optional) Arbitrary data serving as input to a command to be executed by the device.</li>
+<li>(optional) Error details, if status code is &gt;= 4.00.</li>
+</ul></li>
+<li>Response Codes:
+
+<ul>
+<li>2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for the device to execute.
+Note that if the message type is <code>NON</code> (<em>at most once</em> semantics), this status code does <strong>not</strong> mean that the message has been
+delivered to any potential consumer (yet). However, if the message type is <code>CON</code> (<em>at least once</em> semantics), then the adapter waits
+for the message to be delivered and accepted by a downstream consumer before responding with this status code.</li>
+<li>4.00 (Bad Request): The request cannot be processed. Possible reasons include:
+
+<ul>
+<li>the request body is empty and the <em>URI-query</em> option doesn&rsquo;t contain the <code>empty</code> parameter</li>
+</ul></li>
+<li>4.03 (Forbidden): The request cannot be processed because the device&rsquo;s registration status cannot be asserted.
+Possible reasons for this include:
+
+<ul>
+<li>The given tenant is not allowed to use this protocol adapter.</li>
+</ul></li>
+<li>4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist.</li>
+<li>4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size.</li>
+<li>4.29 (Too Many Requests): The request cannot be processed because the tenant&rsquo;s message limit for the current period is exceeded.</li>
+<li>5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant
+connected to Hono.</li>
+</ul></li>
+</ul>
+
+<p>This is the preferred way for devices to publish telemetry data. It is available only if the protocol adapter is configured to require
+devices to authenticate (which is the default).</p>
+
+<p><strong>Examples</strong></p>
+
+<p>The examples provided below make use of the <em>coap-client</em> command line tool which is part of the <a href="https://libcoap.net/">libcoap project</a>.
+Precompiled packages should be available for different Linux variants.</p>
+
+<p>Publish some JSON data for device <code>4711</code> using default message type <code>CON</code> (<em>at least once</em>):</p>
+
+<pre><code class="language-sh">coap-client -u sensor1@DEFAULT_TENANT -k hono-secret -m POST coaps://hono.eclipseprojects.io/telemetry -t application/json -e '{&quot;temp&quot;: 5}'
+</code></pre>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Note</h4>
+    <div><em>coap-client</em> only reports error response-codes, so the expected 2.04 response code will not be printed to the terminal.</div>
+</div>
+
+
+<p>Publish some JSON data for device <code>4711</code> using message type <code>NON</code> (<em>at most once</em>):</p>
+
+<pre><code class="language-sh">coap-client -u sensor1@DEFAULT_TENANT -k hono-secret -N -m POST coaps://hono.eclipseprojects.io/telemetry -t application/json -e '{&quot;temp&quot;: 5}'
+</code></pre>
+
+<p>Publish some JSON data for device <code>4711</code>, indicating that the device will wait for 10 seconds to receive the response:</p>
+
+<pre><code class="language-sh">coap-client -u sensor1@DEFAULT_TENANT -k hono-secret -m POST coaps://hono.eclipseprojects.io/telemetry?hono-ttd=10 -t application/json -e '{&quot;temp&quot;: 5}'
+
+{
+  &quot;brightness&quot;: 87
+}
+</code></pre>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Note</h4>
+    <div>In the example above the response actually contains payload that should be used as input to a command to be executed by the device.
+This is just for illustrative purposes. You will usually get an empty response because there is no downstream application attached which could
+send any commands to the device.</div>
+</div>
+
+
+<h2 id="publish-telemetry-data-unauthenticated-device">Publish Telemetry Data (unauthenticated Device)</h2>
+
+<ul>
+<li>URI: <code>/telemetry/${tenantId}/${deviceId}</code></li>
+<li>Method: <code>PUT</code></li>
+<li>Type:
+
+<ul>
+<li><code>CON</code>: <em>at least once</em> delivery semantics</li>
+<li><code>NON</code>: <em>at most once</em> delivery semantics</li>
+</ul></li>
+<li>Request Options:
+
+<ul>
+<li>(optional) <code>content-format</code>: The type of payload contained in the request body. Required, if request contains payload.</li>
+</ul></li>
+<li>Query Parameters:
+
+<ul>
+<li>(optional) <code>hono-ttd</code>: The number of seconds the device will wait for the response.</li>
+<li>(optional) <code>empty</code>: Marks the request as an <a href="/hono/docs/1.2/api/event/#empty-notification">empty notification</a>.</li>
+</ul></li>
+<li>Request Body:
+
+<ul>
+<li>(optional) Arbitrary payload encoded according to the given content type. Maybe empty, if <code>URI-query: empty</code> is provided.</li>
+</ul></li>
+<li>Response Options:
+
+<ul>
+<li>(optional) <code>content-format</code>: A media type describing the semantics and format of payload contained in the response body.
+This option will only be present if the response contains a command to be executed by the device which requires input data.
+Note that this option will be empty if the media type contained in the command (AMQP) message&rsquo;s <em>content-type</em> property cannot
+be mapped to one of the registered CoAP <em>content-format</em> codes.</li>
+<li>(optional) <code>location-query</code>: The <code>hono-command</code> query parameter contains the name of the command to execute.
+This option will only be present if the response contains a command to be executed by the device.</li>
+<li>(optional) <code>location-path</code>: The location path is <code>command</code> for one-way-commands and
+<code>command_response/&lt;command-request-id&gt;</code> for commands expecting  a response.
+In the latter case, the <em>location-path</em> option contains exactly the URI-path that the device must use when sending its
+response to the command.
+This option will only be present if the response contains a command to be executed by the device.</li>
+</ul></li>
+<li>Response Body:
+
+<ul>
+<li>(optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content).</li>
+<li>(optional) Error details, if status code is &gt;= 4.00.</li>
+</ul></li>
+<li>Response Codes:
+
+<ul>
+<li>2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for the device to execute.
+Note that if the message type is <code>NON</code> (<em>at most once</em> semantics), this status code does <strong>not</strong> mean that the message has been
+delivered to any potential consumer (yet). However, if the message type is <code>CON</code> (<em>at least once</em> semantics), then the adapter waits
+for the message to be delivered and accepted by a downstream consumer before responding with this status code.</li>
+<li>4.00 (Bad Request): The request cannot be processed. Possible reasons include:
+
+<ul>
+<li>the request body is empty and the <em>URI-query</em> option doesn&rsquo;t contain the <code>empty</code> parameter</li>
+</ul></li>
+<li>4.03 (Forbidden): The request cannot be processed because the device&rsquo;s registration status cannot be asserted.
+Possible reasons for this include:
+
+<ul>
+<li>The given tenant is not allowed to use this protocol adapter.</li>
+<li>The given device does not belong to the given tenant.</li>
+</ul></li>
+<li>4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist.</li>
+<li>4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size.</li>
+<li>4.29 (Too Many Requests): The request cannot be processed because the tenant&rsquo;s message limit for the current period is exceeded.</li>
+<li>5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant
+connected to Hono.</li>
+</ul></li>
+</ul>
+
+<p>This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the
+<code>HONO_COAP_AUTHENTICATION_REQUIRED</code> configuration property to be explicitly set to <code>false</code>.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Publish some JSON data for device <code>4711</code> using default message type <code>CON</code> (<em>at least once</em>):</p>
+
+<pre><code class="language-sh">coap-client -m PUT coap://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4711 -t application/json -e '{&quot;temp&quot;: 5}'
+</code></pre>
+
+<p>Publish some JSON data for device <code>4711</code> using message type <code>NON</code> (<em>at most once</em>):</p>
+
+<pre><code class="language-sh">coap-client -N -m PUT coap://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4711 -t application/json -e '{&quot;temp&quot;: 5}'
+</code></pre>
+
+<p>Publish some JSON data for device <code>4711</code>, indicating that the device will wait for 10 seconds to receive the response:</p>
+
+<pre><code class="language-sh">coap-client -m PUT coap://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4711?hono-ttd=10 -t application/json -e '{&quot;temp&quot;: 5}'
+
+{
+  &quot;brightness&quot;: 87
+}
+</code></pre>
+
+<h2 id="publish-telemetry-data-authenticated-gateway">Publish Telemetry Data (authenticated Gateway)</h2>
+
+<ul>
+<li>URI: <code>/telemetry/${tenantId}/${deviceId}</code></li>
+<li>Method: <code>PUT</code></li>
+<li>Type:
+
+<ul>
+<li><code>CON</code>: <em>at least once</em> delivery semantics</li>
+<li><code>NON</code>: <em>at most once</em> delivery semantics</li>
+</ul></li>
+<li>Request Options:
+
+<ul>
+<li>(optional) <code>content-format</code>: The type of payload contained in the request body. Required, if request contains payload.</li>
+</ul></li>
+<li>Query Parameters:
+
+<ul>
+<li>(optional) <code>hono-ttd</code>: The number of seconds the device will wait for the response.</li>
+<li>(optional) <code>empty</code>: Marks the request as an <a href="/hono/docs/1.2/api/event/#empty-notification">empty notification</a>.</li>
+</ul></li>
+<li>Request Body:
+
+<ul>
+<li>(optional) Arbitrary payload encoded according to the given content type. Maybe empty, if <code>URI-query: empty</code> is provided.</li>
+</ul></li>
+<li>Response Options:
+
+<ul>
+<li>(optional) <code>content-format</code>: A media type describing the semantics and format of payload contained in the response body.
+This option will only be present if the response contains a command to be executed by the device which requires input data.
+Note that this option will be empty if the media type contained in the command (AMQP) message&rsquo;s <em>content-type</em> property cannot
+be mapped to one of the registered CoAP <em>content-format</em> codes.</li>
+<li>(optional) <code>location-query</code>: The <code>hono-command</code> query parameter contains the name of the command to execute.
+This option will only be present if the response contains a command to be executed by the device.</li>
+<li>(optional) <code>location-path</code>: The location path is <code>command/${tenantId}/${deviceId}</code> for one-way-commands and
+<code>command_response/${tenantId}/${deviceId}/&lt;command-request-id&gt;</code> for commands expecting  a response.
+In the latter case, the <em>location-path</em> option contains exactly the URI-path that the device must use when sending its
+response to the command. Note that in both cases the <code>${tenantId}/${deviceId}</code> path segments indicate the device that
+the command is targeted at.
+This option will only be present if the response contains a command to be executed by the device.</li>
+</ul></li>
+<li>Response Body:
+
+<ul>
+<li>(optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content).</li>
+<li>(optional) Error details, if status code is &gt;= 4.00.</li>
+</ul></li>
+<li>Response Codes:
+
+<ul>
+<li>2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for a device to execute.
+Note that if the message type is <code>NON</code> (<em>at most once</em> semantics), this status code does <strong>not</strong> mean that the message has been
+delivered to any potential consumer (yet). However, if the message type is <code>CON</code> (<em>at least once</em> semantics), then the adapter waits
+for the message to be delivered and accepted by a downstream consumer before responding with this status code.</li>
+<li>4.00 (Bad Request): The request cannot be processed. Possible reasons include:
+
+<ul>
+<li>the request body is empty and the <em>URI-query</em> option doesn&rsquo;t contain the <code>empty</code> parameter</li>
+</ul></li>
+<li>4.03 (Forbidden): The request cannot be processed because the device&rsquo;s registration status cannot be asserted.
+Possible reasons for this include:
+
+<ul>
+<li>The tenant that the gateway belongs to is not allowed to use this protocol adapter.</li>
+<li>The device belongs to another tenant than the gateway.</li>
+<li>The gateway is not authorized to act <em>on behalf of</em> the device.</li>
+<li>The gateway associated with the device is not registered or disabled.</li>
+</ul></li>
+<li>4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist.</li>
+<li>4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size.</li>
+<li>4.29 (Too Many Requests): The request cannot be processed because the tenant&rsquo;s message limit for the current period is exceeded.</li>
+<li>5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant
+connected to Hono.</li>
+</ul></li>
+</ul>
+
+<p>This resource can be used by <em>gateway</em> components to publish data <em>on behalf of</em> other devices which do not connect to a protocol adapter
+directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like <a href="https://www.sigfox.com">SigFox</a>
+or <a href="https://lora-alliance.org/">LoRa</a>. In this case the credentials provided by the gateway during connection establishment with the
+protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway
+publishes data for.</p>
+
+<p>The protocol adapter checks the gateway&rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a <em>registration assertion</em>
+for the device from the <a href="/hono/docs/1.2/admin-guide/common-config/#device-registration-service-connection-configuration">configured Device Registration service</a>.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Publish some JSON data for device <code>4712</code> using default message type <code>CON</code> (<em>at least once</em>):</p>
+
+<pre><code class="language-sh">coap-client -u gw@DEFAULT_TENANT -k gw-secret -m PUT coaps://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4712 -t application/json -e '{&quot;temp&quot;: 5}'
+</code></pre>
+
+<p>Publish some JSON data for device <code>4712</code> using message type <code>NON</code> (<em>at most once</em>):</p>
+
+<pre><code class="language-sh">coap-client -u gw@DEFAULT_TENANT -k gw-secret -N -m PUT coaps://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4712 -t application/json -e '{&quot;temp&quot;: 5}'
+</code></pre>
+
+<p>Publish some JSON data for device <code>4712</code>, indicating that the gateway will wait for 10 seconds to receive the response:</p>
+
+<pre><code class="language-sh">coap-client -u gw@DEFAULT_TENANT -k gw-secret -m PUT coaps://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4712?hono-ttd=10 -t application/json -e '{&quot;temp&quot;: 5}'
+
+{
+  &quot;brightness&quot;: 87
+}
+</code></pre>
+
+<p><strong>NB</strong> The examples above assume that a gateway device has been registered with <code>psk</code> credentials with <em>auth-id</em> <code>gw</code> and secret <code>gw-secret</code>
+which is authorized to publish data <em>on behalf of</em> device <code>4712</code>.</p>
+
+<h2 id="publish-an-event-authenticated-device">Publish an Event (authenticated Device)</h2>
+
+<p>The device is authenticated using PSK.</p>
+
+<ul>
+<li>URI: <code>/event</code></li>
+<li>Method: <code>POST</code></li>
+<li>Type:<code>CON</code></li>
+<li>Request Options:
+
+<ul>
+<li>(optional) <code>content-format</code>: The type of payload contained in the request body. Required, if request contains payload.</li>
+</ul></li>
+<li>Query Parameters:
+
+<ul>
+<li>(optional) <code>hono-ttd</code>: The number of seconds the device will wait for the response.</li>
+<li>(optional) <code>empty</code>: Marks the request as an <a href="/hono/docs/1.2/api/event/#empty-notification">empty notification</a>.</li>
+</ul></li>
+<li>Request Body:
+
+<ul>
+<li>(optional) Arbitrary payload encoded according to the given content type. Maybe empty, if <code>URI-query: empty</code> is provided.</li>
+</ul></li>
+<li>Response Options:
+
+<ul>
+<li>(optional) <code>content-format</code>: A media type describing the semantics and format of payload contained in the response body.
+This option will only be present if the response contains a command to be executed by the device which requires input data.
+Note that this option will be empty if the media type contained in the command (AMQP) message&rsquo;s <em>content-type</em> property cannot
+be mapped to one of the registered CoAP <em>content-format</em> codes.</li>
+<li>(optional) <code>location-query</code>: The <code>hono-command</code> query parameter contains the name of the command to execute.
+This option will only be present if the response contains a command to be executed by the device.</li>
+<li>(optional) <code>location-path</code>: The location path is <code>command</code> for one-way-commands and
+<code>command_response/&lt;command-request-id&gt;</code> for commands expecting  a response.
+In the latter case, the <em>location-path</em> option contains exactly the URI-path that the device must use when sending its
+response to the command.
+This option will only be present if the response contains a command to be executed by the device.</li>
+</ul></li>
+<li>Response Body:
+
+<ul>
+<li>(optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content).</li>
+<li>(optional) Error details, if status code is &gt;= 4.00.</li>
+</ul></li>
+<li>Response Codes:
+
+<ul>
+<li>2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for the device to execute.
+Note that if the message type is <code>NON</code> (<em>at most once</em> semantics), this status code does <strong>not</strong> mean that the message has been
+delivered to any potential consumer (yet). However, if the message type is <code>CON</code> (<em>at least once</em> semantics), then the adapter waits
+for the message to be delivered and accepted by a downstream consumer before responding with this status code.</li>
+<li>4.00 (Bad Request): The request cannot be processed. Possible reasons include:
+
+<ul>
+<li>the request body is empty and the <em>URI-query</em> option doesn&rsquo;t contain the <code>empty</code> parameter</li>
+</ul></li>
+<li>4.03 (Forbidden): The request cannot be processed because the device&rsquo;s registration status cannot be asserted.
+Possible reasons for this include:
+
+<ul>
+<li>The given tenant is not allowed to use this protocol adapter.</li>
+</ul></li>
+<li>4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist.</li>
+<li>4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size.</li>
+<li>4.29 (Too Many Requests): The request cannot be processed because the tenant&rsquo;s message limit for the current period is exceeded.</li>
+<li>5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant
+connected to Hono.</li>
+</ul></li>
+</ul>
+
+<p>This is the preferred way for devices to publish events. It is available only if the protocol adapter is configured to require
+devices to authenticate (which is the default).</p>
+
+<p><strong>Examples</strong></p>
+
+<p>The examples provided below make use of the <em>coap-client</em> command line tool which is part of the <a href="https://libcoap.net/">libcoap project</a>.
+Precompiled packages should be available for different Linux variants.</p>
+
+<p>Publish some JSON data for device <code>4711</code> using default message type <code>CON</code> (<em>at least once</em>):</p>
+
+<pre><code class="language-sh">coap-client -u sensor1@DEFAULT_TENANT -k hono-secret -m POST coaps://hono.eclipseprojects.io/event -t application/json -e '{&quot;temp&quot;: 5}'
+</code></pre>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Note</h4>
+    <div><em>coap-client</em> only reports error response-codes, so the expected 2.04 response code will not be printed to the terminal.</div>
+</div>
+
+
+<p>Publish some JSON data for device <code>4711</code>, indicating that the device will wait for 10 seconds to receive the response:</p>
+
+<pre><code class="language-sh">coap-client -u sensor1@DEFAULT_TENANT -k hono-secret -m POST coaps://hono.eclipseprojects.io/event?hono-ttd=10 -t application/json -e '{&quot;temp&quot;: 5}'
+
+{
+  &quot;brightness&quot;: 87
+}
+</code></pre>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Note</h4>
+    <div>In the example above the response actually contains payload that should be used as input to a command to be executed by the device.
+This is just for illustrative purposes. You will usually get an empty response because there is no downstream application attached which could
+send any commands to the device.</div>
+</div>
+
+
+<h2 id="publish-an-event-unauthenticated-device">Publish an Event (unauthenticated Device)</h2>
+
+<ul>
+<li>URI: <code>/event/${tenantId}/${deviceId}</code></li>
+<li>Method: <code>PUT</code></li>
+<li>Type:<code>CON</code></li>
+<li>Request Options:
+
+<ul>
+<li>(optional) <code>content-format</code>: The type of payload contained in the request body. Required, if request contains payload.</li>
+</ul></li>
+<li>Query Parameters:
+
+<ul>
+<li>(optional) <code>hono-ttd</code>: The number of seconds the device will wait for the response.</li>
+<li>(optional) <code>empty</code>: Marks the request as an <a href="/hono/docs/1.2/api/event/#empty-notification">empty notification</a>.</li>
+</ul></li>
+<li>Request Body:
+
+<ul>
+<li>(optional) Arbitrary payload encoded according to the given content type. Maybe empty, if <code>URI-query: empty</code> is provided.</li>
+</ul></li>
+<li>Response Options:
+
+<ul>
+<li>(optional) <code>content-format</code>: A media type describing the semantics and format of payload contained in the response body.
+This option will only be present if the response contains a command to be executed by the device which requires input data.
+Note that this option will be empty if the media type contained in the command (AMQP) message&rsquo;s <em>content-type</em> property cannot
+be mapped to one of the registered CoAP <em>content-format</em> codes.</li>
+<li>(optional) <code>location-query</code>: The <code>hono-command</code> query parameter contains the name of the command to execute.
+This option will only be present if the response contains a command to be executed by the device.</li>
+<li>(optional) <code>location-path</code>: The location path is <code>command</code> for one-way-commands and
+<code>command_response/&lt;command-request-id&gt;</code> for commands expecting  a response.
+In the latter case, the <em>location-path</em> option contains exactly the URI-path that the device must use when sending its
+response to the command.
+This option will only be present if the response contains a command to be executed by the device.</li>
+</ul></li>
+<li>Response Body:
+
+<ul>
+<li>(optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content).</li>
+<li>(optional) Error details, if status code is &gt;= 4.00.</li>
+</ul></li>
+<li>Response Codes:
+
+<ul>
+<li>2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for the device to execute.
+Note that if the message type is <code>NON</code> (<em>at most once</em> semantics), this status code does <strong>not</strong> mean that the message has been
+delivered to any potential consumer (yet). However, if the message type is <code>CON</code> (<em>at least once</em> semantics), then the adapter waits
+for the message to be delivered and accepted by a downstream consumer before responding with this status code.</li>
+<li>4.00 (Bad Request): The request cannot be processed. Possible reasons include:
+
+<ul>
+<li>the request body is empty and the <em>URI-query</em> option doesn&rsquo;t contain the <code>empty</code> parameter</li>
+</ul></li>
+<li>4.03 (Forbidden): The request cannot be processed because the device&rsquo;s registration status cannot be asserted.
+Possible reasons for this include:
+
+<ul>
+<li>The given tenant is not allowed to use this protocol adapter.</li>
+<li>The given device does not belong to the given tenant.</li>
+</ul></li>
+<li>4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist.</li>
+<li>4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size.</li>
+<li>4.29 (Too Many Requests): The request cannot be processed because the tenant&rsquo;s message limit for the current period is exceeded.</li>
+<li>5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant
+connected to Hono.</li>
+</ul></li>
+</ul>
+
+<p>This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the
+<code>HONO_COAP_AUTHENTICATION_REQUIRED</code> configuration property to be explicitly set to <code>false</code>.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Publish some JSON data for device <code>4711</code> using default message type <code>CON</code> (<em>at least once</em>):</p>
+
+<pre><code class="language-sh">coap-client -m PUT coap://hono.eclipseprojects.io/event/DEFAULT_TENANT/4711 -t application/json -e '{&quot;temp&quot;: 5}'
+</code></pre>
+
+<p>Publish some JSON data for device <code>4711</code>, indicating that the device will wait for 10 seconds to receive the response:</p>
+
+<pre><code class="language-sh">coap-client -m PUT coap://hono.eclipseprojects.io/event/DEFAULT_TENANT/4711?hono-ttd=10 -t application/json -e '{&quot;temp&quot;: 5}'
+
+{
+  &quot;brightness&quot;: 87
+}
+</code></pre>
+
+<h2 id="publish-an-event-authenticated-gateway">Publish an Event (authenticated Gateway)</h2>
+
+<ul>
+<li>URI: <code>/event/${tenantId}/${deviceId}</code></li>
+<li>Method: <code>PUT</code></li>
+<li>Type:<code>CON</code></li>
+<li>Request Options:
+
+<ul>
+<li>(optional) <code>content-format</code>: The type of payload contained in the request body. Required, if request contains payload.</li>
+</ul></li>
+<li>Query Parameters:
+
+<ul>
+<li>(optional) <code>hono-ttd</code>: The number of seconds the device will wait for the response.</li>
+<li>(optional) <code>empty</code>: Marks the request as an <a href="/hono/docs/1.2/api/event/#empty-notification">empty notification</a>.</li>
+</ul></li>
+<li>Request Body:
+
+<ul>
+<li>(optional) Arbitrary payload encoded according to the given content type. Maybe empty, if <code>URI-query: empty</code> is provided.</li>
+</ul></li>
+<li>Response Options:
+
+<ul>
+<li>(optional) <code>content-format</code>: A media type describing the semantics and format of payload contained in the response body.
+This option will only be present if the response contains a command to be executed by the device which requires input data.
+Note that this option will be empty if the media type contained in the command (AMQP) message&rsquo;s <em>content-type</em> property cannot
+be mapped to one of the registered CoAP <em>content-format</em> codes.</li>
+<li>(optional) <code>location-query</code>: The <code>hono-command</code> query parameter contains the name of the command to execute.
+This option will only be present if the response contains a command to be executed by the device.</li>
+<li>(optional) <code>location-path</code>: The location path is <code>command/${tenantId}/${deviceId}</code> for one-way-commands and
+<code>command_response/${tenantId}/${deviceId}/&lt;command-request-id&gt;</code> for commands expecting  a response.
+In the latter case, the <em>location-path</em> option contains exactly the URI-path that the device must use when sending its
+response to the command. Note that in both cases the <code>${tenantId}/${deviceId}</code> path segments indicate the device that
+the command is targeted at.
+This option will only be present if the response contains a command to be executed by the device.</li>
+</ul></li>
+<li>Response Body:
+
+<ul>
+<li>(optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content).</li>
+<li>(optional) Error details, if status code is &gt;= 4.00.</li>
+</ul></li>
+<li>Response Codes:
+
+<ul>
+<li>2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for a device to execute.
+Note that if the message type is <code>NON</code> (<em>at most once</em> semantics), this status code does <strong>not</strong> mean that the message has been
+delivered to any potential consumer (yet). However, if the message type is <code>CON</code> (<em>at least once</em> semantics), then the adapter waits
+for the message to be delivered and accepted by a downstream consumer before responding with this status code.</li>
+<li>4.00 (Bad Request): The request cannot be processed. Possible reasons include:
+
+<ul>
+<li>the request body is empty and the <em>URI-query</em> option doesn&rsquo;t contain the <code>empty</code> parameter</li>
+</ul></li>
+<li>4.03 (Forbidden): The request cannot be processed because the device&rsquo;s registration status cannot be asserted.
+Possible reasons for this include:
+
+<ul>
+<li>The tenant that the gateway belongs to is not allowed to use this protocol adapter.</li>
+<li>The device belongs to another tenant than the gateway.</li>
+<li>The gateway is not authorized to act <em>on behalf of</em> the device.</li>
+<li>The gateway associated with the device is not registered or disabled.</li>
+</ul></li>
+<li>4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist.</li>
+<li>4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size.</li>
+<li>4.29 (Too Many Requests): The request cannot be processed because the tenant&rsquo;s message limit for the current period is exceeded.</li>
+<li>5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant
+connected to Hono.</li>
+</ul></li>
+</ul>
+
+<p>This resource can be used by <em>gateway</em> components to publish data <em>on behalf of</em> other devices which do not connect to a protocol adapter
+directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like <a href="https://www.sigfox.com">SigFox</a>
+or <a href="https://lora-alliance.org/">LoRa</a>. In this case the credentials provided by the gateway during connection establishment with the
+protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway
+publishes data for.</p>
+
+<p>The protocol adapter checks the gateway&rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a <em>registration assertion</em>
+for the device from the <a href="/hono/docs/1.2/admin-guide/common-config/#device-registration-service-connection-configuration">configured Device Registration service</a>.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Publish some JSON data for device <code>4712</code> using default message type <code>CON</code> (<em>at least once</em>):</p>
+
+<pre><code class="language-sh">coap-client -u gw@DEFAULT_TENANT -k gw-secret -m PUT coaps://hono.eclipseprojects.io/event/DEFAULT_TENANT/4712 -t application/json -e '{&quot;temp&quot;: 5}'
+</code></pre>
+
+<p>Publish some JSON data for device <code>4712</code>, indicating that the gateway will wait for 10 seconds to receive the response:</p>
+
+<pre><code class="language-sh">coap-client -u gw@DEFAULT_TENANT -k gw-secret -m PUT coaps://hono.eclipseprojects.io/event/DEFAULT_TENANT/4712?hono-ttd=10 -t application/json -e '{&quot;temp&quot;: 5}'
+
+{
+  &quot;brightness&quot;: 87
+}
+</code></pre>
+
+<p><strong>NB</strong> The examples above assume that a gateway device has been registered with <code>psk</code> credentials with <em>auth-id</em> <code>gw</code> and secret <code>gw-secret</code>
+which is authorized to publish data <em>on behalf of</em> device <code>4712</code>.</p>
+
+<h2 id="command-control">Command &amp; Control</h2>
+
+<p>The CoAP adapter enables devices to receive commands that have been sent by business applications. Commands are delivered to the device by means of a response message. That means a device first has to send a request, indicating how long it will wait for the response. That request can either be a telemetry or event message, with a <code>hono-ttd</code> query parameter (<code>ttd</code> for <code>time till disconnect</code>) specifying the number of seconds the device will wait for the response. The business application can react on that message by sending a command message, targeted at the device. The CoAP adapter will then send the command message as part of the response message to the device.</p>
+
+<h3 id="commands-handled-by-gateways">Commands handled by gateways</h3>
+
+<p>Authenticated gateways will receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway. Corresponding devices have to be configured so that they can be used with a gateway. See <a href="/hono/docs/1.2/admin-guide/device-registry-config/#configuring-gateway-devices">Configuring Gateway Devices</a> for details.</p>
+
+<p>A gateway can send a request with the <code>hono-ttd</code> query parameter on the <code>/event</code> or <code>/telemetry</code> URI, indicating its readiness to receive a command for <em>any</em> device it acts on behalf of. Note that in this case, the business application will be notified with the gateway id in the <code>device_id</code> property of the downstream message.</p>
+
+<p>An authenticated gateway can also indicate its readiness to receive a command targeted at a <em>specific</em> device. For that, the <code>/event/${tenantId}/${deviceId}</code> or <code>/telemetry/${tenantId}/${deviceId}</code> URI is to be used, containing the id of the device to receive a command for. The business application will receive a notification with that device id.</p>
+
+<p>If there are multiple concurrent requests with a <code>hono-ttd</code> query parameter, sent by the command target device and/or one or more of its potential gateways, the CoAP adapter will choose the device or gateway to send the command to as follows:</p>
+
+<ul>
+<li>A request done by the command target device or by a gateway specifically done for that device, has precedence. If there are multiple, concurrent such requests, the last one will get the command message (if received) in its response. Note that the other requests won&rsquo;t be answered with a command message in their response event if the business application sent multiple command messages. That means commands for a single device can only be requested sequentially, not in parallel.</li>
+<li>If the above doesn&rsquo;t apply, a single <code>hono-ttd</code> request on the <code>/event</code> or <code>/telemetry</code> URI, sent by a gateway that the command target device is configured for, will get the command message in its response.</li>
+<li>If there are multiple, concurrent such requests by different gateways, all configured for the command target device, the request by the gateway will be chosen, through which the target device has last sent a telemetry or event message. If the target device hasn&rsquo;t sent a message yet and it is thereby unknown via which gateway the device communicates, then one of the requests will be chosen randomly to set the command in its response.</li>
+</ul>
+
+<h3 id="sending-a-response-to-a-command-authenticated-device">Sending a Response to a Command (authenticated Device)</h3>
+
+<p>The device is authenticated using PSK.</p>
+
+<ul>
+<li>URI: <code>/command_response/${commandRequestId}</code></li>
+<li>Method: <code>POST</code></li>
+<li>Type: <code>CON</code></li>
+<li>Request Options:
+
+<ul>
+<li>(optional) <code>content-type</code>: A media type describing the semantics and format of the payload contained in the request body.
+This option must be set if the result of processing the command on the device is non-empty. In this case the result data is
+contained in the request body.</li>
+</ul></li>
+<li>Query Parameters:
+
+<ul>
+<li>(required) <code>hono-cmd-status</code>: An HTTP status code indicating the outcome of processing the command.</li>
+</ul></li>
+<li>Request Body:
+
+<ul>
+<li>(optional) Arbitrary data representing the result of processing the command on the device.</li>
+</ul></li>
+<li>Response Codes:
+
+<ul>
+<li>2.04 (Changed): The response has been successfully delivered to the application that has sent the command.</li>
+<li>4.00 (Bad Request): The request cannot be processed because the command status or command request ID are missing/malformed.</li>
+<li>4.03 (Forbidden): The request cannot be processed because the device&rsquo;s registration status cannot be asserted.
+Possible reasons for this include:
+
+<ul>
+<li>The given tenant is not allowed to use this protocol adapter.</li>
+</ul></li>
+<li>4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist.</li>
+<li>4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size.</li>
+<li>4.29 (Too Many Requests): The request cannot be processed because the tenant&rsquo;s message limit for the current period is exceeded.</li>
+<li>5.03 (Service Unavailable): The request cannot be processed. Possible reasons for this include:
+
+<ul>
+<li>There is no application listening for a reply to the given <em>commandRequestId</em>.</li>
+<li>The application has already given up on waiting for a response.</li>
+</ul></li>
+</ul></li>
+</ul>
+
+<p>This is the preferred way for devices to respond to commands. It is available only if the protocol adapter is configured to require devices to
+authenticate (which is the default).</p>
+
+<p><strong>Example</strong></p>
+
+<p>Send a response to a previously received command with the command-request-id <code>req-id-uuid</code> for device <code>4711</code>:</p>
+
+<pre><code class="language-sh">coap-client -u sensor1@DEFAULT_TENANT -k hono-secret coaps://hono.eclipseprojects.io/command_response/req-id-uuid?hono-cmd-status=200
+</code></pre>
+
+<h3 id="sending-a-response-to-a-command-unauthenticated-device">Sending a Response to a Command (unauthenticated Device)</h3>
+
+<ul>
+<li>URI: <code>/command_response/${tenantId}/${deviceId}/${commandRequestId}</code></li>
+<li>Method: <code>PUT</code></li>
+<li>Type: <code>CON</code></li>
+<li>Request Options:
+
+<ul>
+<li>(optional) <code>content-type</code>: A media type describing the semantics and format of the payload contained in the request body.
+This option must be set if the result of processing the command on the device is non-empty. In this case the result data is
+contained in the request body.</li>
+</ul></li>
+<li>Query Parameters:
+
+<ul>
+<li>(required) <code>hono-cmd-status</code>: An HTTP status code indicating the outcome of processing the command.</li>
+</ul></li>
+<li>Request Body:
+
+<ul>
+<li>(optional) Arbitrary data representing the result of processing the command on the device.</li>
+</ul></li>
+<li>Response Codes:
+
+<ul>
+<li>2.04 (Changed): The response has been successfully delivered to the application that has sent the command.</li>
+<li>4.00 (Bad Request): The request cannot be processed because the command status or command request ID are missing/malformed.</li>
+<li>4.03 (Forbidden): The request cannot be processed because the device&rsquo;s registration status cannot be asserted.
+Possible reasons for this include:
+
+<ul>
+<li>The given tenant is not allowed to use this protocol adapter.</li>
+<li>The given device does not belong to the given tenant.</li>
+</ul></li>
+<li>4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist.</li>
+<li>4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size.</li>
+<li>4.29 (Too Many Requests): The request cannot be processed because the tenant&rsquo;s message limit for the current period is exceeded.</li>
+<li>5.03 (Service Unavailable): The request cannot be processed. Possible reasons for this include:
+
+<ul>
+<li>There is no application listening for a reply to the given <em>commandRequestId</em>.</li>
+<li>The application has already given up on waiting for a response.</li>
+</ul></li>
+</ul></li>
+</ul>
+
+<p>This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the
+<code>HONO_HTTP_AUTHENTICATION_REQUIRED</code> configuration property to be explicitly set to <code>false</code>.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Send a response to a previously received command with the command-request-id <code>req-id-uuid</code> for the unauthenticated device <code>4711</code>:</p>
+
+<pre><code class="language-sh">coap-client -u sensor1@DEFAULT_TENANT -k hono-secret coaps://hono.eclipseprojects.io/command_response/DEFAULT_TENANT/4711/req-id-uuid?hono-cmd-status=200 -e '{&quot;brightness-changed&quot;: true}'
+</code></pre>
+
+<h3 id="sending-a-response-to-a-command-authenticated-gateway">Sending a Response to a Command (authenticated Gateway)</h3>
+
+<ul>
+<li>URI: <code>/command_response/${tenantId}/${deviceId}/${commandRequestId}</code></li>
+<li>Method: <code>PUT</code></li>
+<li>Type: <code>CON</code></li>
+<li>Request Options:
+
+<ul>
+<li>(optional) <code>content-type</code>: A media type describing the semantics and format of the payload contained in the request body.
+This option must be set if the result of processing the command on the device is non-empty. In this case the result data is
+contained in the request body.</li>
+</ul></li>
+<li>Query Parameters:
+
+<ul>
+<li>(required) <code>hono-cmd-status</code>: An HTTP status code indicating the outcome of processing the command.</li>
+</ul></li>
+<li>Request Body:
+
+<ul>
+<li>(optional) Arbitrary data representing the result of processing the command on the device.</li>
+</ul></li>
+<li>Response Codes:
+
+<ul>
+<li>2.04 (Changed): The response has been successfully delivered to the application that has sent the command.</li>
+<li>4.00 (Bad Request): The request cannot be processed because the command status or command request ID are missing/malformed.</li>
+<li>4.03 (Forbidden): The request cannot be processed because the device&rsquo;s registration status cannot be asserted.
+Possible reasons for this include:
+
+<ul>
+<li>The given tenant is not allowed to use this protocol adapter.</li>
+<li>The given device does not belong to the given tenant.</li>
+<li>The gateway is not authorized to act <em>on behalf of</em> the device.</li>
+<li>The gateway associated with the device is not registered or disabled.</li>
+</ul></li>
+<li>4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist.</li>
+<li>4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size.</li>
+<li>4.29 (Too Many Requests): The request cannot be processed because the tenant&rsquo;s message limit for the current period is exceeded.</li>
+<li>5.03 (Service Unavailable): The request cannot be processed. Possible reasons for this include:
+
+<ul>
+<li>There is no application listening for a reply to the given <em>commandRequestId</em>.</li>
+<li>The application has already given up on waiting for a response.</li>
+</ul></li>
+</ul></li>
+</ul>
+
+<p>This resource can be used by <em>gateway</em> components to send the response to a command <em>on behalf of</em> other devices which do not connect
+to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like
+<a href="https://www.sigfox.com">SigFox</a> or <a href="https://lora-alliance.org/">LoRa</a>. In this case the credentials provided by the gateway during
+connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used
+to identify the device that the gateway publishes data for.</p>
+
+<p>The protocol adapter checks the gateway&rsquo;s authority to send responses to a command on behalf of the device implicitly by means of
+retrieving a <em>registration assertion</em> for the device from the <a href="/hono/docs/1.2/admin-guide/common-config/#device-registration-service-connection-configuration">configured Device Registration service</a>.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Send a response to a previously received command with the command-request-id <code>req-id-uuid</code> for device <code>4712</code>:</p>
+
+<pre><code class="language-sh">coap-client -u gw@DEFAULT_TENANT -k gw-secret coaps://hono.eclipseprojects.io/command_response/DEFAULT_TENANT/4712/req-id-uuid?hono-cmd-status=200 -e '{&quot;brightness-changed&quot;: true}'
+</code></pre>
+
+<p><strong>NB</strong> The example above assumes that a gateway device has been registered with <code>psk</code> credentials with <em>auth-id</em> <code>gw</code> and secret <code>gw-secret</code> which is
+authorized to publish data <em>on behalf of</em> device <code>4712</code>.</p>
+
+<h2 id="downstream-meta-data">Downstream Meta Data</h2>
+
+<p>The adapter includes the following meta data in the application properties of messages being sent downstream:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="left">Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>device_id</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The identifier of the device that the message originates from.</td>
+</tr>
+
+<tr>
+<td align="left"><em>orig_adapter</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">Contains the adapter&rsquo;s <em>type name</em> which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The CoAP adapter&rsquo;s type name is <code>hono-coap</code>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>orig_address</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">Contains the (relative) URI that the device has originally posted the data to.</td>
+</tr>
+
+<tr>
+<td align="left"><em>ttd</em></td>
+<td align="left"><em>integer</em></td>
+<td align="left">Contains the effective number of seconds that the device will wait for a response. This property is only set if the request contains the <code>hono-ttd</code> <em>URI-query</em> option.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The adapter also considers <em>defaults</em> registered for the device at either the <a href="/hono/docs/1.2/api/tenant/#tenant-information-format">tenant</a> or the <a href="/hono/docs/1.2/api/device-registration/#assert-device-registration">device level</a>. The values of the default properties are determined as follows:</p>
+
+<ol>
+<li>If the message already contains a non-empty property of the same name, the value if unchanged.</li>
+<li>Otherwise, if a default property of the same name is defined in the device&rsquo;s registration information, that value is used.</li>
+<li>Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.</li>
+</ol>
+
+<p>Note that of the standard AMQP 1.0 message properties only the <em>content-type</em> and <em>ttl</em> can be set this way to a default value.</p>
+
+<h3 id="event-message-time-to-live">Event Message Time-to-live</h3>
+
+<p>Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers.
+In most cases the AMQP Messaging Network can be configured with a maximum <em>time-to-live</em> to apply to the events so that the events will be removed
+from the persistent store if no consumer has attached to receive the event before the message expires.</p>
+
+<p>In order to support environments where the AMQP Messaging Network cannot be configured accordingly, the protocol adapter supports setting a
+downstream event message&rsquo;s <em>ttl</em> property based on the <em>hono-ttl</em> property set as a query parameter in the event requests by the devices.
+Also the default <em>ttl</em> and <em>max-ttl</em> values can be configured for a tenant/device as described in the <a href="/hono/docs/1.2/api/tenant/#resource-limits-configuration-format">Tenant API</a>.</p>
+
+<h2 id="tenant-specific-configuration">Tenant specific Configuration</h2>
+
+<p>The adapter uses the <a href="/hono/docs/1.2/api/tenant/#get-tenant-information">Tenant API</a> to retrieve <em>tenant specific configuration</em> for adapter type <code>hono-coap</code>.
+The following properties are (currently) supported:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="left">Type</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>enabled</em></td>
+<td align="left"><em>boolean</em></td>
+<td align="left"><code>true</code></td>
+<td align="left">If set to <code>false</code> the adapter will reject all data from devices belonging to the tenant.</td>
+</tr>
+
+<tr>
+<td align="left"><em>max-ttd</em></td>
+<td align="left"><em>integer</em></td>
+<td align="left"><code>60</code></td>
+<td align="left">Defines a tenant specific upper limit for the <em>time until disconnect</em> property that devices may include in requests for uploading telemetry data or events. Please refer to the <a href="/hono/docs/1.2/concepts/command-and-control/">Command &amp; Control concept page</a> for a discussion of this parameter&rsquo;s purpose and usage.<br>This property can be set for the <code>hono-coap</code> adapter type as an <em>extension</em> property in the adapter section of the tenant configuration.<br>If it is not set, then the default value of <code>60</code> seconds is used.</td>
+</tr>
+</tbody>
+</table>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/user-guide/device-registry/index.html b/docs/1.2/user-guide/device-registry/index.html
similarity index 79%
rename from docs/user-guide/device-registry/index.html
rename to docs/1.2/user-guide/device-registry/index.html
index 5ff6a71..2b35abd 100644
--- a/docs/user-guide/device-registry/index.html
+++ b/docs/1.2/user-guide/device-registry/index.html
@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="stable" class="js csstransforms3d">
+<html lang="1.2" class="js csstransforms3d">
   <head>
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
@@ -18,22 +18,22 @@
 <meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
 <meta name="theme-color" content="#ffffff">
 
-    <title>Device Registry :: Eclipse Hono&trade;</title>
+    <title>Device Registry :: Eclipse Hono&trade; Vers.: 1.2</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -53,18 +53,18 @@
 
 <meta name="twitter:card" content="summary_large_image">
 <meta name="twitter:site" content="@EclipseHono">
-<meta name="twitter:title" content="Device Registry :: Eclipse Hono&amp;trade;">
+<meta name="twitter:title" content="Device Registry :: Eclipse Hono&amp;trade; Vers.: 1.2">
 <meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
 <meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
 
 
-<meta property="og:title" content="Device Registry :: Eclipse Hono&amp;trade;" />
+<meta property="og:title" content="Device Registry :: Eclipse Hono&amp;trade; Vers.: 1.2" />
 <meta property="og:type" content="website" />
-<meta property="og:url" content="https://www.eclipse.org/hono/docs/user-guide/device-registry//" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/user-guide/device-registry//" />
 <meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
 
   </head>
-  <body class="" data-url="/hono/docs/user-guide/device-registry/">
+  <body class="" data-url="/hono/docs/1.2/user-guide/device-registry/">
     <nav id="sidebar" class="">
 
 
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
-        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -106,12 +106,12 @@
  
   
     
-    <li data-nav-id="/hono/docs/concepts/" title="Concepts" class="dd-item 
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
         
         
         
         ">
-      <a href="/hono/docs/concepts/">
+      <a href="/hono/docs/1.2/concepts/">
           <i class="far fa-lightbulb"></i> Concepts
           
       </a>
@@ -131,8 +131,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/concepts/device-identity/" title="Device Identity" class="dd-item ">
-        <a href="/hono/docs/concepts/device-identity/">
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
         Device Identity
         
         </a>
@@ -150,8 +150,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
-        <a href="/hono/docs/concepts/tenancy/">
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
         Multi-Tenancy
         
         </a>
@@ -169,8 +169,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
-        <a href="/hono/docs/concepts/device-provisioning/">
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
         Device Provisioning
         
         </a>
@@ -188,8 +188,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
-        <a href="/hono/docs/concepts/connecting-devices/">
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
         Connecting Devices
         
         </a>
@@ -207,8 +207,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
-        <a href="/hono/docs/concepts/device-notifications/">
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
         Device Notifications
         
         </a>
@@ -226,8 +226,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
-        <a href="/hono/docs/concepts/command-and-control/">
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
         Command &amp; Control
         
         </a>
@@ -245,8 +245,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/concepts/resource-limits/" title="Resource limits" class="dd-item ">
-        <a href="/hono/docs/concepts/resource-limits/">
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
         Resource limits
         
         </a>
@@ -264,8 +264,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/concepts/connection-events/" title="Connection Events" class="dd-item ">
-        <a href="/hono/docs/concepts/connection-events/">
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
         Connection Events
         
         </a>
@@ -290,12 +290,12 @@
  
   
     
-    <li data-nav-id="/hono/docs/user-guide/" title="User Guide" class="dd-item 
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
         parent
         
         
         ">
-      <a href="/hono/docs/user-guide/">
+      <a href="/hono/docs/1.2/user-guide/">
           <i class="fas fa-book-reader"></i> User Guide
           
       </a>
@@ -315,8 +315,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item active">
-        <a href="/hono/docs/user-guide/device-registry/">
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item active">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
         Device Registry
         
         </a>
@@ -334,8 +334,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
-        <a href="/hono/docs/user-guide/http-adapter/">
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
         HTTP Adapter
         
         </a>
@@ -353,8 +353,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
-        <a href="/hono/docs/user-guide/mqtt-adapter/">
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
         MQTT Adapter
         
         </a>
@@ -372,8 +372,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
-        <a href="/hono/docs/user-guide/amqp-adapter/">
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
         AMQP Adapter
         
         </a>
@@ -391,8 +391,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
-        <a href="/hono/docs/user-guide/coap-adapter/">
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
         CoAP Adapter
         
         </a>
@@ -410,8 +410,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
-        <a href="/hono/docs/user-guide/kura-adapter/">
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
         Kura Adapter
         
         </a>
@@ -429,8 +429,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
-        <a href="/hono/docs/user-guide/sigfox-adapter/">
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
         Sigfox Adapter
         
         </a>
@@ -448,8 +448,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
-        <a href="/hono/docs/user-guide/jmeter_load_tests/">
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
         Load Tests with JMeter
         
         </a>
@@ -474,12 +474,12 @@
  
   
     
-    <li data-nav-id="/hono/docs/admin-guide/" title="Admin Guide" class="dd-item 
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
         
         
         
         ">
-      <a href="/hono/docs/admin-guide/">
+      <a href="/hono/docs/1.2/admin-guide/">
           <i class="fas fa-sliders-h"></i> Admin Guide
           
       </a>
@@ -499,8 +499,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/common-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
         Common Configuration
         
         </a>
@@ -518,8 +518,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/auth-server-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
         Auth Server Configuration
         
         </a>
@@ -537,8 +537,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
         Device Registry Configuration
         
         </a>
@@ -556,8 +556,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-connection-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
         Device Connection Service Configuration
         
         </a>
@@ -575,8 +575,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/http-adapter-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
         HTTP Adapter Configuration
         
         </a>
@@ -594,8 +594,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/amqp-adapter-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
         
         </a>
@@ -613,8 +613,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
         MQTT Adapter Configuration
         
         </a>
@@ -632,8 +632,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/kura-adapter-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
         Kura Adapter Configuration
         
         </a>
@@ -651,8 +651,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/hono-client-configuration/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
         Hono Client Configuration
         
         </a>
@@ -670,8 +670,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/amqp-network-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
         AMQP 1.0 Messaging Network Configuration
         
         </a>
@@ -689,8 +689,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
-        <a href="/hono/docs/admin-guide/secure_communication/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
         Secure Communication
         
         </a>
@@ -708,8 +708,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
-        <a href="/hono/docs/admin-guide/monitoring-tracing-config/">
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
         Monitoring &amp; Tracing
         
         </a>
@@ -734,12 +734,12 @@
  
   
     
-    <li data-nav-id="/hono/docs/dev-guide/" title="Developer Guide" class="dd-item 
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
         
         
         
         ">
-      <a href="/hono/docs/dev-guide/">
+      <a href="/hono/docs/1.2/dev-guide/">
           <i class="fas fa-tools"></i> Developer Guide
           
       </a>
@@ -759,8 +759,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
-        <a href="/hono/docs/dev-guide/building_hono/">
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
         Building from Source
         
         </a>
@@ -778,8 +778,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
-        <a href="/hono/docs/dev-guide/amqp_adapter_client/">
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
         AMQP Adapter Client for Java
         
         </a>
@@ -797,8 +797,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
-        <a href="/hono/docs/dev-guide/java_client_consumer/">
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
         Consuming Messages from Java
         
         </a>
@@ -816,8 +816,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
-        <a href="/hono/docs/dev-guide/custom_http_adapter/">
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
         Implement a Custom Hono HTTP Protocol Adapter
         
         </a>
@@ -842,12 +842,12 @@
  
   
     
-    <li data-nav-id="/hono/docs/api/" title="API" class="dd-item 
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
         
         
         
         ">
-      <a href="/hono/docs/api/">
+      <a href="/hono/docs/1.2/api/">
           &nbsp;<i class='fas fa-plug'></i>&nbsp;API
           
       </a>
@@ -867,8 +867,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
-        <a href="/hono/docs/api/telemetry/">
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
         Telemetry API
         
         </a>
@@ -886,8 +886,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/event/" title="Event API Specification" class="dd-item ">
-        <a href="/hono/docs/api/event/">
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
         Event API
         
         </a>
@@ -905,8 +905,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
-        <a href="/hono/docs/api/command-and-control/">
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
         Command &amp; Control API
         
         </a>
@@ -924,8 +924,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/tenant/" title="Tenant API Specification" class="dd-item ">
-        <a href="/hono/docs/api/tenant/">
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
         Tenant API
         
         </a>
@@ -943,8 +943,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
-        <a href="/hono/docs/api/device-connection/">
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
         Device Connection API
         
         </a>
@@ -962,8 +962,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
-        <a href="/hono/docs/api/device-registration/">
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
         Device Registration API
         
         </a>
@@ -981,8 +981,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/credentials/" title="Credentials API Specification" class="dd-item ">
-        <a href="/hono/docs/api/credentials/">
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
         Credentials API
         
         </a>
@@ -1000,8 +1000,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/authentication/" title="Authentication API Specification" class="dd-item ">
-        <a href="/hono/docs/api/authentication/">
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
         Authentication API
         
         </a>
@@ -1019,8 +1019,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/management/" title="Device Registry Management API Specification" class="dd-item ">
-        <a href="/hono/docs/api/management/">
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
         Device Registry Management API
         
         </a>
@@ -1038,8 +1038,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/api/metrics/" title="Metrics" class="dd-item ">
-        <a href="/hono/docs/api/metrics/">
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
         Metrics
         
         </a>
@@ -1064,12 +1064,12 @@
  
   
     
-    <li data-nav-id="/hono/docs/deployment/" title="Deployment" class="dd-item 
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
         
         
         
         ">
-      <a href="/hono/docs/deployment/">
+      <a href="/hono/docs/1.2/deployment/">
           <i class="fas fa-shipping-fast"></i> Deployment
           
       </a>
@@ -1089,8 +1089,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
-        <a href="/hono/docs/deployment/helm-based-deployment/">
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
         Helm based Deployment
         
         </a>
@@ -1108,8 +1108,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
-        <a href="/hono/docs/deployment/openshift/">
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
         OpenShift / OKD
         
         </a>
@@ -1127,8 +1127,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
-        <a href="/hono/docs/deployment/create-kubernetes-cluster/">
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
         Setting up a Kubernetes Cluster
         
         </a>
@@ -1146,8 +1146,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
-        <a href="/hono/docs/deployment/resource-limitation/">
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
         Limiting Resource Usage
         
         </a>
@@ -1172,12 +1172,12 @@
  
   
     
-    <li data-nav-id="/hono/docs/architecture/" title="Architecture" class="dd-item 
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
         
         
         
         ">
-      <a href="/hono/docs/architecture/">
+      <a href="/hono/docs/1.2/architecture/">
           <i class="fas fa-landmark"></i> Architecture
           
       </a>
@@ -1197,8 +1197,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/architecture/component-view/" title="Component View" class="dd-item ">
-        <a href="/hono/docs/architecture/component-view/">
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
         Component View
         
         </a>
@@ -1216,8 +1216,8 @@
  
   
     
-      <li data-nav-id="/hono/docs/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
-        <a href="/hono/docs/architecture/auth/">
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
         Authentication/Authorization
         
         </a>
@@ -1275,9 +1275,11 @@
               
               
                   
+              
+                  
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/device-registry/" selected>stable (1.2)</option>
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/device-registry/" selected>1.2</option>
                     
                   
               
@@ -1293,6 +1295,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/device-registry/">1.1</option>
@@ -1311,6 +1315,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/device-registry/">1.0</option>
@@ -1370,6 +1376,12 @@
         <div id="overlay"></div>
         
         
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
 
     
         <div class="padding highlightable">
@@ -1412,7 +1424,7 @@
             
           
           
-            <a href='/hono/docs/'>Documentation</a> > <a href='/hono/docs/user-guide/'>User Guide</a> > Device Registry
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/user-guide/'>User Guide</a> > Device Registry
           
          
           
@@ -1468,11 +1480,11 @@
         
 
 
-<p>The Device Registry component provides exemplary implementations of Hono&rsquo;s <a href="/hono/docs/api/tenant/">Tenant API</a>, <a href="/hono/docs/api/device-registration/">Device Registration API</a> and <a href="/hono/docs/api/credentials/">Credentials API</a>.</p>
+<p>The Device Registry component provides exemplary implementations of Hono&rsquo;s <a href="/hono/docs/1.2/api/tenant/">Tenant API</a>, <a href="/hono/docs/1.2/api/device-registration/">Device Registration API</a> and <a href="/hono/docs/1.2/api/credentials/">Credentials API</a>.</p>
 
 <p>As such it exposes AMQP 1.0 based endpoints for retrieving the relevant information and persists data in the local filesystem.</p>
 
-<p>In addition, the Device Registry also exposes HTTP resources for managing the contents of the registry according to the <a href="/hono/docs/api/management/">Device Registry HTTP API</a>.</p>
+<p>In addition, the Device Registry also exposes HTTP resources for managing the contents of the registry according to the <a href="/hono/docs/1.2/api/management/">Device Registry HTTP API</a>.</p>
 
 <div class="alert alert-warning">
     <h4 class="alert-heading"><i class="fas fa-exclamation-triangle"></i> Warning</h4>
@@ -1486,7 +1498,7 @@
 <h2 id="managing-tenants">Managing Tenants</h2>
 
 <p>The following sections describe the resources representing the operations of the Tenant API and how they can be used to manage tenants.
-Please refer to the <a href="/hono/docs/api/management/">Device Registry HTTP API</a> for the specific elements that are explained in detail there.</p>
+Please refer to the <a href="/hono/docs/1.2/api/management/">Device Registry HTTP API</a> for the specific elements that are explained in detail there.</p>
 
 <h3 id="add-a-tenant">Add a Tenant</h3>
 
@@ -1501,7 +1513,7 @@
 <li>Request Body:
 
 <ul>
-<li>(Optional) A JSON object as specified by <a href="/hono/docs/api/management/">Tenant schema</a> of the HTTP API specification.</li>
+<li>(Optional) A JSON object as specified by <a href="/hono/docs/1.2/api/management/">Tenant schema</a> of the HTTP API specification.</li>
 </ul></li>
 <li>Status Codes:
 
@@ -1559,7 +1571,7 @@
 <li>Status Codes:
 
 <ul>
-<li>200 (OK): A tenant with the given identifier has been found. The response body contains the tenant data as specified by <a href="/hono/docs/api/management/">Tenant schema</a> of the HTTP API specification.</li>
+<li>200 (OK): A tenant with the given identifier has been found. The response body contains the tenant data as specified by <a href="/hono/docs/1.2/api/management/">Tenant schema</a> of the HTTP API specification.</li>
 <li>404 (Not Found): No tenant with the given identifier is registered.</li>
 </ul></li>
 </ul>
@@ -1609,7 +1621,7 @@
 <li>Request Body:
 
 <ul>
-<li>(required) A JSON object as specified by <a href="/hono/docs/api/management/">Tenant schema</a> of the HTTP API specification.</li>
+<li>(required) A JSON object as specified by <a href="/hono/docs/1.2/api/management/">Tenant schema</a> of the HTTP API specification.</li>
 </ul></li>
 <li>Status Codes:
 
@@ -1661,8 +1673,8 @@
 
 <h2 id="managing-device-registration-information">Managing Device Registration Information</h2>
 
-<p>The following sections describe the resources representing the operations of the <a href="/hono/docs/api/device-registration/">Device Registration API</a> and how they can be used to manage device registration information.
-Please refer to the <a href="/hono/docs/api/management/">Device Registry HTTP API</a> for the specific elements that are explained in detail there.</p>
+<p>The following sections describe the resources representing the operations of the <a href="/hono/docs/1.2/api/device-registration/">Device Registration API</a> and how they can be used to manage device registration information.
+Please refer to the <a href="/hono/docs/1.2/api/management/">Device Registry HTTP API</a> for the specific elements that are explained in detail there.</p>
 
 <h3 id="register-device">Register Device</h3>
 
@@ -1677,7 +1689,7 @@
 <li>Request Body:
 
 <ul>
-<li>(Optional) A JSON object as specified by <a href="/hono/docs/api/management/">Device schema</a> of the HTTP API specification.</li>
+<li>(Optional) A JSON object as specified by <a href="/hono/docs/1.2/api/management/">Device schema</a> of the HTTP API specification.</li>
 </ul></li>
 <li>Status Codes:
 
@@ -1731,7 +1743,7 @@
 <li>Status Codes:
 
 <ul>
-<li>200 (OK): A device with the given identifier has been found. The response body contains the registration information as specified by <a href="/hono/docs/api/management/">Device schema</a> of the HTTP API specification.</li>
+<li>200 (OK): A device with the given identifier has been found. The response body contains the registration information as specified by <a href="/hono/docs/1.2/api/management/">Device schema</a> of the HTTP API specification.</li>
 <li>404 (Not Found): No device with the given identifier is registered for the given tenant.</li>
 </ul></li>
 </ul>
@@ -1767,7 +1779,7 @@
 <li>Request Body:
 
 <ul>
-<li>(required) A JSON object as specified by <a href="/hono/docs/api/management/">Device schema</a> of the HTTP API specification. All existing registration information will be replaced by the data provided in the object.</li>
+<li>(required) A JSON object as specified by <a href="/hono/docs/1.2/api/management/">Device schema</a> of the HTTP API specification. All existing registration information will be replaced by the data provided in the object.</li>
 </ul></li>
 <li>Status Codes:
 
@@ -1815,7 +1827,7 @@
 <h2 id="managing-credentials">Managing Credentials</h2>
 
 <p>The following sections describe the resources representing the operations of the Credentials API and how they can be used to manage credentials for devices.
-Please refer to the <a href="/hono/docs/api/management/">Device Registry HTTP API</a> for the specific elements that are explained in detail there.</p>
+Please refer to the <a href="/hono/docs/1.2/api/management/">Device Registry HTTP API</a> for the specific elements that are explained in detail there.</p>
 
 <h3 id="update-credentials-for-a-device">Update Credentials for a Device</h3>
 
@@ -1830,7 +1842,7 @@
 <li>Request Body:
 
 <ul>
-<li>(required) A JSON object as specified by <a href="/hono/docs/api/management/">Credentials schema</a> of the HTTP API specification.</li>
+<li>(required) A JSON object as specified by <a href="/hono/docs/1.2/api/management/">Credentials schema</a> of the HTTP API specification.</li>
 </ul></li>
 <li>Status Codes:
 
@@ -1954,7 +1966,7 @@
 <li>Status Codes:
 
 <ul>
-<li>200 (OK): Credentials for the device have been found, body contains the credentials. The response body contains the registration information as specified by <a href="/hono/docs/api/management/">Credentials schema</a> of the HTTP API specification.</li>
+<li>200 (OK): Credentials for the device have been found, body contains the credentials. The response body contains the registration information as specified by <a href="/hono/docs/1.2/api/management/">Credentials schema</a> of the HTTP API specification.</li>
 <li>404 (Not Found): No credentials for the device are registered.</li>
 </ul></li>
 </ul>
@@ -2932,20 +2944,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/1.2/user-guide/http-adapter/index.html b/docs/1.2/user-guide/http-adapter/index.html
new file mode 100644
index 0000000..00e41ab
--- /dev/null
+++ b/docs/1.2/user-guide/http-adapter/index.html
@@ -0,0 +1,3337 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>HTTP Adapter :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="HTTP Adapter :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="HTTP Adapter :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/user-guide/http-adapter//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/user-guide/http-adapter/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item active">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/user-guide/http-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/http-adapter/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/user-guide/http-adapter/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/user-guide/http-adapter/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/user-guide/http-adapter/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/user-guide/http-adapter.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/user-guide/'>User Guide</a> > HTTP Adapter
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#device-authentication">Device Authentication</a>
+<ul>
+<li><a href="#client-certificate">Client Certificate</a></li>
+<li><a href="#http-basic-auth">HTTP Basic Auth</a></li>
+</ul></li>
+<li><a href="#message-limits">Message Limits</a></li>
+<li><a href="#publish-telemetry-data-authenticated-device">Publish Telemetry Data (authenticated Device)</a></li>
+<li><a href="#publish-telemetry-data-unauthenticated-device">Publish Telemetry Data (unauthenticated Device)</a></li>
+<li><a href="#publish-telemetry-data-authenticated-gateway">Publish Telemetry Data (authenticated Gateway)</a></li>
+<li><a href="#publish-an-event-authenticated-device">Publish an Event (authenticated Device)</a></li>
+<li><a href="#publish-an-event-unauthenticated-device">Publish an Event (unauthenticated Device)</a></li>
+<li><a href="#publish-an-event-authenticated-gateway">Publish an Event (authenticated Gateway)</a></li>
+<li><a href="#command-control">Command &amp; Control</a>
+<ul>
+<li><a href="#specifying-the-time-a-device-will-wait-for-a-response">Specifying the Time a Device will wait for a Response</a>
+<ul>
+<li><a href="#using-an-http-header">Using an HTTP Header</a></li>
+<li><a href="#using-a-query-parameter">Using a Query Parameter</a></li>
+</ul></li>
+<li><a href="#commands-handled-by-gateways">Commands handled by gateways</a></li>
+<li><a href="#sending-a-response-to-a-command-authenticated-device">Sending a Response to a Command (authenticated Device)</a></li>
+<li><a href="#sending-a-response-to-a-command-unauthenticated-device">Sending a Response to a Command (unauthenticated Device)</a></li>
+<li><a href="#sending-a-response-to-a-command-authenticated-gateway">Sending a Response to a Command (authenticated Gateway)</a></li>
+</ul></li>
+<li><a href="#downstream-meta-data">Downstream Meta Data</a>
+<ul>
+<li><a href="#event-message-time-to-live">Event Message Time-to-live</a></li>
+</ul></li>
+<li><a href="#tenant-specific-configuration">Tenant specific Configuration</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>HTTP Adapter</h1>
+          
+
+        
+
+
+<p>The HTTP protocol adapter exposes HTTP based endpoints for Eclipse Hono&trade;&rsquo;s south bound Telemetry, Event and Command &amp; Control APIs.</p>
+
+<h2 id="device-authentication">Device Authentication</h2>
+
+<p>The HTTP adapter by default requires clients (devices or gateway components) to authenticate during connection establishment. The adapter supports both the <a href="https://tools.ietf.org/html/rfc7617">Basic HTTP authentication scheme</a> as well as client certificate based authentication as part of a TLS handshake for that purpose.</p>
+
+<p>The adapter tries to authenticate the device using these mechanisms in the following order</p>
+
+<h3 id="client-certificate">Client Certificate</h3>
+
+<p>When a device uses a client certificate for authentication during the TLS handshake, the adapter tries to determine the tenant that the device belongs to, based on the <em>issuer DN</em> contained in the certificate. In order for the lookup to succeed, the tenant&rsquo;s trust anchor needs to be configured by means of <a href="/hono/docs/1.2/api/tenant/#tenant-information-format">registering the trusted certificate authority</a>. The device&rsquo;s client certificate will then be validated using the registered trust anchor, thus implicitly establishing the tenant that the device belongs to. In a second step, the adapter then uses the Credentials API&rsquo;s <em>get</em> operation with the client certificate&rsquo;s <em>subject DN</em> as the <em>auth-id</em> and <code>x509-cert</code> as the <em>type</em> of secret as query parameters.</p>
+
+<p><strong>NB</strong> The HTTP adapter needs to be <a href="/hono/docs/1.2/admin-guide/secure_communication/#http-adapter">configured for TLS</a> in order to support this mechanism.</p>
+
+<h3 id="http-basic-auth">HTTP Basic Auth</h3>
+
+<p>The <em>username</em> provided in the header must have the form <em>auth-id@tenant</em>, e.g. <code>sensor1@DEFAULT_TENANT</code>. The adapter verifies the credentials provided by the client against the credentials that the <a href="/hono/docs/1.2/admin-guide/common-config/#credentials-service-connection-configuration">configured Credentials service</a> has on record for the client. The adapter uses the Credentials API&rsquo;s <em>get</em> operation to retrieve the credentials on record with the <em>tenant</em> and <em>auth-id</em> provided by the device in the <em>username</em> and <code>hashed-password</code> as the <em>type</em> of secret as query parameters.</p>
+
+<p>The examples below refer to devices <code>4711</code> and <code>gw-1</code> of tenant <code>DEFAULT_TENANT</code> using <em>auth-ids</em> <code>sensor1</code> and <code>gw1</code> and corresponding passwords. The example deployment as described in the <a href="/hono/docs/1.2/deployment/">Deployment Guides</a> comes pre-configured with the corresponding entities in its device registry component.
+Please refer to the <a href="/hono/docs/1.2/api/credentials/#standard-credential-types">Credentials API</a> for details regarding the different types of secrets.</p>
+
+<p><strong>NB</strong> There is a subtle difference between the <em>device identifier</em> (<em>device-id</em>) and the <em>auth-id</em> a device uses for authentication. See <a href="/hono/docs/1.2/concepts/device-identity/">Device Identity</a> for a discussion of the concepts.</p>
+
+<h2 id="message-limits">Message Limits</h2>
+
+<p>Before accepting any telemetry or event or command messages, the HTTP adapter verifies that the configured <a href="/hono/docs/1.2/concepts/resource-limits/">message limit</a> is not exceeded. If the limit is exceeded then the incoming message is discarded with the status code <code>429 Too Many Requests</code>.</p>
+
+<h2 id="publish-telemetry-data-authenticated-device">Publish Telemetry Data (authenticated Device)</h2>
+
+<ul>
+<li>URI: <code>/telemetry</code></li>
+<li>Method: <code>POST</code></li>
+<li>Request Headers:
+
+<ul>
+<li>(optional) <code>authorization</code>: The device&rsquo;s <em>auth-id</em> and plain text password encoded according to the <a href="https://tools.ietf.org/html/rfc7617">Basic HTTP authentication scheme</a>. If not set, the adapter expects the device to present a client certificate as part of the TLS handshake during connection establishment.</li>
+<li>(required) <code>content-type</code>: The type of payload contained in the request body.</li>
+<li>(optional) <code>hono-ttd</code>: The number of seconds the device will wait for the response.</li>
+<li>(optional) <code>qos-level</code>: The QoS level for publishing telemetry messages. The adapter supports <em>at most once</em> (<code>0</code>) and <em>at least once</em> (<code>1</code>) QoS levels. The default value of <code>0</code> is assumed if this header is omitted.</li>
+</ul></li>
+<li>Request Body:
+
+<ul>
+<li>(required) Arbitrary payload encoded according to the given content type.</li>
+</ul></li>
+<li>Response Headers:
+
+<ul>
+<li>(optional) <code>content-type</code>: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data.</li>
+<li>(optional) <code>hono-command</code>: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device.</li>
+<li>(optional) <code>hono-cmd-req-id</code>: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device.</li>
+<li>(optional) <code>hono-cmd-target-device</code>: The id of the device that shall execute the command. This header will only be present if the response contains a command to be executed by the device and if the response goes to a gateway that acts on behalf of the target device.</li>
+</ul></li>
+<li>Response Body:
+
+<ul>
+<li>(optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200.</li>
+<li>(optional) Error details, if status code is &gt;= 400.</li>
+</ul></li>
+<li>Status Codes:
+
+<ul>
+<li>200 (OK): The telemetry data has been accepted for processing. The response contains a command for the device to execute.</li>
+<li>202 (Accepted): The telemetry data has been accepted for processing. Note that if the <code>qos-level</code> request header is omitted (<em>at most once</em> semantics),
+this status code does <strong>not</strong> mean that the message has been delivered to any potential consumer. However, if the QoS level header is set to <code>1</code>
+(<em>at least once</em> semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with
+this status code.</li>
+<li>400 (Bad Request): The request cannot be processed. Possible reasons for this include:
+
+<ul>
+<li>The content type header is missing.</li>
+<li>The request body is empty.</li>
+<li>The QoS header value is invalid.</li>
+</ul></li>
+<li>401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials.</li>
+<li>403 (Forbidden): The request cannot be processed because the device&rsquo;s registration status cannot be asserted. Possible reasons for this include:
+
+<ul>
+<li>The given tenant is not allowed to use this protocol adapter.</li>
+</ul></li>
+<li>404 (Not Found): The request cannot be processed because the device is disabled or does not exist.</li>
+<li>413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size.</li>
+<li>429 (Too Many Requests): The request cannot be processed because the tenant&rsquo;s message limit for the current period is exceeded.</li>
+<li>503 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.</li>
+</ul></li>
+</ul>
+
+<p>This is the preferred way for devices to publish telemetry data. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Publish some JSON data for device <code>4711</code>:</p>
+
+<pre><code class="language-sh">curl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' --data-binary '{&quot;temp&quot;: 5}' http://127.0.0.1:8080/telemetry
+
+HTTP/1.1 202 Accepted
+content-length: 0
+</code></pre>
+
+<p>Publish some JSON data for device <code>4711</code> using <em>at least once</em> QoS:</p>
+
+<pre><code class="language-sh">curl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' -H 'qos-level: 1' --data-binary '{&quot;temp&quot;: 5}' http://localhost:8080/telemetry
+
+HTTP/1.1 202 Accepted
+content-length: 0
+</code></pre>
+
+<p>Publish some JSON data for device <code>4711</code>, indicating that the device will wait for 10 seconds to receive the response:</p>
+
+<pre><code class="language-sh">curl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' -H 'hono-ttd: 10' --data-binary '{&quot;temp&quot;: 5}' http://localhost:8080/telemetry
+
+HTTP/1.1 200 OK
+hono-command: set
+hono-cmd-req-id: 1010a7249aa5-f742-4376-8458-bbfc88c72d92
+content-length: 23
+
+{
+  &quot;brightness&quot;: 87
+}
+</code></pre>
+
+<p>Publish some JSON data for device <code>4711</code> using a client certificate for authentication:</p>
+
+<pre><code class="language-sh"># in base directory of Hono repository:
+curl -i --cert demo-certs/certs/device-4711-cert.pem --key demo-certs/certs/device-4711-key.pem --cacert demo-certs/certs/trusted-certs.pem -H 'content-type: application/json' --data-binary '{&quot;temp&quot;: 5}' https://localhost:8443/telemetry
+
+HTTP/1.1 202 Accepted
+content-length: 0
+</code></pre>
+
+<p><strong>NB</strong> The example above assumes that the HTTP adapter is <a href="/hono/docs/1.2/admin-guide/secure_communication/#http-adapter">configured for TLS</a> and the secure port is used.</p>
+
+<h2 id="publish-telemetry-data-unauthenticated-device">Publish Telemetry Data (unauthenticated Device)</h2>
+
+<ul>
+<li>URI: <code>/telemetry/${tenantId}/${deviceId}</code></li>
+<li>Method: <code>PUT</code></li>
+<li>Request Headers:
+
+<ul>
+<li>(required) <code>content-type</code>: The type of payload contained in the request body.</li>
+<li>(optional) <code>hono-ttd</code>: The number of seconds the device will wait for the response.</li>
+<li>(optional) <code>qos-level</code>: The QoS level for publishing telemetry messages. The adapter supports <em>at most once</em> (<code>0</code>) and <em>at least once</em> (<code>1</code>) QoS levels. The default value of <code>0</code> is assumed if this header is omitted.</li>
+</ul></li>
+<li>Request Body:
+
+<ul>
+<li>(required) Arbitrary payload encoded according to the given content type.</li>
+</ul></li>
+<li>Response Headers:
+
+<ul>
+<li>(optional) <code>content-type</code>: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data.</li>
+<li>(optional) <code>hono-command</code>: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device.</li>
+<li>(optional) <code>hono-cmd-req-id</code>: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device.</li>
+</ul></li>
+<li>Response Body:
+
+<ul>
+<li>(optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200.</li>
+<li>(optional) Error details, if status code is &gt;= 400.</li>
+</ul></li>
+<li>Status Codes:
+
+<ul>
+<li>200 (OK): The telemetry data has been accepted for processing. The response contains a command for the device to execute.</li>
+<li>202 (Accepted): The telemetry data has been accepted for processing. Note that if the <code>qos-level</code> request header is omitted (<em>at most once</em> semantics),
+this status code does <strong>not</strong> mean that the message has been delivered to any potential consumer. However, if the QoS level header is set to <code>1</code>
+(<em>at least once</em> semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with
+this status code.</li>
+<li>400 (Bad Request): The request cannot be processed. Possible reasons for this include:
+
+<ul>
+<li>The content type header is missing.</li>
+<li>The request body is empty.</li>
+<li>The QoS header value is invalid.</li>
+</ul></li>
+<li>403 (Forbidden): The request cannot be processed because the device&rsquo;s registration status cannot be asserted. Possible reasons for this include:
+
+<ul>
+<li>The given tenant is not allowed to use this protocol adapter.</li>
+<li>The given device does not belong to the given tenant.</li>
+</ul></li>
+<li>404 (Not Found): The request cannot be processed because the device is disabled or does not exist.</li>
+<li>413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size.</li>
+<li>429 (Too Many Requests): The request cannot be processed because the tenant&rsquo;s message limit for the current period is exceeded.</li>
+<li>503 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.</li>
+</ul></li>
+</ul>
+
+<p>This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the <code>HONO_HTTP_AUTHENTICATION_REQUIRED</code> configuration property to be explicitly set to <code>false</code>.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Publish some JSON data for device <code>4711</code>:</p>
+
+<pre><code class="language-sh">curl -i -X PUT -H 'content-type: application/json' --data-binary '{&quot;temp&quot;: 5}' http://127.0.0.1:8080/telemetry/DEFAULT_TENANT/4711
+
+HTTP/1.1 202 Accepted
+content-length: 0
+</code></pre>
+
+<p>Publish some JSON data for device <code>4711</code> using <em>at least once</em> QoS:</p>
+
+<pre><code class="language-sh">curl -i -X PUT -H 'content-type: application/json' -H 'qos-level: 1' --data-binary '{&quot;temp&quot;: 5}' http://127.0.0.1:8080/telemetry/DEFAULT_TENANT/4711
+
+HTTP/1.1 202 Accepted
+content-length: 0
+</code></pre>
+
+<p>Publish some JSON data for device <code>4711</code>, indicating that the device will wait for 10 seconds to receive the response:</p>
+
+<pre><code class="language-sh">curl -i -X PUT -H 'content-type: application/json' -H 'hono-ttd: 10' --data-binary '{&quot;temp&quot;: 5}' http://localhost:8080/telemetry/DEFAULT_TENANT/4711
+
+HTTP/1.1 200 OK
+hono-command: set
+hono-cmd-req-id: 1010a7249aa5-f742-4376-8458-bbfc88c72d92
+content-length: 23
+
+{
+  &quot;brightness&quot;: 87
+}
+</code></pre>
+
+<h2 id="publish-telemetry-data-authenticated-gateway">Publish Telemetry Data (authenticated Gateway)</h2>
+
+<ul>
+<li>URI: <code>/telemetry/${tenantId}/${deviceId}</code></li>
+<li>Method: <code>PUT</code></li>
+<li>Request Headers:
+
+<ul>
+<li>(optional) <code>authorization</code>: The gateway&rsquo;s <em>auth-id</em> and plain text password encoded according to the <a href="https://tools.ietf.org/html/rfc7617">Basic HTTP authentication scheme</a>. If not set, the adapter expects the gateway to present a client certificate as part of the TLS handshake during connection establishment.</li>
+<li>(required) <code>content-type</code>: The type of payload contained in the request body.</li>
+<li>(optional) <code>hono-ttd</code>: The number of seconds the device will wait for the response.</li>
+<li>(optional) <code>qos-level</code>: The QoS level for publishing telemetry messages. The adapter supports <em>at most once</em> (<code>0</code>) and <em>at least once</em> (<code>1</code>) QoS levels. The default value of <code>0</code> is assumed if this header is omitted.</li>
+</ul></li>
+<li>Request Body:
+
+<ul>
+<li>(required) Arbitrary payload encoded according to the given content type.</li>
+</ul></li>
+<li>Response Headers:
+
+<ul>
+<li>(optional) <code>content-type</code>: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data.</li>
+<li>(optional) <code>hono-command</code>: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device.</li>
+<li>(optional) <code>hono-cmd-req-id</code>: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device.</li>
+<li>(optional) <code>hono-cmd-target-device</code>: The id of the device that shall execute the command. This header will only be present if the response contains a command to be executed by the device.</li>
+</ul></li>
+<li>Response Body:
+
+<ul>
+<li>(optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200.</li>
+<li>(optional) Error details, if status code is &gt;= 400.</li>
+</ul></li>
+<li>Status Codes:
+
+<ul>
+<li>200 (OK): The telemetry data has been accepted for processing. The response contains a command for the device to execute.</li>
+<li>202 (Accepted): The telemetry data has been accepted for processing. Note that if the <code>qos-level</code> request header is omitted (<em>at most once</em> semantics),
+this status code does <strong>not</strong> mean that the message has been delivered to any potential consumer. However, if the QoS level header is set to <code>1</code>
+(<em>at least once</em> semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with
+this status code.</li>
+<li>400 (Bad Request): The request cannot be processed. Possible reasons for this include:
+
+<ul>
+<li>The content type header is missing.</li>
+<li>The request body is empty.</li>
+<li>The QoS header value is invalid.</li>
+</ul></li>
+<li>401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials.</li>
+<li>403 (Forbidden): The request cannot be processed because the device&rsquo;s registration status cannot be asserted. Possible reasons for this include:
+
+<ul>
+<li>The tenant that the gateway belongs to is not allowed to use this protocol adapter.</li>
+<li>The device belongs to another tenant than the gateway.</li>
+<li>The gateway is not authorized to act <em>on behalf of</em> the device.</li>
+<li>The gateway associated with the device is not registered or disabled.</li>
+</ul></li>
+<li>404 (Not Found): The request cannot be processed because the device is disabled or does not exist.</li>
+<li>413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size.</li>
+<li>429 (Too Many Requests): The request cannot be processed because the tenant&rsquo;s message limit for the current period is exceeded.</li>
+<li>503 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.</li>
+</ul></li>
+</ul>
+
+<p>This resource can be used by <em>gateway</em> components to publish data <em>on behalf of</em> other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like <a href="https://www.sigfox.com">SigFox</a> or <a href="https://lora-alliance.org/">LoRa</a>. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.</p>
+
+<p>The protocol adapter checks the gateway&rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a <em>registration assertion</em> for the device from the <a href="/hono/docs/1.2/admin-guide/common-config/#device-registration-service-connection-configuration">configured Device Registration service</a>.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Publish some JSON data for device <code>4712</code>:</p>
+
+<pre><code class="language-sh">curl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' --data-binary '{&quot;temp&quot;: 5}' http://127.0.0.1:8080/telemetry/DEFAULT_TENANT/4712
+
+HTTP/1.1 202 Accepted
+content-length: 0
+</code></pre>
+
+<p>Publish some JSON data for device <code>4712</code> using <em>at least once</em> QoS:</p>
+
+<pre><code class="language-sh">curl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' -H 'qos-level: 1' --data-binary '{&quot;temp&quot;: 5}' http://127.0.0.1:8080/telemetry/DEFAULT_TENANT/4712
+
+HTTP/1.1 202 Accepted
+content-length: 0
+</code></pre>
+
+<p>Publish some JSON data for device <code>4712</code>, indicating that the gateway will wait for 10 seconds to receive the response:</p>
+
+<pre><code class="language-sh">curl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' -H 'hono-ttd: 10' --data-binary '{&quot;temp&quot;: 5}' http://localhost:8080/telemetry/DEFAULT_TENANT/4712
+
+HTTP/1.1 200 OK
+hono-command: set
+hono-cmd-req-id: 1010a7249aa5-f742-4376-8458-bbfc88c72d92
+content-length: 23
+
+{
+  &quot;brightness&quot;: 87
+}
+</code></pre>
+
+<p><strong>NB</strong> The example above assumes that a gateway device has been registered with <code>hashed-password</code> credentials with <em>auth-id</em> <code>gw</code> and password <code>gw-secret</code> which is authorized to publish data <em>on behalf of</em> device <code>4712</code>.</p>
+
+<h2 id="publish-an-event-authenticated-device">Publish an Event (authenticated Device)</h2>
+
+<ul>
+<li>URI: <code>/event</code></li>
+<li>Method: <code>POST</code></li>
+<li>Request Headers:
+
+<ul>
+<li>(optional) <code>authorization</code>: The device&rsquo;s <em>auth-id</em> and plain text password encoded according to the <a href="https://tools.ietf.org/html/rfc7617">Basic HTTP authentication scheme</a>. If not set, the adapter expects the device to present a client certificate as part of the TLS handshake during connection establishment.</li>
+<li>(required) <code>content-type</code>: The type of payload contained in the request body.</li>
+<li>(optional) <code>hono-ttd</code>: The number of seconds the device will wait for the response.</li>
+<li>(optional) <code>hono-ttl</code>: The <em>time-to-live</em> in number of seconds for event messages.<br /></li>
+</ul></li>
+<li>Request Body:
+
+<ul>
+<li>(required) Arbitrary payload encoded according to the given content type.</li>
+</ul></li>
+<li>Response Headers:
+
+<ul>
+<li>(optional) <code>content-type</code>: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data.</li>
+<li>(optional) <code>hono-command</code>: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device.</li>
+<li>(optional) <code>hono-cmd-req-id</code>: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device.</li>
+<li>(optional) <code>hono-cmd-target-device</code>: The id of the device that shall execute the command. This header will only be present if the response contains a command to be executed by the device and if the response goes to a gateway that acts on behalf of the target device.</li>
+</ul></li>
+<li>Response Body:
+
+<ul>
+<li>(optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200.</li>
+<li>(optional) Error details, if status code is &gt;= 400.</li>
+</ul></li>
+<li>Status Codes:
+
+<ul>
+<li>200 (OK): The event has been accepted for processing. The response contains a command for the device to execute.</li>
+<li>202 (Accepted): The event has been accepted for processing.</li>
+<li>400 (Bad Request): The request cannot be processed. Possible reasons for this include:
+
+<ul>
+<li>The content type header is missing.</li>
+<li>The request body is empty but the event is not of type <a href="/hono/docs/1.2/api/event/#empty-notification">empty-notification</a>.</li>
+</ul></li>
+<li>401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials.</li>
+<li>403 (Forbidden): The request cannot be processed because the device&rsquo;s registration status cannot be asserted. Possible reasons for this include:
+
+<ul>
+<li>The given tenant is not allowed to use this protocol adapter.</li>
+</ul></li>
+<li>404 (Not Found): The request cannot be processed because the device is disabled or does not exist.</li>
+<li>413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size.</li>
+<li>429 (Too Many Requests): The request cannot be processed because the tenant&rsquo;s message limit for the current period is exceeded.</li>
+<li>503 (Service Unavailable): The request cannot be processed because there is no consumer of events for the given tenant connected to Hono.</li>
+</ul></li>
+</ul>
+
+<p>This is the preferred way for devices to publish events. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).</p>
+
+<p><strong>Example</strong></p>
+
+<p>Publish some JSON data for device <code>4711</code>:</p>
+
+<pre><code class="language-sh">curl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' --data-binary '{&quot;alarm&quot;: true}' http://127.0.0.1:8080/event
+
+HTTP/1.1 202 Accepted
+content-length: 0
+</code></pre>
+
+<h2 id="publish-an-event-unauthenticated-device">Publish an Event (unauthenticated Device)</h2>
+
+<ul>
+<li>URI: <code>/event/${tenantId}/${deviceId}</code></li>
+<li>Method: <code>PUT</code></li>
+<li>Request Headers:
+
+<ul>
+<li>(required) <code>content-type</code>: The type of payload contained in the request body.</li>
+<li>(optional) <code>hono-ttd</code>: The number of seconds the device will wait for the response.</li>
+<li>(optional) <code>hono-ttl</code>: The <em>time-to-live</em> in number of seconds for event messages.</li>
+</ul></li>
+<li>Request Body:
+
+<ul>
+<li>(required) Arbitrary payload encoded according to the given content type.</li>
+</ul></li>
+<li>Response Headers:
+
+<ul>
+<li>(optional) <code>content-type</code>: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data.</li>
+<li>(optional) <code>hono-command</code>: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device.</li>
+<li>(optional) <code>hono-cmd-req-id</code>: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device.</li>
+</ul></li>
+<li>Response Body:
+
+<ul>
+<li>(optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200.</li>
+<li>(optional) Error details, if status code is &gt;= 400.</li>
+</ul></li>
+<li>Status Codes:
+
+<ul>
+<li>200 (OK): The event has been accepted and put to a persistent store for delivery to consumers. The response contains a command for the device to execute.</li>
+<li>202 (Accepted): The event has been accepted and put to a persistent store for delivery to consumers.</li>
+<li>400 (Bad Request): The request cannot be processed. Possible reasons for this include:
+
+<ul>
+<li>The content type header is missing.</li>
+<li>The request body is empty but the event is not of type <a href="/hono/docs/1.2/api/event/#empty-notification">empty-notification</a>.</li>
+</ul></li>
+<li>403 (Forbidden): The request cannot be processed because the device&rsquo;s registration status cannot be asserted. Possible reasons for this include:
+
+<ul>
+<li>The given tenant is not allowed to use this protocol adapter.</li>
+<li>The given device does not belong to the given tenant.</li>
+</ul></li>
+<li>404 (Not Found): The request cannot be processed because the device is disabled or does not exist.</li>
+<li>413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size.</li>
+<li>429 (Too Many Requests): The request cannot be processed because the tenant&rsquo;s message limit for the current period is exceeded.</li>
+<li>503 (Service Unavailable): The request cannot be processed because there is no consumer of events for the given tenant connected to Hono.</li>
+</ul></li>
+</ul>
+
+<p>This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the <code>HONO_HTTP_AUTHENTICATION_REQUIRED</code> configuration property to be explicitly set to <code>false</code>.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Publish some JSON data for device <code>4711</code>:</p>
+
+<pre><code class="language-sh">curl -i -X PUT -H 'content-type: application/json' --data-binary '{&quot;alarm&quot;: true}' http://127.0.0.1:8080/event/DEFAULT_TENANT/4711
+
+HTTP/1.1 202 Accepted
+content-length: 0
+</code></pre>
+
+<h2 id="publish-an-event-authenticated-gateway">Publish an Event (authenticated Gateway)</h2>
+
+<ul>
+<li>URI: <code>/event/${tenantId}/${deviceId}</code></li>
+<li>Method: <code>PUT</code></li>
+<li>Request Headers:
+
+<ul>
+<li>(optional) <code>authorization</code>: The gateway&rsquo;s <em>auth-id</em> and plain text password encoded according to the <a href="https://tools.ietf.org/html/rfc7617">Basic HTTP authentication scheme</a>. If not set, the adapter expects the gateway to present a client certificate as part of the TLS handshake during connection establishment.</li>
+<li>(required) <code>content-type</code>: The type of payload contained in the request body.</li>
+<li>(optional) <code>hono-ttd</code>: The number of seconds the device will wait for the response.</li>
+<li>(optional) <code>hono-ttl</code>: The <em>time-to-live</em> in number of seconds for event messages.</li>
+</ul></li>
+<li>Request Body:
+
+<ul>
+<li>(required) Arbitrary payload encoded according to the given content type.</li>
+</ul></li>
+<li>Response Headers:
+
+<ul>
+<li>(optional) <code>content-type</code>: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data.</li>
+<li>(optional) <code>hono-command</code>: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device.</li>
+<li>(optional) <code>hono-cmd-req-id</code>: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device.</li>
+<li>(optional) <code>hono-cmd-target-device</code>: The id of the device that shall execute the command. This header will only be present if the response contains a command to be executed by the device.</li>
+</ul></li>
+<li>Response Body:
+
+<ul>
+<li>(optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200.</li>
+<li>(optional) Error details, if status code is &gt;= 400.</li>
+</ul></li>
+<li>Status Codes:
+
+<ul>
+<li>200 (OK): The event has been accepted and put to a persistent store for delivery to consumers. The response contains a command for the device to execute.</li>
+<li>202 (Accepted): The event has been accepted and put to a persistent store for delivery to consumers.</li>
+<li>400 (Bad Request): The request cannot be processed. Possible reasons for this include:
+
+<ul>
+<li>The content type header is missing.</li>
+<li>The request body is empty but the event is not of type <a href="/hono/docs/1.2/api/event/#empty-notification">empty-notification</a>.</li>
+</ul></li>
+<li>401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials.</li>
+<li>403 (Forbidden): The request cannot be processed because the device&rsquo;s registration status cannot be asserted. Possible reasons for this include:
+
+<ul>
+<li>The tenant that the gateway belongs to is not allowed to use this protocol adapter.</li>
+<li>The device belongs to another tenant than the gateway.</li>
+<li>The gateway is not authorized to act <em>on behalf of</em> the device.</li>
+<li>The gateway associated with the device is not registered or disabled.</li>
+</ul></li>
+<li>404 (Not Found): The request cannot be processed because the device is disabled or does not exist.</li>
+<li>413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size.</li>
+<li>429 (Too Many Requests): The request cannot be processed because the tenant&rsquo;s message limit for the current period is exceeded.</li>
+<li>503 (Service Unavailable): The request cannot be processed because there is no consumer of events for the given tenant connected to Hono.</li>
+</ul></li>
+</ul>
+
+<p>This resource can be used by <em>gateway</em> components to publish data <em>on behalf of</em> other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like <a href="https://www.sigfox.com">SigFox</a> or <a href="https://lora-alliance.org/">LoRa</a>. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.</p>
+
+<p>The protocol adapter checks the gateway&rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a <em>registration assertion</em> for the device from the <a href="/hono/docs/1.2/admin-guide/common-config/#device-registration-service-connection-configuration">configured Device Registration service</a>.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Publish some JSON data for device <code>4712</code>:</p>
+
+<pre><code class="language-sh">curl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' --data-binary '{&quot;temp&quot;: 5}' http://127.0.0.1:8080/event/DEFAULT_TENANT/4712
+
+HTTP/1.1 202 Accepted
+content-length: 0
+</code></pre>
+
+<p><strong>NB</strong> The example above assumes that a gateway device has been registered with <code>hashed-password</code> credentials with <em>auth-id</em> <code>gw</code> and password <code>gw-secret</code> which is authorized to publish data <em>on behalf of</em> device <code>4712</code>.</p>
+
+<h2 id="command-control">Command &amp; Control</h2>
+
+<p>The HTTP adapter enables devices to receive commands that have been sent by business applications. Commands are delivered to the device by means of an HTTP response message. That means a device first has to send a request, indicating how long it will wait for the response. That request can either be a telemetry or event message, with a <code>hono-ttd</code> header or query parameter (<code>ttd</code> for <code>time till disconnect</code>) specifying the number of seconds the device will wait for the response. The business application can react on that message by sending a command message, targeted at the device. The HTTP adapter will then send the command message as part of the HTTP response message with status <code>200</code> (OK) to the device. If the HTTP adapter receives no command message in the given time period, a <code>202</code> (Accepted) response will be sent to the device (provided the request was valid).</p>
+
+<h3 id="specifying-the-time-a-device-will-wait-for-a-response">Specifying the Time a Device will wait for a Response</h3>
+
+<p>The adapter lets devices indicate the number of seconds they will wait for a response by setting a header or a query parameter.</p>
+
+<h4 id="using-an-http-header">Using an HTTP Header</h4>
+
+<p>The (optional) <code>hono-ttd</code> header can be set in requests for publishing telemetry data or events.</p>
+
+<p>Example:</p>
+
+<pre><code class="language-sh">curl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' -H 'hono-ttd: 60' --data-binary '{&quot;temp&quot;: 5}' http://127.0.0.1:8080/telemetry
+
+HTTP/1.1 202 Accepted
+content-length: 0
+</code></pre>
+
+<h4 id="using-a-query-parameter">Using a Query Parameter</h4>
+
+<p>Alternatively the <code>hono-ttd</code> query parameter can be used:</p>
+
+<pre><code class="language-sh">curl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' --data-binary '{&quot;temp&quot;: 5}' http://127.0.0.1:8080/telemetry?hono-ttd=60
+
+HTTP/1.1 202 Accepted
+content-length: 0
+</code></pre>
+
+<h3 id="commands-handled-by-gateways">Commands handled by gateways</h3>
+
+<p>Authenticated gateways will receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway. Corresponding devices have to be configured so that they can be used with a gateway. See <a href="/hono/docs/1.2/admin-guide/device-registry-config/#configuring-gateway-devices">Configuring Gateway Devices</a> for details.</p>
+
+<p>A gateway can send a request with the <code>hono-ttd</code> header or query parameter on the <code>/event</code> or <code>/telemetry</code> URI, indicating its readiness to receive a command for <em>any</em> device it acts on behalf of. Note that in this case, the business application will be notified with the gateway id in the <code>device_id</code> property of the downstream message.</p>
+
+<p>An authenticated gateway can also indicate its readiness to receive a command targeted at a <em>specific</em> device. For that, the <code>/event/${tenantId}/${deviceId}</code> or <code>/telemetry/${tenantId}/${deviceId}</code> URI is to be used, containing the id of the device to receive a command for. The business application will receive a notification with that device id.</p>
+
+<p>If there are multiple concurrent requests with a <code>hono-ttd</code> header or query parameter, sent by the command target device and/or one or more of its potential gateways, the HTTP adapter will choose the device or gateway to send the command to as follows:</p>
+
+<ul>
+<li>A request done by the command target device or by a gateway specifically done for that device, has precedence. If there are multiple, concurrent such requests, the last one will get the command message (if received) in its response. Note that the other requests won&rsquo;t be answered with a command message in their response event if the business application sent multiple command messages. That means commands for a single device can only be requested sequentially, not in parallel.</li>
+<li>If the above doesn&rsquo;t apply, a single <code>hono-ttd</code> request on the <code>/event</code> or <code>/telemetry</code> URI, sent by a gateway that the command target device is configured for, will get the command message in its response.</li>
+<li>If there are multiple, concurrent such requests by different gateways, all configured for the command target device, the request by the gateway will be chosen, through which the target device has last sent a telemetry or event message. If the target device hasn&rsquo;t sent a message yet and it is thereby unknown via which gateway the device communicates, then one of the requests will be chosen randomly to set the command in its response.</li>
+</ul>
+
+<h3 id="sending-a-response-to-a-command-authenticated-device">Sending a Response to a Command (authenticated Device)</h3>
+
+<ul>
+<li>URI: <code>/command/res/${commandRequestId}</code> or <code>/command/res/${commandRequestId}?hono-cmd-status=${status}</code></li>
+<li>Method: <code>POST</code></li>
+<li>Request Headers:
+
+<ul>
+<li>(optional) <code>authorization</code>: The device&rsquo;s <em>auth-id</em> and plain text password encoded according to the <a href="https://tools.ietf.org/html/rfc7617">Basic HTTP authentication scheme</a>. If not set, the adapter expects the device to present a client certificate as part of the TLS handshake during connection establishment.</li>
+<li>(optional) <code>content-type</code>: A media type describing the semantics and format of the payload contained in the request body. This header may be set if the result of processing the command on the device is non-empty. In this case the result data is contained in the request body.</li>
+<li>(optional) <code>hono-cmd-status</code>: The status of the command execution. If not set, the adapter expects that the URI contains it
+as request parameter at the end.</li>
+</ul></li>
+<li>Request Body:
+
+<ul>
+<li>(optional) Arbitrary data representing the result of processing the command on the device.</li>
+</ul></li>
+<li>Status Codes:
+
+<ul>
+<li>202 (Accepted): The response has been successfully delivered to the application that has sent the command.</li>
+<li>400 (Bad Request): The request cannot be processed because the command status is missing.</li>
+<li>401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials.<br /></li>
+<li>403 (Forbidden): The request cannot be processed because the device&rsquo;s registration status cannot be asserted. Possible reasons for this include:
+
+<ul>
+<li>The given tenant is not allowed to use this protocol adapter.</li>
+</ul></li>
+<li>404 (Not Found): The request cannot be processed because the device is disabled or does not exist.</li>
+<li>413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size.</li>
+<li>429 (Too Many Requests): The request cannot be processed because the tenant&rsquo;s message limit for the current period is exceeded.</li>
+<li>503 (Service Unavailable): The request cannot be processed. Possible reasons for this include:
+
+<ul>
+<li>There is no application listening for a reply to the given <em>commandRequestId</em>.</li>
+<li>The application has already given up on waiting for a response.</li>
+</ul></li>
+</ul></li>
+</ul>
+
+<p>This is the preferred way for devices to respond to commands. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).</p>
+
+<p><strong>Example</strong></p>
+
+<p>Send a response to a previously received command with the command-request-id <code>req-id-uuid</code> for device <code>4711</code>:</p>
+
+<pre><code class="language-sh">curl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' --data-binary '{&quot;brightness-changed&quot;: true}' http://127.0.0.1:8080/command/res/req-id-uuid?hono-cmd-status=200
+
+HTTP/1.1 202 Accepted
+content-length: 0
+</code></pre>
+
+<h3 id="sending-a-response-to-a-command-unauthenticated-device">Sending a Response to a Command (unauthenticated Device)</h3>
+
+<ul>
+<li>URI: <code>/command/res/${tenantId}/${deviceId}/${commandRequestId}</code> or <code>/command/res/${tenantId}/${deviceId}/${commandRequestId}?hono-cmd-status=${status}</code></li>
+<li>Method: <code>PUT</code></li>
+<li>Request Headers:
+
+<ul>
+<li>(optional) <code>content-type</code>: A media type describing the semantics and format of the payload contained in the request body (the outcome of processing the command).</li>
+<li>(optional) <code>hono-cmd-status</code>: The status of the command execution. If not set, the adapter expects that the URI contains it
+as request parameter at the end.</li>
+</ul></li>
+<li>Request Body:
+
+<ul>
+<li>(optional) Arbitrary data representing the result of processing the command on the device.</li>
+</ul></li>
+<li>Status Codes:
+
+<ul>
+<li>202 (Accepted): The response has been successfully delivered to the application that has sent the command.</li>
+<li>400 (Bad Request): The request cannot be processed because the command status is missing.</li>
+<li>403 (Forbidden): The request cannot be processed because the device&rsquo;s registration status cannot be asserted. Possible reasons for this might be:
+
+<ul>
+<li>The given tenant is not allowed to use this protocol adapter.</li>
+<li>The given device does not belong to the given tenant.</li>
+</ul></li>
+<li>404 (Not Found): The request cannot be processed because the device is disabled or does not exist.</li>
+<li>413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size.</li>
+<li>429 (Too Many Requests): The request cannot be processed because the tenant&rsquo;s message limit for the current period is exceeded.</li>
+<li>503 (Service Unavailable): The request cannot be processed. Possible reasons for this include:
+
+<ul>
+<li>There is no application listening for a reply to the given <em>commandRequestId</em>.</li>
+<li>The application has already given up on waiting for a response.</li>
+</ul></li>
+</ul></li>
+</ul>
+
+<p>This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the <code>HONO_HTTP_AUTHENTICATION_REQUIRED</code> configuration property to be explicitly set to <code>false</code>.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Send a response to a previously received command with the command-request-id <code>req-id-uuid</code> for the unauthenticated device <code>4711</code>:</p>
+
+<pre><code class="language-sh">curl -i -X PUT -H 'content-type: application/json' --data-binary '{&quot;brightness-changed&quot;: true}' http://127.0.0.1:8080/command/res/DEFAULT_TENANT/4711/req-id-uuid?hono-cmd-status=200
+
+HTTP/1.1 202 Accepted
+content-length: 0
+</code></pre>
+
+<h3 id="sending-a-response-to-a-command-authenticated-gateway">Sending a Response to a Command (authenticated Gateway)</h3>
+
+<ul>
+<li>URI: <code>/command/res/${tenantId}/${deviceId}/${commandRequestId}</code> or <code>/command/res/${tenantId}/${deviceId}/${commandRequestId}?hono-cmd-status=${status}</code></li>
+<li>Method: <code>PUT</code></li>
+<li>Request Headers:
+
+<ul>
+<li>(optional) <code>authorization</code>: The gateway&rsquo;s <em>auth-id</em> and plain text password encoded according to the <a href="https://tools.ietf.org/html/rfc7617">Basic HTTP authentication scheme</a>. If not set, the adapter expects the gateway to present a client certificate as part of the TLS handshake during connection establishment.</li>
+<li>(optional) <code>content-type</code>: A media type describing the semantics and format of the payload contained in the request body (the outcome of processing the command).</li>
+<li>(optional) <code>hono-cmd-status</code>: The status of the command execution. If not set, the adapter expects that the URI contains it
+as request parameter at the end.</li>
+</ul></li>
+<li>Request Body:
+
+<ul>
+<li>(optional) Arbitrary data representing the result of processing the command on the device.</li>
+</ul></li>
+<li>Status Codes:
+
+<ul>
+<li>202 (Accepted): The response has been successfully delivered to the application that has sent the command.</li>
+<li>400 (Bad Request): The request cannot be processed because the command status is missing.</li>
+<li>403 (Forbidden): The request cannot be processed because the device&rsquo;s registration status cannot be asserted. Possible reasons for this might be:
+
+<ul>
+<li>The given tenant is not allowed to use this protocol adapter.</li>
+<li>The given device does not belong to the given tenant.</li>
+<li>The gateway is not authorized to act <em>on behalf of</em> the device.</li>
+<li>The gateway associated with the device is not registered or disabled.</li>
+</ul></li>
+<li>404 (Not Found): The request cannot be processed because the device is disabled or does not exist.</li>
+<li>413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size.</li>
+<li>429 (Too Many Requests): The request cannot be processed because the tenant&rsquo;s message limit for the current period is exceeded.</li>
+<li>503 (Service Unavailable): The request cannot be processed. Possible reasons for this include:
+
+<ul>
+<li>There is no application listening for a reply to the given <em>commandRequestId</em>.</li>
+<li>The application has already given up on waiting for a response.</li>
+</ul></li>
+</ul></li>
+</ul>
+
+<p>This resource can be used by <em>gateway</em> components to send the response to a command <em>on behalf of</em> other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like <a href="https://www.sigfox.com">SigFox</a> or <a href="https://lora-alliance.org/">LoRa</a>. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.</p>
+
+<p>The protocol adapter checks the gateway&rsquo;s authority to send responses to a command on behalf of the device implicitly by means of retrieving a <em>registration assertion</em> for the device from the <a href="/hono/docs/1.2/admin-guide/common-config/#device-registration-service-connection-configuration">configured Device Registration service</a>.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Send a response to a previously received command with the command-request-id <code>req-id-uuid</code> for device <code>4712</code>:</p>
+
+<pre><code class="language-sh">curl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' --data-binary '{&quot;brightness-changed&quot;: true}' http://127.0.0.1:8080/command/res/DEFAULT_TENANT/4712/req-id-uuid?hono-cmd-status=200
+
+HTTP/1.1 202 Accepted
+content-length: 0
+</code></pre>
+
+<p><strong>NB</strong> The example above assumes that a gateway device has been registered with <code>hashed-password</code> credentials with <em>auth-id</em> <code>gw</code> and password <code>gw-secret</code> which is authorized to publish data <em>on behalf of</em> device <code>4712</code>.</p>
+
+<h2 id="downstream-meta-data">Downstream Meta Data</h2>
+
+<p>The adapter includes the following meta data in the application properties of messages being sent downstream:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="left">Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>device_id</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The identifier of the device that the message originates from.</td>
+</tr>
+
+<tr>
+<td align="left"><em>orig_adapter</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">Contains the adapter&rsquo;s <em>type name</em> which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The HTTP adapter&rsquo;s type name is <code>hono-http</code>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>orig_address</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">Contains the (relative) URI that the device has originally posted the data to.</td>
+</tr>
+
+<tr>
+<td align="left"><em>ttd</em></td>
+<td align="left"><em>integer</em></td>
+<td align="left">Contains the effective number of seconds that the device will wait for a response. This property is only set if the HTTP request contains the <code>hono-ttd</code> header or request parameter.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The adapter also considers <em>defaults</em> registered for the device at either the <a href="/hono/docs/1.2/api/tenant/#tenant-information-format">tenant</a> or the <a href="/hono/docs/1.2/api/device-registration/#assert-device-registration">device level</a>. The values of the default properties are determined as follows:</p>
+
+<ol>
+<li>If the message already contains a non-empty property of the same name, the value if unchanged.</li>
+<li>Otherwise, if a default property of the same name is defined in the device&rsquo;s registration information, that value is used.</li>
+<li>Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.</li>
+</ol>
+
+<p>Note that of the standard AMQP 1.0 message properties only the <em>content-type</em> and <em>ttl</em> can be set this way to a default value.</p>
+
+<h3 id="event-message-time-to-live">Event Message Time-to-live</h3>
+
+<p>Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers.
+In most cases the AMQP Messaging Network can be configured with a maximum <em>time-to-live</em> to apply to the events so that the events will be removed
+from the persistent store if no consumer has attached to receive the event before the message expires.</p>
+
+<p>In order to support environments where the AMQP Messaging Network cannot be configured accordingly, the protocol adapter supports setting a
+downstream event message&rsquo;s <em>ttl</em> property based on the <em>hono-ttl</em> property set as a header or a query parameter in the event requests by the devices.
+Also the default <em>ttl</em> and <em>max-ttl</em> values can be configured for a tenant/device as described in the <a href="/hono/docs/1.2/api/tenant/#resource-limits-configuration-format">Tenant API</a>.</p>
+
+<h2 id="tenant-specific-configuration">Tenant specific Configuration</h2>
+
+<p>The adapter uses the <a href="/hono/docs/1.2/api/tenant/#get-tenant-information">Tenant API</a> to retrieve <em>tenant specific configuration</em> for adapter type <code>hono-http</code>.
+The following properties are (currently) supported:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="left">Type</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>enabled</em></td>
+<td align="left"><em>boolean</em></td>
+<td align="left"><code>true</code></td>
+<td align="left">If set to <code>false</code> the adapter will reject all data from devices belonging to the tenant.</td>
+</tr>
+
+<tr>
+<td align="left"><em>max-ttd</em></td>
+<td align="left"><em>integer</em></td>
+<td align="left"><code>60</code></td>
+<td align="left">Defines a tenant specific upper limit for the <em>time until disconnect</em> property that devices may include in requests for uploading telemetry data or events. Please refer to the <a href="/hono/docs/1.2/concepts/command-and-control/">Command &amp; Control concept page</a> for a discussion of this parameter&rsquo;s purpose and usage.<br>This property can be set for the <code>hono-http</code> adapter type as an <em>extension</em> property in the adapter section of the tenant configuration.<br>If it is not set, then the default value of <code>60</code> seconds is used.</td>
+</tr>
+</tbody>
+</table>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/user-guide/index.html b/docs/1.2/user-guide/index.html
new file mode 100644
index 0000000..b30d19a
--- /dev/null
+++ b/docs/1.2/user-guide/index.html
@@ -0,0 +1,2454 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>User Guide :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="User Guide :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="User Guide :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/user-guide//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/user-guide/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        parent
+        active
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/user-guide/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/user-guide/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/user-guide/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/user-guide/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/user-guide/_index.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > User Guide
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+              </div>
+            </div>
+            
+
+        
+          <div id="chapter">
+        
+        <div id="body-inner">
+          
+
+        
+
+
+
+
+<h1 id="user-guide">User Guide</h1>
+
+<p>Learn how Eclipse Hono&trade; enables you to quickly send data from devices to business applications and vice versa.</p>
+
+
+<footer class=" footline" >
+	
+</footer>
+
+        
+            </div> 
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
diff --git a/docs/1.2/user-guide/index.xml b/docs/1.2/user-guide/index.xml
new file mode 100644
index 0000000..926015d
--- /dev/null
+++ b/docs/1.2/user-guide/index.xml
@@ -0,0 +1,87 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>User Guide on Eclipse Hono&amp;trade; Vers.: 1.2</title>
+    <link>https://www.eclipse.org/hono/docs/1.2/user-guide/</link>
+    <description>Recent content in User Guide on Eclipse Hono&amp;trade; Vers.: 1.2</description>
+    <generator>Hugo -- gohugo.io</generator>
+    <language>en-us</language>
+    
+	<atom:link href="https://www.eclipse.org/hono/docs/1.2/user-guide/index.xml" rel="self" type="application/rss+xml" />
+    
+    
+    <item>
+      <title>Device Registry</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/user-guide/device-registry/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/user-guide/device-registry/</guid>
+      <description>&lt;p&gt;The Device Registry component provides exemplary implementations of Hono&amp;rsquo;s &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/tenant/&#34;&gt;Tenant API&lt;/a&gt;, &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/device-registration/&#34;&gt;Device Registration API&lt;/a&gt; and &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/1.2/api/credentials/&#34;&gt;Credentials API&lt;/a&gt;.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>HTTP Adapter</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/user-guide/http-adapter/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/user-guide/http-adapter/</guid>
+      <description>&lt;p&gt;The HTTP protocol adapter exposes HTTP based endpoints for Eclipse Hono&amp;trade;&amp;rsquo;s south bound Telemetry, Event and Command &amp;amp; Control APIs.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>MQTT Adapter</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/user-guide/mqtt-adapter/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/user-guide/mqtt-adapter/</guid>
+      <description>&lt;p&gt;The MQTT protocol adapter exposes an MQTT topic hierarchy for publishing telemetry data and events to downstream consumers and for receiving commands from applications and sending back responses.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>AMQP Adapter</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/user-guide/amqp-adapter/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/user-guide/amqp-adapter/</guid>
+      <description>&lt;p&gt;The AMQP protocol adapter allows clients (devices or gateway components) supporting the AMQP 1.0 protocol to publish messages to Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry, Event and Command &amp;amp; Control endpoints.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>CoAP Adapter</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/user-guide/coap-adapter/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/user-guide/coap-adapter/</guid>
+      <description>&lt;p&gt;The CoAP protocol adapter exposes &lt;a href=&#34;https://tools.ietf.org/html/rfc7252&#34;&gt;CoAP&lt;/a&gt; based endpoints for Eclipse Hono&amp;trade;&amp;rsquo;s south bound Telemetry, Event and Command &amp;amp; Control APIs.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Kura Adapter</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/user-guide/kura-adapter/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/user-guide/kura-adapter/</guid>
+      <description>&lt;p&gt;The Kura protocol adapter exposes an MQTT topic hierarchy allowing Eclipse Kura&amp;trade; based gateways to publish &lt;em&gt;control&lt;/em&gt; and &lt;em&gt;data&lt;/em&gt; messages to Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry and Event endpoints.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Sigfox Adapter</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/user-guide/sigfox-adapter/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/user-guide/sigfox-adapter/</guid>
+      <description>&lt;p&gt;The Sigfox protocol adapter exposes an HTTP endpoint for connecting up with
+the Sigfox backend for publishing telemetry, events and use command &amp;amp; control.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>Load Tests with JMeter</title>
+      <link>https://www.eclipse.org/hono/docs/1.2/user-guide/jmeter_load_tests/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/1.2/user-guide/jmeter_load_tests/</guid>
+      <description>&lt;p&gt;Eclipse Hono&amp;trade; comes with an &lt;a href=&#34;https://jmeter.apache.org&#34;&gt;Apache JMeter&lt;/a&gt; plugin which provides &lt;em&gt;samplers&lt;/em&gt; that can be used in JMeter test plans to send and receive telemetry/event data.&lt;/p&gt;</description>
+    </item>
+    
+  </channel>
+</rss>
\ No newline at end of file
diff --git a/docs/1.2/user-guide/jmeter-overview.odg b/docs/1.2/user-guide/jmeter-overview.odg
new file mode 100644
index 0000000..46b0c5e
--- /dev/null
+++ b/docs/1.2/user-guide/jmeter-overview.odg
Binary files differ
diff --git a/docs/1.2/user-guide/jmeter-overview.svg b/docs/1.2/user-guide/jmeter-overview.svg
new file mode 100644
index 0000000..73965a8
--- /dev/null
+++ b/docs/1.2/user-guide/jmeter-overview.svg
@@ -0,0 +1,527 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.2" width="192mm" height="134mm" viewBox="0 0 19200 13400" preserveAspectRatio="xMidYMid" fill-rule="evenodd" stroke-width="28.222" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" xmlns:ooo="http://xml.openoffice.org/svg/export" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:presentation="http://sun.com/xmlns/staroffice/presentation" xmlns:smil="http://www.w3.org/2001/SMIL20/" xmlns:anim="urn:oasis:names:tc:opendocument:xmlns:animation:1.0" xml:space="preserve">
+ <defs class="ClipPathGroup">
+  <clipPath id="presentation_clip_path" clipPathUnits="userSpaceOnUse">
+   <rect x="0" y="0" width="19200" height="13400"/>
+  </clipPath>
+  <clipPath id="presentation_clip_path_shrink" clipPathUnits="userSpaceOnUse">
+   <rect x="19" y="13" width="19162" height="13374"/>
+  </clipPath>
+ </defs>
+ <defs>
+  <font id="EmbeddedFont_1" horiz-adv-x="2048">
+   <font-face font-family="Liberation Sans embedded" units-per-em="2048" font-weight="normal" font-style="normal" ascent="1852" descent="423"/>
+   <missing-glyph horiz-adv-x="2048" d="M 0,0 L 2047,0 2047,2047 0,2047 0,0 Z"/>
+   <glyph unicode="w" horiz-adv-x="1509" d="M 1174,0 L 965,0 776,765 740,934 C 734,904 725,861 712,805 699,748 631,480 508,0 L 300,0 -3,1082 175,1082 358,347 C 363,331 377,265 401,149 L 418,223 644,1082 837,1082 1026,339 1072,149 1103,288 1308,1082 1484,1082 1174,0 Z"/>
+   <glyph unicode="v" horiz-adv-x="1033" d="M 613,0 L 400,0 7,1082 199,1082 437,378 C 446,351 469,272 506,141 L 541,258 580,376 826,1082 1017,1082 613,0 Z"/>
+   <glyph unicode="u" horiz-adv-x="874" d="M 314,1082 L 314,396 C 314,325 321,269 335,230 349,191 371,162 402,145 433,128 478,119 537,119 624,119 692,149 742,208 792,267 817,350 817,455 L 817,1082 997,1082 997,231 C 997,105 999,28 1003,0 L 833,0 C 832,3 832,12 831,27 830,42 830,59 829,78 828,97 826,132 825,185 L 822,185 C 781,110 733,58 679,27 624,-4 557,-20 476,-20 357,-20 271,10 216,69 161,128 133,225 133,361 L 133,1082 314,1082 Z"/>
+   <glyph unicode="t" horiz-adv-x="531" d="M 554,8 C 495,-8 434,-16 372,-16 228,-16 156,66 156,229 L 156,951 31,951 31,1082 163,1082 216,1324 336,1324 336,1082 536,1082 536,951 336,951 336,268 C 336,216 345,180 362,159 379,138 408,127 450,127 474,127 509,132 554,141 L 554,8 Z"/>
+   <glyph unicode="s" horiz-adv-x="901" d="M 950,299 C 950,197 912,118 835,63 758,8 650,-20 511,-20 376,-20 273,2 200,47 127,91 79,160 57,254 L 216,285 C 231,227 263,185 311,158 359,131 426,117 511,117 602,117 669,131 712,159 754,187 775,229 775,285 775,328 760,362 731,389 702,416 654,438 589,455 L 460,489 C 357,516 283,542 240,568 196,593 162,624 137,661 112,698 100,743 100,796 100,895 135,970 206,1022 276,1073 378,1099 513,1099 632,1099 727,1078 798,1036 868,994 912,927 931,834 L 769,814 C 759,862 732,899 689,925 645,950 586,963 513,963 432,963 372,951 333,926 294,901 275,864 275,814 275,783 283,758 299,738 315,718 339,701 370,687 401,673 467,654 568,629 663,605 732,583 774,563 816,542 849,520 874,495 898,470 917,442 930,410 943,377 950,340 950,299 Z"/>
+   <glyph unicode="r" horiz-adv-x="530" d="M 142,0 L 142,830 C 142,906 140,990 136,1082 L 306,1082 C 311,959 314,886 314,861 L 318,861 C 347,954 380,1017 417,1051 454,1085 507,1102 575,1102 599,1102 623,1099 648,1092 L 648,927 C 624,934 592,937 552,937 477,937 420,905 381,841 342,776 322,684 322,564 L 322,0 142,0 Z"/>
+   <glyph unicode="q" horiz-adv-x="927" d="M 484,-20 C 347,-20 246,26 182,119 118,212 86,351 86,536 86,913 219,1102 484,1102 566,1102 634,1088 687,1059 740,1030 785,981 821,914 L 823,914 C 823,934 824,969 827,1018 830,1067 832,1093 835,1096 L 1008,1096 C 1003,1057 1001,958 1001,801 L 1001,-425 821,-425 821,14 825,178 823,178 C 787,107 743,56 690,26 637,-5 569,-20 484,-20 Z M 821,554 C 821,695 798,799 752,867 706,935 633,969 532,969 441,969 375,935 335,867 295,799 275,691 275,542 275,391 295,282 336,217 376,152 441,119 530,119 632,119 706,155 752,228 798,301 821,409 821,554 Z"/>
+   <glyph unicode="p" horiz-adv-x="953" d="M 1053,546 C 1053,169 920,-20 655,-20 488,-20 376,43 319,168 L 314,168 C 317,163 318,106 318,-2 L 318,-425 138,-425 138,861 C 138,972 136,1046 132,1082 L 306,1082 C 307,1079 308,1070 309,1054 310,1037 312,1012 314,978 315,944 316,921 316,908 L 320,908 C 352,975 394,1024 447,1055 500,1086 569,1101 655,1101 788,1101 888,1056 954,967 1020,878 1053,737 1053,546 Z M 864,542 C 864,693 844,800 803,865 762,930 698,962 609,962 538,962 482,947 442,917 401,887 371,840 350,777 329,713 318,630 318,528 318,386 341,281 386,214 431,147 505,113 607,113 696,113 762,146 803,212 844,277 864,387 864,542 Z"/>
+   <glyph unicode="o" horiz-adv-x="980" d="M 1053,542 C 1053,353 1011,212 928,119 845,26 724,-20 565,-20 407,-20 288,28 207,125 126,221 86,360 86,542 86,915 248,1102 571,1102 736,1102 858,1057 936,966 1014,875 1053,733 1053,542 Z M 864,542 C 864,691 842,800 798,868 753,935 679,969 574,969 469,969 393,935 346,866 299,797 275,689 275,542 275,399 298,292 345,221 391,149 464,113 563,113 671,113 748,148 795,217 841,286 864,395 864,542 Z"/>
+   <glyph unicode="n" horiz-adv-x="874" d="M 825,0 L 825,686 C 825,757 818,813 804,852 790,891 768,920 737,937 706,954 661,963 602,963 515,963 447,933 397,874 347,815 322,732 322,627 L 322,0 142,0 142,851 C 142,977 140,1054 136,1082 L 306,1082 C 307,1079 307,1070 308,1055 309,1040 310,1024 311,1005 312,986 313,950 314,897 L 317,897 C 358,972 406,1025 461,1056 515,1087 582,1102 663,1102 782,1102 869,1073 924,1014 979,955 1006,857 1006,721 L 1006,0 825,0 Z"/>
+   <glyph unicode="m" horiz-adv-x="1457" d="M 768,0 L 768,686 C 768,791 754,863 725,903 696,943 645,963 570,963 493,963 433,934 388,875 343,816 321,734 321,627 L 321,0 142,0 142,851 C 142,977 140,1054 136,1082 L 306,1082 C 307,1079 307,1070 308,1055 309,1040 310,1024 311,1005 312,986 313,950 314,897 L 317,897 C 356,974 400,1027 450,1057 500,1087 561,1102 633,1102 715,1102 780,1086 828,1053 875,1020 908,968 927,897 L 930,897 C 967,970 1013,1022 1066,1054 1119,1086 1183,1102 1258,1102 1367,1102 1447,1072 1497,1013 1546,954 1571,856 1571,721 L 1571,0 1393,0 1393,686 C 1393,791 1379,863 1350,903 1321,943 1270,963 1195,963 1116,963 1055,934 1012,876 968,817 946,734 946,627 L 946,0 768,0 Z"/>
+   <glyph unicode="l" horiz-adv-x="187" d="M 138,0 L 138,1484 318,1484 318,0 138,0 Z"/>
+   <glyph unicode="k" horiz-adv-x="901" d="M 816,0 L 450,494 318,385 318,0 138,0 138,1484 318,1484 318,557 793,1082 1004,1082 565,617 1027,0 816,0 Z"/>
+   <glyph unicode="i" horiz-adv-x="187" d="M 137,1312 L 137,1484 317,1484 317,1312 137,1312 Z M 137,0 L 137,1082 317,1082 317,0 137,0 Z"/>
+   <glyph unicode="h" horiz-adv-x="874" d="M 317,897 C 356,968 402,1020 457,1053 511,1086 580,1102 663,1102 780,1102 867,1073 923,1015 978,956 1006,858 1006,721 L 1006,0 825,0 825,686 C 825,762 818,819 804,856 790,893 767,920 735,937 703,954 659,963 602,963 517,963 450,934 399,875 348,816 322,737 322,638 L 322,0 142,0 142,1484 322,1484 322,1098 C 322,1057 321,1015 319,972 316,929 315,904 314,897 L 317,897 Z"/>
+   <glyph unicode="g" horiz-adv-x="927" d="M 548,-425 C 430,-425 336,-402 266,-356 196,-309 151,-243 131,-158 L 312,-132 C 324,-182 351,-220 392,-248 433,-274 486,-288 553,-288 732,-288 822,-183 822,27 L 822,201 820,201 C 786,132 739,80 680,45 621,10 551,-8 472,-8 339,-8 242,36 180,124 117,212 86,350 86,539 86,730 120,872 187,963 254,1054 355,1099 492,1099 569,1099 635,1082 692,1047 748,1012 791,962 822,897 L 824,897 C 824,917 825,952 828,1001 831,1050 833,1077 836,1082 L 1007,1082 C 1003,1046 1001,971 1001,858 L 1001,31 C 1001,-273 850,-425 548,-425 Z M 822,541 C 822,629 810,705 786,769 762,832 728,881 685,915 641,948 591,965 536,965 444,965 377,932 335,865 293,798 272,690 272,541 272,393 292,287 331,222 370,157 438,125 533,125 590,125 640,142 684,175 728,208 762,256 786,319 810,381 822,455 822,541 Z"/>
+   <glyph unicode="e" horiz-adv-x="980" d="M 276,503 C 276,379 302,283 353,216 404,149 479,115 578,115 656,115 719,131 766,162 813,193 844,233 861,281 L 1019,236 C 954,65 807,-20 578,-20 418,-20 296,28 213,123 129,218 87,360 87,548 87,727 129,864 213,959 296,1054 416,1102 571,1102 889,1102 1048,910 1048,527 L 1048,503 276,503 Z M 862,641 C 852,755 823,838 775,891 727,943 658,969 568,969 481,969 412,940 361,882 310,823 282,743 278,641 L 862,641 Z"/>
+   <glyph unicode="d" horiz-adv-x="927" d="M 821,174 C 788,105 744,55 689,25 634,-5 565,-20 484,-20 347,-20 247,26 183,118 118,210 86,349 86,536 86,913 219,1102 484,1102 566,1102 634,1087 689,1057 744,1027 788,979 821,914 L 823,914 821,1035 821,1484 1001,1484 1001,223 C 1001,110 1003,36 1007,0 L 835,0 C 833,11 831,35 829,74 826,113 825,146 825,174 L 821,174 Z M 275,542 C 275,391 295,282 335,217 375,152 440,119 530,119 632,119 706,154 752,225 798,296 821,405 821,554 821,697 798,802 752,869 706,936 633,969 532,969 441,969 376,936 336,869 295,802 275,693 275,542 Z"/>
+   <glyph unicode="c" horiz-adv-x="901" d="M 275,546 C 275,402 298,295 343,226 388,157 457,122 548,122 612,122 666,139 709,174 752,209 778,262 788,334 L 970,322 C 956,218 912,135 837,73 762,11 668,-20 553,-20 402,-20 286,28 207,124 127,219 87,359 87,542 87,724 127,863 207,959 287,1054 402,1102 551,1102 662,1102 754,1073 827,1016 900,959 945,880 964,779 L 779,765 C 770,825 746,873 708,908 670,943 616,961 546,961 451,961 382,929 339,866 296,803 275,696 275,546 Z"/>
+   <glyph unicode="a" horiz-adv-x="1060" d="M 414,-20 C 305,-20 224,9 169,66 114,123 87,202 87,302 87,414 124,500 198,560 271,620 390,652 554,656 L 797,660 797,719 C 797,807 778,870 741,908 704,946 645,965 565,965 484,965 426,951 389,924 352,897 330,853 323,793 L 135,810 C 166,1005 310,1102 569,1102 705,1102 807,1071 876,1009 945,946 979,856 979,738 L 979,272 C 979,219 986,179 1000,152 1014,125 1041,111 1080,111 1097,111 1117,113 1139,118 L 1139,6 C 1094,-5 1047,-10 1000,-10 933,-10 885,8 855,43 824,78 807,132 803,207 L 797,207 C 751,124 698,66 637,32 576,-3 501,-20 414,-20 Z M 455,115 C 521,115 580,130 631,160 682,190 723,231 753,284 782,336 797,390 797,445 L 797,534 600,530 C 515,529 451,520 408,504 364,488 330,463 307,430 284,397 272,353 272,299 272,240 288,195 320,163 351,131 396,115 455,115 Z"/>
+   <glyph unicode="T" horiz-adv-x="1192" d="M 720,1253 L 720,0 530,0 530,1253 46,1253 46,1409 1204,1409 1204,1253 720,1253 Z"/>
+   <glyph unicode="S" horiz-adv-x="1192" d="M 1272,389 C 1272,259 1221,158 1120,87 1018,16 875,-20 690,-20 347,-20 148,99 93,338 L 278,375 C 299,290 345,228 414,189 483,149 578,129 697,129 820,129 916,150 983,193 1050,235 1083,297 1083,379 1083,425 1073,462 1052,491 1031,520 1001,543 963,562 925,581 880,596 827,609 774,622 716,635 652,650 541,675 456,699 399,724 341,749 295,776 262,807 229,837 203,872 186,913 168,954 159,1000 159,1053 159,1174 205,1267 298,1332 390,1397 522,1430 694,1430 854,1430 976,1406 1061,1357 1146,1308 1205,1224 1239,1106 L 1051,1073 C 1030,1148 991,1202 933,1236 875,1269 795,1286 692,1286 579,1286 493,1267 434,1230 375,1193 345,1137 345,1063 345,1020 357,984 380,956 403,927 436,903 479,884 522,864 609,840 738,811 781,801 825,791 868,781 911,770 952,758 991,744 1030,729 1067,712 1102,693 1136,674 1166,650 1191,622 1216,594 1236,561 1251,523 1265,485 1272,440 1272,389 Z"/>
+   <glyph unicode="R" horiz-adv-x="1244" d="M 1164,0 L 798,585 359,585 359,0 168,0 168,1409 831,1409 C 990,1409 1112,1374 1199,1303 1285,1232 1328,1133 1328,1006 1328,901 1298,813 1237,742 1176,671 1091,626 984,607 L 1384,0 1164,0 Z M 1136,1004 C 1136,1086 1108,1149 1053,1192 997,1235 917,1256 812,1256 L 359,1256 359,736 820,736 C 921,736 999,760 1054,807 1109,854 1136,919 1136,1004 Z"/>
+   <glyph unicode="Q" horiz-adv-x="1430" d="M 1495,711 C 1495,512 1445,349 1345,221 1245,93 1106,17 928,-6 955,-90 991,-151 1036,-188 1080,-225 1136,-244 1204,-244 1241,-244 1279,-240 1319,-231 L 1319,-365 C 1257,-380 1198,-387 1141,-387 1040,-387 958,-358 893,-302 828,-244 774,-149 733,-16 601,-9 487,24 392,85 296,145 223,229 173,337 122,444 97,569 97,711 97,936 159,1113 282,1240 405,1367 577,1430 797,1430 940,1430 1065,1402 1170,1345 1275,1288 1356,1205 1412,1096 1467,987 1495,859 1495,711 Z M 1300,711 C 1300,886 1256,1024 1169,1124 1081,1224 957,1274 797,1274 636,1274 511,1225 423,1126 335,1027 291,889 291,711 291,534 336,394 425,291 514,187 637,135 795,135 958,135 1083,185 1170,286 1257,386 1300,528 1300,711 Z"/>
+   <glyph unicode="P" horiz-adv-x="1112" d="M 1258,985 C 1258,852 1215,746 1128,667 1041,588 922,549 773,549 L 359,549 359,0 168,0 168,1409 761,1409 C 919,1409 1041,1372 1128,1298 1215,1224 1258,1120 1258,985 Z M 1066,983 C 1066,1165 957,1256 738,1256 L 359,1256 359,700 746,700 C 959,700 1066,794 1066,983 Z"/>
+   <glyph unicode="N" horiz-adv-x="1165" d="M 1082,0 L 328,1200 333,1103 338,936 338,0 168,0 168,1409 390,1409 1152,201 C 1144,332 1140,426 1140,485 L 1140,1409 1312,1409 1312,0 1082,0 Z"/>
+   <glyph unicode="M" horiz-adv-x="1377" d="M 1366,0 L 1366,940 C 1366,1044 1369,1144 1375,1240 1342,1121 1313,1027 1287,960 L 923,0 789,0 420,960 364,1130 331,1240 334,1129 338,940 338,0 168,0 168,1409 419,1409 794,432 C 807,393 820,351 833,306 845,261 853,228 857,208 862,235 874,275 891,330 908,384 919,418 925,432 L 1293,1409 1538,1409 1538,0 1366,0 Z"/>
+   <glyph unicode="J" horiz-adv-x="848" d="M 457,-20 C 218,-20 77,103 32,350 L 219,381 C 231,304 258,243 300,200 342,157 395,135 458,135 527,135 582,159 622,207 662,254 682,324 682,416 L 682,1253 411,1253 411,1409 872,1409 872,420 C 872,283 835,176 761,98 687,19 586,-20 457,-20 Z"/>
+   <glyph unicode="I" horiz-adv-x="213" d="M 189,0 L 189,1409 380,1409 380,0 189,0 Z"/>
+   <glyph unicode="H" horiz-adv-x="1165" d="M 1121,0 L 1121,653 359,653 359,0 168,0 168,1409 359,1409 359,813 1121,813 1121,1409 1312,1409 1312,0 1121,0 Z"/>
+   <glyph unicode="A" horiz-adv-x="1377" d="M 1167,0 L 1006,412 364,412 202,0 4,0 579,1409 796,1409 1362,0 1167,0 Z M 685,1265 L 676,1237 C 659,1182 635,1111 602,1024 L 422,561 949,561 768,1026 C 749,1072 731,1124 712,1182 L 685,1265 Z"/>
+   <glyph unicode="1" horiz-adv-x="927" d="M 156,0 L 156,153 515,153 515,1237 197,1010 197,1180 530,1409 696,1409 696,153 1039,153 1039,0 156,0 Z"/>
+   <glyph unicode="0" horiz-adv-x="980" d="M 1059,705 C 1059,470 1018,290 935,166 852,42 729,-20 567,-20 405,-20 283,42 202,165 121,288 80,468 80,705 80,947 120,1128 199,1249 278,1370 402,1430 573,1430 739,1430 862,1369 941,1247 1020,1125 1059,944 1059,705 Z M 876,705 C 876,908 853,1056 806,1147 759,1238 681,1284 573,1284 462,1284 383,1239 335,1149 286,1059 262,911 262,705 262,505 287,359 336,266 385,173 462,127 569,127 675,127 753,174 802,269 851,364 876,509 876,705 Z"/>
+   <glyph unicode="." horiz-adv-x="213" d="M 187,0 L 187,219 382,219 382,0 187,0 Z"/>
+   <glyph unicode=" " horiz-adv-x="556"/>
+  </font>
+ </defs>
+ <defs class="TextShapeIndex">
+  <g ooo:slide="id1" ooo:id-list="id3 id4 id5 id6 id7 id8 id9 id10 id11 id12 id13 id14 id15 id16 id17 id18"/>
+ </defs>
+ <defs class="EmbeddedBulletChars">
+  <g id="bullet-char-template-57356" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M 580,1141 L 1163,571 580,0 -4,571 580,1141 Z"/>
+  </g>
+  <g id="bullet-char-template-57354" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M 8,1128 L 1137,1128 1137,0 8,0 8,1128 Z"/>
+  </g>
+  <g id="bullet-char-template-10146" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M 174,0 L 602,739 174,1481 1456,739 174,0 Z M 1358,739 L 309,1346 659,739 1358,739 Z"/>
+  </g>
+  <g id="bullet-char-template-10132" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M 2015,739 L 1276,0 717,0 1260,543 174,543 174,936 1260,936 717,1481 1274,1481 2015,739 Z"/>
+  </g>
+  <g id="bullet-char-template-10007" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M 0,-2 C -7,14 -16,27 -25,37 L 356,567 C 262,823 215,952 215,954 215,979 228,992 255,992 264,992 276,990 289,987 310,991 331,999 354,1012 L 381,999 492,748 772,1049 836,1024 860,1049 C 881,1039 901,1025 922,1006 886,937 835,863 770,784 769,783 710,716 594,584 L 774,223 C 774,196 753,168 711,139 L 727,119 C 717,90 699,76 672,76 641,76 570,178 457,381 L 164,-76 C 142,-110 111,-127 72,-127 30,-127 9,-110 8,-76 1,-67 -2,-52 -2,-32 -2,-23 -1,-13 0,-2 Z"/>
+  </g>
+  <g id="bullet-char-template-10004" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M 285,-33 C 182,-33 111,30 74,156 52,228 41,333 41,471 41,549 55,616 82,672 116,743 169,778 240,778 293,778 328,747 346,684 L 369,508 C 377,444 397,411 428,410 L 1163,1116 C 1174,1127 1196,1133 1229,1133 1271,1133 1292,1118 1292,1087 L 1292,965 C 1292,929 1282,901 1262,881 L 442,47 C 390,-6 338,-33 285,-33 Z"/>
+  </g>
+  <g id="bullet-char-template-9679" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M 813,0 C 632,0 489,54 383,161 276,268 223,411 223,592 223,773 276,916 383,1023 489,1130 632,1184 813,1184 992,1184 1136,1130 1245,1023 1353,916 1407,772 1407,592 1407,412 1353,268 1245,161 1136,54 992,0 813,0 Z"/>
+  </g>
+  <g id="bullet-char-template-8226" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M 346,457 C 273,457 209,483 155,535 101,586 74,649 74,723 74,796 101,859 155,911 209,963 273,989 346,989 419,989 480,963 531,910 582,859 608,796 608,723 608,648 583,586 532,535 482,483 420,457 346,457 Z"/>
+  </g>
+  <g id="bullet-char-template-8211" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M -4,459 L 1135,459 1135,606 -4,606 -4,459 Z"/>
+  </g>
+  <g id="bullet-char-template-61548" transform="scale(0.00048828125,-0.00048828125)">
+   <path d="M 173,740 C 173,903 231,1043 346,1159 462,1274 601,1332 765,1332 928,1332 1067,1274 1183,1159 1299,1043 1357,903 1357,740 1357,577 1299,437 1183,322 1067,206 928,148 765,148 601,148 462,206 346,322 231,437 173,577 173,740 Z"/>
+  </g>
+ </defs>
+ <defs class="TextEmbeddedBitmaps"/>
+ <g>
+  <g id="id2" class="Master_Slide">
+   <g id="bg-id2" class="Background"/>
+   <g id="bo-id2" class="BackgroundObjects"/>
+  </g>
+ </g>
+ <g class="SlideGroup">
+  <g>
+   <g id="container-id1">
+    <g id="id1" class="Slide" clip-path="url(#presentation_clip_path)">
+     <g class="Page">
+      <g class="com.sun.star.drawing.CustomShape">
+       <g id="id3">
+        <rect class="BoundingBox" stroke="none" fill="none" x="4886" y="1386" width="9329" height="4729"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9550,6100 L 9495,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9459,6100 L 9404,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9369,6100 L 9313,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9278,6100 L 9223,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9187,6100 L 9132,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9096,6100 L 9041,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9006,6100 L 8951,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8915,6100 L 8860,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8824,6100 L 8769,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8734,6100 L 8678,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8643,6100 L 8588,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8552,6100 L 8497,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8461,6100 L 8406,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8371,6100 L 8315,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8280,6100 L 8225,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8189,6100 L 8134,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8098,6100 L 8043,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8008,6100 L 7953,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7917,6100 L 7862,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7826,6100 L 7771,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7736,6100 L 7680,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7645,6100 L 7590,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7554,6100 L 7499,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7463,6100 L 7408,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7373,6100 L 7318,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7282,6100 L 7227,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7191,6100 L 7136,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7101,6100 L 7045,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7010,6100 L 6955,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6919,6100 L 6864,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6828,6100 L 6773,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6738,6100 L 6683,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6647,6100 L 6592,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6556,6100 L 6501,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6466,6100 L 6410,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6375,6100 L 6320,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6284,6100 L 6229,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6193,6100 L 6138,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6103,6100 L 6047,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6012,6100 L 5957,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5921,6100 L 5866,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5830,6100 L 5775,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5740,6100 L 5685,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5649,6100 L 5594,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5558,6100 L 5503,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5468,6100 L 5412,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5377,6100 L 5322,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5286,6100 L 5231,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5195,6100 L 5140,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5105,6100 L 5050,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5014,6100 L 4959,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4923,6100 L 4900,6100 4900,6068"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,6033 L 4900,5977"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,5942 L 4900,5887"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,5851 L 4900,5796"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,5760 L 4900,5705"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,5670 L 4900,5615"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,5579 L 4900,5524"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,5488 L 4900,5433"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,5398 L 4900,5342"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,5307 L 4900,5252"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,5216 L 4900,5161"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,5125 L 4900,5070"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,5035 L 4900,4979"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,4944 L 4900,4889"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,4853 L 4900,4798"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,4762 L 4900,4707"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,4672 L 4900,4617"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,4581 L 4900,4526"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,4490 L 4900,4435"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,4400 L 4900,4344"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,4309 L 4900,4254"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,4218 L 4900,4163"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,4127 L 4900,4072"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,4037 L 4900,3982"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,3946 L 4900,3891"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,3855 L 4900,3800"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,3765 L 4900,3709"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,3674 L 4900,3619"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,3583 L 4900,3528"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,3492 L 4900,3437"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,3402 L 4900,3347"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,3311 L 4900,3256"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,3220 L 4900,3165"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,3130 L 4900,3074"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,3039 L 4900,2984"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,2948 L 4900,2893"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,2857 L 4900,2802"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,2767 L 4900,2711"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,2676 L 4900,2621"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,2585 L 4900,2530"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,2494 L 4900,2439"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,2404 L 4900,2349"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,2313 L 4900,2258"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,2222 L 4900,2167"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,2132 L 4900,2076"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,2041 L 4900,1986"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,1950 L 4900,1895"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,1859 L 4900,1804"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,1769 L 4900,1714"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,1678 L 4900,1623"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,1587 L 4900,1532"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,1497 L 4900,1441"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4900,1406 L 4900,1400 4949,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 4985,1400 L 5040,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5076,1400 L 5131,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5166,1400 L 5221,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5257,1400 L 5312,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5348,1400 L 5403,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5438,1400 L 5494,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5529,1400 L 5584,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5620,1400 L 5675,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5711,1400 L 5766,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5801,1400 L 5857,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5892,1400 L 5947,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 5983,1400 L 6038,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6074,1400 L 6129,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6164,1400 L 6219,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6255,1400 L 6310,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6346,1400 L 6401,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6436,1400 L 6492,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6527,1400 L 6582,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6618,1400 L 6673,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6709,1400 L 6764,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6799,1400 L 6854,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6890,1400 L 6945,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 6981,1400 L 7036,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7071,1400 L 7127,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7162,1400 L 7217,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7253,1400 L 7308,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7344,1400 L 7399,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7434,1400 L 7489,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7525,1400 L 7580,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7616,1400 L 7671,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7706,1400 L 7762,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7797,1400 L 7852,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7888,1400 L 7943,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 7979,1400 L 8034,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8069,1400 L 8125,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8160,1400 L 8215,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8251,1400 L 8306,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8342,1400 L 8397,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8432,1400 L 8487,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8523,1400 L 8578,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8614,1400 L 8669,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8704,1400 L 8760,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8795,1400 L 8850,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8886,1400 L 8941,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 8977,1400 L 9032,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9067,1400 L 9122,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9158,1400 L 9213,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9249,1400 L 9304,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9339,1400 L 9395,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9430,1400 L 9485,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9521,1400 L 9576,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9612,1400 L 9667,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9702,1400 L 9757,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9793,1400 L 9848,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9884,1400 L 9939,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9974,1400 L 10030,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10065,1400 L 10120,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10156,1400 L 10211,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10247,1400 L 10302,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10337,1400 L 10393,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10428,1400 L 10483,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10519,1400 L 10574,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10610,1400 L 10665,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10700,1400 L 10755,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10791,1400 L 10846,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10882,1400 L 10937,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10972,1400 L 11028,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11063,1400 L 11118,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11154,1400 L 11209,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11245,1400 L 11300,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11335,1400 L 11390,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11426,1400 L 11481,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11517,1400 L 11572,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11607,1400 L 11663,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11698,1400 L 11753,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11789,1400 L 11844,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11880,1400 L 11935,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11970,1400 L 12025,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12061,1400 L 12116,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12152,1400 L 12207,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12242,1400 L 12298,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12333,1400 L 12388,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12424,1400 L 12479,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12515,1400 L 12570,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12605,1400 L 12661,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12696,1400 L 12751,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12787,1400 L 12842,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12878,1400 L 12933,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12968,1400 L 13023,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13059,1400 L 13114,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13150,1400 L 13205,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13240,1400 L 13296,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13331,1400 L 13386,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13422,1400 L 13477,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13513,1400 L 13568,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13603,1400 L 13658,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13694,1400 L 13749,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13785,1400 L 13840,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13875,1400 L 13931,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13966,1400 L 14021,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14057,1400 L 14112,1400"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14148,1400 L 14200,1400 14200,1403"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,1438 L 14200,1493"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,1529 L 14200,1584"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,1620 L 14200,1675"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,1710 L 14200,1766"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,1801 L 14200,1856"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,1892 L 14200,1947"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,1983 L 14200,2038"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,2073 L 14200,2129"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,2164 L 14200,2219"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,2255 L 14200,2310"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,2346 L 14200,2401"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,2436 L 14200,2491"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,2527 L 14200,2582"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,2618 L 14200,2673"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,2708 L 14200,2764"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,2799 L 14200,2854"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,2890 L 14200,2945"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,2981 L 14200,3036"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,3071 L 14200,3126"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,3162 L 14200,3217"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,3253 L 14200,3308"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,3343 L 14200,3399"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,3434 L 14200,3489"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,3525 L 14200,3580"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,3616 L 14200,3671"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,3706 L 14200,3761"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,3797 L 14200,3852"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,3888 L 14200,3943"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,3978 L 14200,4034"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,4069 L 14200,4124"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,4160 L 14200,4215"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,4251 L 14200,4306"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,4341 L 14200,4397"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,4432 L 14200,4487"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,4523 L 14200,4578"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,4614 L 14200,4669"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,4704 L 14200,4759"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,4795 L 14200,4850"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,4886 L 14200,4941"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,4976 L 14200,5032"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,5067 L 14200,5122"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,5158 L 14200,5213"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,5249 L 14200,5304"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,5339 L 14200,5394"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,5430 L 14200,5485"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,5521 L 14200,5576"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,5611 L 14200,5667"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,5702 L 14200,5757"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,5793 L 14200,5848"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,5884 L 14200,5939"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,5974 L 14200,6029"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14200,6065 L 14200,6100 14180,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14144,6100 L 14089,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 14054,6100 L 13998,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13963,6100 L 13908,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13872,6100 L 13817,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13781,6100 L 13726,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13691,6100 L 13635,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13600,6100 L 13545,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13509,6100 L 13454,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13418,6100 L 13363,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13328,6100 L 13273,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13237,6100 L 13182,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13146,6100 L 13091,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 13056,6100 L 13000,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12965,6100 L 12910,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12874,6100 L 12819,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12783,6100 L 12728,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12693,6100 L 12638,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12602,6100 L 12547,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12511,6100 L 12456,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12421,6100 L 12365,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12330,6100 L 12275,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12239,6100 L 12184,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12148,6100 L 12093,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 12058,6100 L 12003,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11967,6100 L 11912,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11876,6100 L 11821,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11786,6100 L 11730,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11695,6100 L 11640,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11604,6100 L 11549,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11513,6100 L 11458,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11423,6100 L 11367,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11332,6100 L 11277,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11241,6100 L 11186,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11150,6100 L 11095,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 11060,6100 L 11005,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10969,6100 L 10914,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10878,6100 L 10823,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10788,6100 L 10732,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10697,6100 L 10642,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10606,6100 L 10551,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10515,6100 L 10460,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10425,6100 L 10370,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10334,6100 L 10279,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10243,6100 L 10188,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10153,6100 L 10097,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 10062,6100 L 10007,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9971,6100 L 9916,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9880,6100 L 9825,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9790,6100 L 9735,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9699,6100 L 9644,6100"/>
+        <path fill="none" stroke="rgb(178,178,178)" stroke-width="28" stroke-linejoin="round" d="M 9608,6100 L 9553,6100"/>
+        <text class="TextShape"><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="494px" font-weight="400"><tspan class="TextPosition" x="7783" y="1988"><tspan fill="rgb(153,153,153)" stroke="none">JMeter Instance</tspan></tspan></tspan></text>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.CustomShape">
+       <g id="id4">
+        <rect class="BoundingBox" stroke="none" fill="none" x="10099" y="2799" width="3703" height="3003"/>
+        <path fill="rgb(255,149,14)" stroke="none" d="M 11950,5800 L 10100,5800 10100,2800 13800,2800 13800,5800 11950,5800 Z"/>
+        <path fill="none" stroke="rgb(0,0,0)" d="M 11950,5800 L 10100,5800 10100,2800 13800,2800 13800,5800 11950,5800 Z"/>
+        <text class="TextShape"><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="423px" font-weight="400"><tspan class="TextPosition" x="11442" y="3974"><tspan fill="rgb(0,0,0)" stroke="none">Hono</tspan></tspan></tspan><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="423px" font-weight="400"><tspan class="TextPosition" x="11114" y="4448"><tspan fill="rgb(0,0,0)" stroke="none">Receiver</tspan></tspan></tspan><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="423px" font-weight="400"><tspan class="TextPosition" x="11161" y="4922"><tspan fill="rgb(0,0,0)" stroke="none">Sampler</tspan></tspan></tspan></text>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.CustomShape">
+       <g id="id5">
+        <rect class="BoundingBox" stroke="none" fill="none" x="5299" y="4399" width="4503" height="1403"/>
+        <path fill="rgb(221,221,221)" stroke="none" d="M 7550,5800 L 5300,5800 5300,4400 9800,4400 9800,5800 7550,5800 Z"/>
+        <path fill="none" stroke="rgb(0,0,0)" d="M 7550,5800 L 5300,5800 5300,4400 9800,4400 9800,5800 7550,5800 Z"/>
+        <text class="TextShape"><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="423px" font-weight="400"><tspan class="TextPosition" x="5599" y="5248"><tspan fill="rgb(0,0,0)" stroke="none">MQTT JMeter Plugin</tspan></tspan></tspan></text>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.CustomShape">
+       <g id="id6">
+        <rect class="BoundingBox" stroke="none" fill="none" x="5299" y="2799" width="4503" height="1403"/>
+        <path fill="rgb(221,221,221)" stroke="none" d="M 7550,4200 L 5300,4200 5300,2800 9800,2800 9800,4200 7550,4200 Z"/>
+        <path fill="none" stroke="rgb(0,0,0)" d="M 7550,4200 L 5300,4200 5300,2800 9800,2800 9800,4200 7550,4200 Z"/>
+        <text class="TextShape"><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="423px" font-weight="400"><tspan class="TextPosition" x="6903" y="3411"><tspan fill="rgb(0,0,0)" stroke="none">JMeter</tspan></tspan></tspan><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="423px" font-weight="400"><tspan class="TextPosition" x="6153" y="3885"><tspan fill="rgb(0,0,0)" stroke="none">HTTP Sampler</tspan></tspan></tspan></text>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.CustomShape">
+       <g id="id7">
+        <rect class="BoundingBox" stroke="none" fill="none" x="5399" y="9599" width="4403" height="1103"/>
+        <path fill="rgb(255,149,14)" stroke="none" d="M 7600,10700 L 5400,10700 5400,9600 9800,9600 9800,10700 7600,10700 Z"/>
+        <path fill="none" stroke="rgb(0,0,0)" d="M 7600,10700 L 5400,10700 5400,9600 9800,9600 9800,10700 7600,10700 Z"/>
+        <text class="TextShape"><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="494px" font-weight="400"><tspan class="TextPosition" x="6038" y="10322"><tspan fill="rgb(0,0,0)" stroke="none">HTTP Adapter</tspan></tspan></tspan></text>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.CustomShape">
+       <g id="id8">
+        <rect class="BoundingBox" stroke="none" fill="none" x="12599" y="8099" width="4303" height="2603"/>
+        <path fill="rgb(221,221,221)" stroke="none" d="M 14750,10700 L 12600,10700 12600,8100 16900,8100 16900,10700 14750,10700 Z"/>
+        <path fill="none" stroke="rgb(0,0,0)" d="M 14750,10700 L 12600,10700 12600,8100 16900,8100 16900,10700 14750,10700 Z"/>
+        <text class="TextShape"><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="494px" font-weight="400"><tspan class="TextPosition" x="14022" y="9017"><tspan fill="rgb(0,0,0)" stroke="none">AMQP</tspan></tspan></tspan><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="494px" font-weight="400"><tspan class="TextPosition" x="13552" y="9572"><tspan fill="rgb(0,0,0)" stroke="none">Messaging</tspan></tspan></tspan><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="494px" font-weight="400"><tspan class="TextPosition" x="13842" y="10127"><tspan fill="rgb(0,0,0)" stroke="none">Network</tspan></tspan></tspan></text>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.ConnectorShape">
+       <g id="id9">
+        <rect class="BoundingBox" stroke="none" fill="none" x="3799" y="3499" width="1602" height="6802"/>
+        <path fill="none" stroke="rgb(0,0,0)" d="M 5300,3500 L 3800,3500 3800,10150 4970,10150"/>
+        <path fill="rgb(0,0,0)" stroke="none" d="M 5400,10150 L 4950,10000 4950,10300 5400,10150 Z"/>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.ConnectorShape">
+       <g id="id10">
+        <rect class="BoundingBox" stroke="none" fill="none" x="4499" y="5099" width="902" height="3752"/>
+        <path fill="none" stroke="rgb(0,0,0)" d="M 5300,5100 L 4500,5100 4500,8700 4970,8700"/>
+        <path fill="rgb(0,0,0)" stroke="none" d="M 5400,8700 L 4950,8550 4950,8850 5400,8700 Z"/>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.ConnectorShape">
+       <g id="id11">
+        <rect class="BoundingBox" stroke="none" fill="none" x="9799" y="9250" width="2802" height="902"/>
+        <path fill="none" stroke="rgb(255,149,14)" d="M 9800,10150 L 11200,10150 11200,9400 12170,9400"/>
+        <path fill="rgb(255,149,14)" stroke="none" d="M 12600,9400 L 12150,9250 12150,9550 12600,9400 Z"/>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.ConnectorShape">
+       <g id="id12">
+        <rect class="BoundingBox" stroke="none" fill="none" x="9799" y="8699" width="2802" height="852"/>
+        <path fill="none" stroke="rgb(255,149,14)" d="M 9800,8700 L 11200,8700 11200,9400 12170,9400"/>
+        <path fill="rgb(255,149,14)" stroke="none" d="M 12600,9400 L 12150,9250 12150,9550 12600,9400 Z"/>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.ConnectorShape">
+       <g id="id13">
+        <rect class="BoundingBox" stroke="none" fill="none" x="13800" y="4150" width="952" height="3952"/>
+        <path fill="none" stroke="rgb(255,149,14)" d="M 14750,8100 L 14750,4300 14230,4300"/>
+        <path fill="rgb(255,149,14)" stroke="none" d="M 13800,4300 L 14250,4450 14250,4150 13800,4300 Z"/>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.LineShape">
+       <g id="id14">
+        <rect class="BoundingBox" stroke="none" fill="none" x="8382" y="11782" width="1537" height="37"/>
+        <path fill="none" stroke="rgb(255,149,14)" stroke-width="35" stroke-linejoin="round" d="M 8400,11800 L 9900,11800"/>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.TextShape">
+       <g id="id15">
+        <rect class="BoundingBox" stroke="none" fill="none" x="10000" y="11500" width="2701" height="901"/>
+        <text class="TextShape"><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="423px" font-weight="400"><tspan class="TextPosition" x="10250" y="12010"><tspan fill="rgb(0,0,0)" stroke="none">AMQP 1.0</tspan></tspan></tspan></text>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.CustomShape">
+       <g id="id16">
+        <rect class="BoundingBox" stroke="none" fill="none" x="5399" y="8099" width="4403" height="1203"/>
+        <path fill="rgb(255,149,14)" stroke="none" d="M 7600,9300 L 5400,9300 5400,8100 9800,8100 9800,9300 7600,9300 Z"/>
+        <path fill="none" stroke="rgb(0,0,0)" d="M 7600,9300 L 5400,9300 5400,8100 9800,8100 9800,9300 7600,9300 Z"/>
+        <text class="TextShape"><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="494px" font-weight="400"><tspan class="TextPosition" x="5983" y="8872"><tspan fill="rgb(0,0,0)" stroke="none">MQTT Adapter</tspan></tspan></tspan></text>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.TextShape">
+       <g id="id17">
+        <rect class="BoundingBox" stroke="none" fill="none" x="2700" y="6700" width="1087" height="646"/>
+        <text class="TextShape"><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="353px" font-weight="400"><tspan class="TextPosition" x="2950" y="7143"><tspan fill="rgb(0,0,0)" stroke="none">http</tspan></tspan></tspan></text>
+       </g>
+      </g>
+      <g class="com.sun.star.drawing.TextShape">
+       <g id="id18">
+        <rect class="BoundingBox" stroke="none" fill="none" x="4500" y="6655" width="1185" height="646"/>
+        <text class="TextShape"><tspan class="TextParagraph" font-family="Liberation Sans, sans-serif" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4750" y="7098"><tspan fill="rgb(0,0,0)" stroke="none">mqtt</tspan></tspan></tspan></text>
+       </g>
+      </g>
+     </g>
+    </g>
+   </g>
+  </g>
+ </g>
+</svg>
\ No newline at end of file
diff --git a/docs/1.2/user-guide/jmeter_load_tests/index.html b/docs/1.2/user-guide/jmeter_load_tests/index.html
new file mode 100644
index 0000000..2d43537
--- /dev/null
+++ b/docs/1.2/user-guide/jmeter_load_tests/index.html
@@ -0,0 +1,2506 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Load Tests with JMeter :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Load Tests with JMeter :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Load Tests with JMeter :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/user-guide/jmeter_load_tests//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item active">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/user-guide/jmeter_load_tests/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/jmeter_load_tests/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/user-guide/jmeter_load_tests/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/user-guide/jmeter_load_tests/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/user-guide/jmeter_load_tests/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/user-guide/jmeter_load_tests.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/user-guide/'>User Guide</a> > Load Tests with JMeter
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#installation">Installation</a></li>
+<li><a href="#example-test-plans">Example Test Plans</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Load Tests with JMeter</h1>
+          
+
+        
+
+
+<p>Eclipse Hono&trade; comes with an <a href="https://jmeter.apache.org">Apache JMeter</a> plugin which provides <em>samplers</em> that can be used in JMeter test plans to send and receive telemetry/event data.</p>
+
+<p>The plugin provides a <em>Hono Receiver Sampler</em> which can be used together with JMeter&rsquo;s standard <em>HTTP Sampler</em> and XMeter&rsquo;s <a href="https://github.com/emqx/mqtt-jmeter">JMeter plugin for MQTT</a> to play the roles of a downstream application (consumer) and devices uploading data to the HTTP and MQTT protocol adapters. The diagram below illustrates how the components are related to each other.</p>
+
+<figure>
+    <img src="../jmeter-overview.svg"/> <figcaption>
+            <h4>JMeter with Hono</h4>
+        </figcaption>
+</figure>
+
+
+<h2 id="installation">Installation</h2>
+
+<ol>
+<li>Install <a href="https://jmeter.apache.org/download_jmeter.cgi">JMeter</a></li>
+<li>Copy the plugin jar file <code>&lt;hono-installation&gt;/jmeter/target/plugin/hono-jmeter-&lt;version&gt;-jar-with-dependencies.jar</code> to the  <code>&lt;jmeter-installation&gt;/lib/ext</code> folder.</li>
+<li>Start JMeter</li>
+</ol>
+
+<h2 id="example-test-plans">Example Test Plans</h2>
+
+<p>The <code>&lt;hono-installation&gt;/jmeter/src/jmeter</code> folder contains several JMeter test plans which you can use as a basis for your own tests. All test plans can be run against Hono&rsquo;s <a href="/hono/docs/1.2/deployment/">example deployment</a>.</p>
+
+<ol>
+<li><code>http_messaging_throughput_test.jmx</code> runs a set of HTTP clients and AMQP 1.0 consumers for a given period of time. The senders publish data to Hono&rsquo; HTTP adapter while the consumers receive messages from the AMQP 1.0 Messaging Network (in case of the example installation this is the Qpid Dispatch Router). The test plan measures the number of messages that are sent/received during the test execution.</li>
+<li><code>mqtt_messaging_throughput_test.jmx</code> runs a set of MQTT clients and AMQP 1.0 consumers for a given period of time. The clients publish data to Hono&rsquo; MQTT adapter while the consumers receive messages from the AMQP 1.0 Messaging Network (in case of the example installation this is the Qpid Dispatch Router). The test plan measures the number of messages that are sent/received during the test execution. To use this plan you also need to add the <a href="https://github.com/emqx/mqtt-jmeter">JMeter plugin for MQTT</a> to your JMeter plugin path.</li>
+<li><code>amqp_messaging_throughput_test.jmx</code> runs a set of AMQP 1.0 senders and consumers for a given period of time. The senders publish data to the AMQP 1.0 Messaging Network directly while the consumers receive messages from the AMQP 1.0 Messaging Network (in case of the example installation this is the Qpid Dispatch Router). The test plan measures the number of messages that are sent/received during the test execution.<br>
+The sender can be configured to wait for <em>n active receivers</em> (from this test plan and JMeter instance) which can be used to make sure, that the receivers consuming from the corresponding address (e.g. <code>telemetry/DEFAULT_TENANT</code>) are up and running before the senders begin to publish messages.</li>
+</ol>
+
+<p>It is recommended to run the test plans in <em>non-gui mode</em> as illustrated by the example shell scripts that are contained in the <code>&lt;hono-installation&gt;/jmeter/src/jmeter</code> folder. You may need to adapt some of the properties to reflect your concrete setup, e.g. the path to the trust store, host names, ports etc.</p>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/user-guide/kura-adapter/index.html b/docs/1.2/user-guide/kura-adapter/index.html
new file mode 100644
index 0000000..a08235e
--- /dev/null
+++ b/docs/1.2/user-guide/kura-adapter/index.html
@@ -0,0 +1,2581 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Kura Adapter :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Kura Adapter :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Kura Adapter :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/user-guide/kura-adapter//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/user-guide/kura-adapter/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item active">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/user-guide/kura-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/kura-adapter/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/user-guide/kura-adapter/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/user-guide/kura-adapter/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/user-guide/kura-adapter/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/user-guide/kura-adapter.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/user-guide/'>User Guide</a> > Kura Adapter
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#downstream-meta-data">Downstream Meta Data</a>
+<ul>
+<li><a href="#event-message-time-to-live">Event Message Time-to-live</a></li>
+</ul></li>
+<li><a href="#tenant-specific-configuration">Tenant specific Configuration</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Kura Adapter</h1>
+          
+
+        
+
+
+<p>The Kura protocol adapter exposes an MQTT topic hierarchy allowing Eclipse Kura&trade; based gateways to publish <em>control</em> and <em>data</em> messages to Eclipse Hono&trade;&rsquo;s Telemetry and Event endpoints.</p>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Note</h4>
+    <div>The Kura adapter is supposed to be used with gateways running Kura version 3.x. Gateways running Kura version 4 and later should connect to the MQTT adapter instead.</div>
+</div>
+
+
+<p>The Kura adapter by default requires devices (gateways) to authenticate during connection establishment. In order to do so, gateways need to provide a <em>username</em> and a <em>password</em> in the MQTT <em>CONNECT</em> packet. The <em>username</em> must have the form <em>auth-id@tenant</em>, e.g. <code>sensor1@DEFAULT_TENANT</code>. The adapter verifies the credentials provided by the gateway against the credentials the <a href="/hono/docs/1.2/admin-guide/common-config/#credentials-service-connection-configuration">configured Credentials service</a> has on record for the gateway. The adapter uses the Credentials API&rsquo;s <em>get</em> operation to retrieve the credentials-on-record with the <em>tenant</em> and <em>auth-id</em> provided by the device in the <em>username</em> and <code>hashed-password</code> as the <em>type</em> of secret as query parameters.</p>
+
+<p>Please refer to the <a href="http://eclipse.github.io/kura/config/cloud-services.html">Eclipse Kura documentation</a> on how to configure the gateway&rsquo;s cloud service connection accordingly. It is important to set the gateway&rsquo;s <em>topic.context.account-name</em> to the ID of the Hono tenant that the gateway has been registered with whereas the gateway&rsquo;s <em>client-id</em> needs to be set to the corresponding Hono device ID. The <em>auth-id</em> used as part of the gateway&rsquo;s <em>username</em> property needs to match the authentication identifier of a set of credentials registered for the device ID in Hono&rsquo;s Credentials service. In other words, the credentials configured on the gateway need to belong to the corresponding device ID.</p>
+
+<p>After verifying the credentials, the number of existing connections and the overall amount of time that the devices have already been connected are checked against the configured <a href="/hono/docs/1.2/concepts/resource-limits/">resource-limits</a> by the Kura adapter.  If the limit is exceeded then a return code <code>0x05</code> indicating <code>Connection Refused: not authorised</code> is sent back.</p>
+
+<p>Once the gateway has established a connection to the Kura adapter, all <em>control</em> and <em>data</em> messages published by applications running on the gateway are sent to the adapter and mapped to Hono&rsquo;s Telemetry and Event API endpoints as follows:</p>
+
+<ol>
+<li>The adapter treats all messages that are published to a topic starting with the configured <code>HONO_KURA_CONTROL_PREFIX</code> as control messages. All other messages are considered to be data messages.</li>
+<li><em>control</em> messages with QoS 0 are forwarded to Hono&rsquo;s telemetry endpoint whereas messages with QoS 1 are forwarded to the event endpoint. The corresponding AMQP 1.0 messages that are sent downstream have a content type of <code>application/vnd.eclipse.kura-control</code>.</li>
+<li><em>data</em> messages with QoS 0 are forwarded to the telemetry endpoint whereas messages with QoS 1 are forwarded to the event endpoint. The corresponding AMQP 1.0 messages that are sent downstream have a content type of <code>application/vnd.eclipse.kura-data</code>.</li>
+</ol>
+
+<h2 id="downstream-meta-data">Downstream Meta Data</h2>
+
+<p>The adapter includes the following meta data in messages being sent downstream:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="left">Location</th>
+<th align="left">Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>device_id</em></td>
+<td align="left"><em>application</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The identifier of the device that the message originates from.</td>
+</tr>
+
+<tr>
+<td align="left"><em>orig_adapter</em></td>
+<td align="left"><em>application</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">Contains the adapter&rsquo;s <em>type name</em> which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The Kura adapter&rsquo;s type name is <code>hono-kura-mqtt</code>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>orig_address</em></td>
+<td align="left"><em>application</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">Contains the name of the MQTT topic that the Kura gateway has originally published the data to.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The adapter also considers <em>defaults</em> registered for the device at either the <a href="/hono/docs/1.2/api/tenant/#tenant-information-format">tenant</a> or the <a href="/hono/docs/1.2/api/device-registration/#assert-device-registration">device level</a>. The values of the default properties are determined as follows:</p>
+
+<ol>
+<li>If the message already contains a non-empty property of the same name, the value if unchanged.</li>
+<li>Otherwise, if a default property of the same name is defined in the device&rsquo;s registration information, that value is used.</li>
+<li>Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.</li>
+</ol>
+
+<p>Note that of the standard AMQP 1.0 message properties only the <em>content-type</em> and <em>ttl</em> can be set this way to a default value.</p>
+
+<h3 id="event-message-time-to-live">Event Message Time-to-live</h3>
+
+<p>Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers.
+In most cases the AMQP Messaging Network can be configured with a maximum <em>time-to-live</em> to apply to the events so that the events will be removed
+from the persistent store if no consumer has attached to receive the event before the message expires.</p>
+
+<p>In order to support environments where the AMQP Messaging Network cannot be configured accordingly, the protocol adapter supports setting a
+downstream event message&rsquo;s <em>ttl</em> property based on the default <em>ttl</em> and <em>max-ttl</em> values configured for a tenant/device as described in the <a href="/hono/docs/1.2/api/tenant/#resource-limits-configuration-format">Tenant API</a>.</p>
+
+<h2 id="tenant-specific-configuration">Tenant specific Configuration</h2>
+
+<p>The adapter uses the <a href="/hono/docs/1.2/api/tenant/#get-tenant-information">Tenant API</a> to retrieve <em>tenant specific configuration</em> for adapter type <code>hono-kura-mqtt</code>.
+The following properties are (currently) supported:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="left">Type</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>enabled</em></td>
+<td align="left"><em>boolean</em></td>
+<td align="left"><code>true</code></td>
+<td align="left">If set to <code>false</code> the adapter will reject all data from devices belonging to the tenant.</td>
+</tr>
+</tbody>
+</table>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/user-guide/mqtt-adapter/index.html b/docs/1.2/user-guide/mqtt-adapter/index.html
new file mode 100644
index 0000000..82d73e6
--- /dev/null
+++ b/docs/1.2/user-guide/mqtt-adapter/index.html
@@ -0,0 +1,3034 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>MQTT Adapter :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="MQTT Adapter :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="MQTT Adapter :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/user-guide/mqtt-adapter//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/user-guide/mqtt-adapter/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item active">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/user-guide/mqtt-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/mqtt-adapter/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/user-guide/mqtt-adapter/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/user-guide/mqtt-adapter/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/user-guide/mqtt-adapter/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/user-guide/mqtt-adapter.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/user-guide/'>User Guide</a> > MQTT Adapter
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#authentication">Authentication</a>
+<ul>
+<li><a href="#client-certificate">Client Certificate</a></li>
+<li><a href="#username-password">Username/Password</a></li>
+</ul></li>
+<li><a href="#resource-limit-checks">Resource Limit Checks</a>
+<ul>
+<li><a href="#connection-limits">Connection Limits</a></li>
+<li><a href="#connection-duration-limits">Connection Duration Limits</a></li>
+<li><a href="#message-limits">Message Limits</a></li>
+</ul></li>
+<li><a href="#connection-event">Connection Event</a></li>
+<li><a href="#publishing-telemetry-data">Publishing Telemetry Data</a></li>
+<li><a href="#publish-telemetry-data-authenticated-device">Publish Telemetry Data (authenticated Device)</a></li>
+<li><a href="#publish-telemetry-data-unauthenticated-device">Publish Telemetry Data (unauthenticated Device)</a></li>
+<li><a href="#publish-telemetry-data-authenticated-gateway">Publish Telemetry Data (authenticated Gateway)</a></li>
+<li><a href="#publishing-events">Publishing Events</a></li>
+<li><a href="#publish-an-event-authenticated-device">Publish an Event (authenticated Device)</a></li>
+<li><a href="#publish-an-event-unauthenticated-device">Publish an Event (unauthenticated Device)</a></li>
+<li><a href="#publish-an-event-authenticated-gateway">Publish an Event (authenticated Gateway)</a></li>
+<li><a href="#command-control">Command &amp; Control</a>
+<ul>
+<li><a href="#receiving-commands-authenticated-device">Receiving Commands (authenticated Device)</a></li>
+<li><a href="#receiving-commands-unauthenticated-device">Receiving Commands (unauthenticated Device)</a></li>
+<li><a href="#receiving-commands-authenticated-gateway">Receiving Commands (authenticated Gateway)</a></li>
+<li><a href="#sending-a-response-to-a-command-authenticated-device">Sending a Response to a Command (authenticated Device)</a></li>
+<li><a href="#sending-a-response-to-a-command-unauthenticated-device">Sending a Response to a Command (unauthenticated Device)</a></li>
+<li><a href="#sending-a-response-to-a-command-authenticated-gateway">Sending a Response to a Command (authenticated Gateway)</a></li>
+</ul></li>
+<li><a href="#downstream-meta-data">Downstream Meta Data</a>
+<ul>
+<li><a href="#event-message-time-to-live">Event Message Time-to-live</a></li>
+</ul></li>
+<li><a href="#tenant-specific-configuration">Tenant specific Configuration</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>MQTT Adapter</h1>
+          
+
+        
+
+
+<p>The MQTT protocol adapter exposes an MQTT topic hierarchy for publishing telemetry data and events to downstream consumers and for receiving commands from applications and sending back responses.</p>
+
+<p>The MQTT adapter is <strong>not</strong> a general purpose MQTT broker. In particular the adapter</p>
+
+<ul>
+<li>supports MQTT 3.1.1 only.</li>
+<li>does not maintain session state for clients and thus always sets the <em>session present</em> flag in its CONNACK packet to <code>0</code>, regardless of the value  of the <em>clean session</em> flag provided in a client&rsquo;s CONNECT packet.</li>
+<li>ignores any <em>Will</em> included in a client&rsquo;s CONNECT packet.</li>
+<li>only supports topic names/filters for devices to publish and subscribe to that are specific to Hono&rsquo;s functionality as described in the following sections.</li>
+<li>does not support <em>retaining</em> messages. However, if an event or telemetry message&rsquo;s <em>retain</em> flag is set to <code>1</code> then the corresponding AMQP 1.0 message being sent downstream by the adapter will contain an <em>x-opt-retain</em> message annotation containing the boolean value <code>true</code>. A downstream consumer may then react according to the presence of this annotation.</li>
+</ul>
+
+<h2 id="authentication">Authentication</h2>
+
+<p>The MQTT adapter by default requires clients (devices or gateway components) to authenticate during connection establishment. The adapter supports both the authentication based on the username/password provided in an MQTT CONNECT packet as well as client certificate based authentication as part of a TLS handshake for that purpose.</p>
+
+<p>The adapter tries to authenticate the device using these mechanisms in the following order</p>
+
+<h3 id="client-certificate">Client Certificate</h3>
+
+<p>When a device uses a client certificate for authentication during the TLS handshake, the adapter tries to determine the tenant that the device belongs to based on the <em>issuer DN</em> contained in the certificate.
+In order for the lookup to succeed, the tenant&rsquo;s trust anchor needs to be configured by means of registering the <a href="/hono/docs/1.2/api/tenant/#tenant-information-format">trusted certificate authority</a>.
+The device&rsquo;s client certificate will then be validated using the registered trust anchor, thus implicitly establishing the tenant that the device belongs to.
+In a second step, the adapter uses the Credentials API&rsquo;s <em>get</em> operation to retrieve the credentials on record, including the client certificate&rsquo;s <em>subject DN</em> as the <em>auth-id</em>, <code>x509-cert</code> as the <em>type</em> of secret and the MQTT client identifier as <em>client-id</em> in the request payload.</p>
+
+<p><strong>NB</strong> The adapter needs to be <a href="/hono/docs/1.2/admin-guide/secure_communication/#mqtt-adapter">configured for TLS</a> in order to support this mechanism.</p>
+
+<h3 id="username-password">Username/Password</h3>
+
+<p>When a device wants to authenticate using this mechanism, it needs to provide a <em>username</em> and a <em>password</em> in the MQTT <em>CONNECT</em> packet it sends in order to initiate the connection. The <em>username</em> must have the form <em>auth-id@tenant</em>, e.g. <code>sensor1@DEFAULT_TENANT</code>.
+The adapter verifies the credentials provided by the client against the credentials that the <a href="/hono/docs/1.2/admin-guide/common-config/#credentials-service-connection-configuration">configured Credentials service</a> has on record for the client.
+The adapter uses the Credentials API&rsquo;s <em>get</em> operation to retrieve the credentials on record, including the <em>tenant</em> and <em>auth-id</em> provided by the client in the <em>username</em>, <code>hashed-password</code> as the <em>type</em> of secret and the MQTT client identifier as <em>client-id</em> in the request payload.</p>
+
+<p>The examples below refer to devices <code>4711</code> and <code>gw-1</code> of tenant <code>DEFAULT_TENANT</code> using <em>auth-ids</em> <code>sensor1</code> and <code>gw1</code> and corresponding passwords. The example deployment as described in the <a href="/hono/docs/1.2/deployment/">Deployment Guides</a> comes pre-configured with the corresponding entities in its device registry component.</p>
+
+<p><strong>NB</strong> There is a subtle difference between the <em>device identifier</em> (<em>device-id</em>) and the <em>auth-id</em> a device uses for authentication. See <a href="/hono/docs/1.2/concepts/device-identity/">Device Identity</a> for a discussion of the concepts.</p>
+
+<h2 id="resource-limit-checks">Resource Limit Checks</h2>
+
+<p>The adapter performs additional checks regarding <a href="/hono/docs/1.2/concepts/resource-limits/">resource limits</a> when a client tries to connect and/or
+send a message to the adapter.</p>
+
+<h3 id="connection-limits">Connection Limits</h3>
+
+<p>The adapter rejects a client’s connection attempt with return code</p>
+
+<ul>
+<li><code>0x03</code> (<em>Connection Refused: server unavailable</em>), if the maximum number of connections per protocol adapter instance is reached</li>
+<li><code>0x05</code> (<em>Connection Refused: not authorized</em>), if the maximum number of simultaneously connected devices for the tenant is reached.</li>
+</ul>
+
+<h3 id="connection-duration-limits">Connection Duration Limits</h3>
+
+<p>The adapter rejects a client’s connection attempt with return code <code>0x05</code> (<em>Connection Refused: not authorized</em>), if the
+<a href="/hono/docs/1.2/concepts/resource-limits/#connection-duration-limit">connection duration limit</a> that has been configured for the client’s tenant is exceeded.</p>
+
+<h3 id="message-limits">Message Limits</h3>
+
+<p>The adapter</p>
+
+<ul>
+<li>rejects a client&rsquo;s connection attempt with return code <code>0x05</code> (<em>Connection Refused: not authorized</em>),</li>
+<li>discards any MQTT PUBLISH packet containing telemetry data or an event that is sent by a client and</li>
+<li>rejects any AMQP 1.0 message containing a command sent by a north bound application</li>
+</ul>
+
+<p>if the <a href="/hono/docs/1.2/concepts/resource-limits/">message limit</a> that has been configured for the device’s tenant is exceeded.</p>
+
+<h2 id="connection-event">Connection Event</h2>
+
+<p>The MQTT Adapter can send a <a href="/hono/docs/1.2/api/event/#connection-event">Connection Event</a> once the connection with a device has been successfully established or ended. Note that this requires the <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/#service-configuration"><code>HONO_CONNECTION_EVENTS_PRODUCER</code></a> configuration property to be explicitly set to <code>events</code>.</p>
+
+<h2 id="publishing-telemetry-data">Publishing Telemetry Data</h2>
+
+<p>The MQTT adapter supports the publishing of telemetry data by means of MQTT <em>PUBLISH</em> packets using either QoS 0 or QoS 1.
+Using QoS 1 will result in the adapter sending an MQTT <em>PUBACK</em> packet to the client once the message has been settled with the <em>accepted</em> outcome by the AMQP 1.0 Messaging Network.</p>
+
+<p>This requires that</p>
+
+<ul>
+<li>the AMQP 1.0 Messaging Network has capacity to process telemetry messages for the client&rsquo;s tenant and</li>
+<li>the messages published by the client comply with the format defined by the Telemetry API.</li>
+</ul>
+
+<p>The protocol adapter checks the configured <a href="/hono/docs/1.2/concepts/resource-limits/">message limit</a> before accepting any telemetry messages. If the message limit is exceeded or the incoming telemetry message cannot be processed, the connection to the client is closed.</p>
+
+<h2 id="publish-telemetry-data-authenticated-device">Publish Telemetry Data (authenticated Device)</h2>
+
+<ul>
+<li>Topic: <code>telemetry</code> or <code>t</code></li>
+<li>Authentication: required</li>
+<li>Payload:
+
+<ul>
+<li>(required) Arbitrary payload</li>
+</ul></li>
+</ul>
+
+<p>This is the preferred way for devices to publish telemetry data. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default). When using this topic, the MQTT adapter determines the device&rsquo;s tenant and device identity as part of the authentication process.</p>
+
+<p><strong>Example</strong></p>
+
+<p>Publish some JSON data for device <code>4711</code>:</p>
+
+<pre><code class="language-sh">mosquitto_pub -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t telemetry -m '{&quot;temp&quot;: 5}'
+</code></pre>
+
+<p>Publish some JSON data for device <code>4711</code> using a client certificate for authentication:</p>
+
+<pre><code class="language-sh"># in base directory of Hono repository:
+mosquitto_pub -p 8883 -t telemetry -m '{&quot;temp&quot;: 5}' --cert demo-certs/certs/device-4711-cert.pem --key demo-certs/certs/device-4711-key.pem --cafile demo-certs/certs/trusted-certs.pem
+</code></pre>
+
+<p><strong>NB</strong> The example above assumes that the MQTT adapter is <a href="/hono/docs/1.2/admin-guide/secure_communication/#mqtt-adapter">configured for TLS</a> and the secure port is used.</p>
+
+<h2 id="publish-telemetry-data-unauthenticated-device">Publish Telemetry Data (unauthenticated Device)</h2>
+
+<ul>
+<li>Topic: <code>telemetry/${tenant-id}/${device-id}</code> or <code>t/${tenant-id}/${device-id}</code></li>
+<li>Authentication: none</li>
+<li>Payload:
+
+<ul>
+<li>(required) Arbitrary payload</li>
+</ul></li>
+</ul>
+
+<p>This topic can be used by devices that have not authenticated to the protocol adapter. Note that this requires the
+<code>HONO_MQTT_AUTHENTICATION_REQUIRED</code> configuration property to be explicitly set to <code>false</code>.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Publish some JSON data for device <code>4711</code>:</p>
+
+<pre><code class="language-sh">mosquitto_pub -t telemetry/DEFAULT_TENANT/4711 -m '{&quot;temp&quot;: 5}'
+</code></pre>
+
+<h2 id="publish-telemetry-data-authenticated-gateway">Publish Telemetry Data (authenticated Gateway)</h2>
+
+<ul>
+<li>Topic: <code>telemetry/${tenant-id}/${device-id}</code> or <code>t/${tenant-id}/${device-id}</code></li>
+<li>Authentication: required</li>
+<li>Payload:
+
+<ul>
+<li>(required) Arbitrary payload</li>
+</ul></li>
+</ul>
+
+<p>This topic can be used by <em>gateway</em> components to publish data <em>on behalf of</em> other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like <a href="https://www.sigfox.com">SigFox</a> or <a href="https://lora-alliance.org/">LoRa</a>. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the topic name are used to identify the device that the gateway publishes data for.</p>
+
+<p>The protocol adapter checks the gateway&rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a <em>registration assertion</em> for the device from the <a href="/hono/docs/1.2/admin-guide/common-config/#device-registration-service-connection-configuration">configured Device Registration service</a>.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Publish some JSON data for device <code>4712</code> via gateway <code>gw-1</code>:</p>
+
+<pre><code class="language-sh">mosquitto_pub -u 'gw@DEFAULT_TENANT' -P gw-secret -t telemetry/DEFAULT_TENANT/4712 -m '{&quot;temp&quot;: 5}'
+</code></pre>
+
+<p><strong>NB</strong> The example above assumes that a gateway device with ID <code>gw-1</code> has been registered with <code>hashed-password</code> credentials with <em>auth-id</em> <code>gw</code> and password <code>gw-secret</code>.</p>
+
+<h2 id="publishing-events">Publishing Events</h2>
+
+<p>The MQTT adapter supports the publishing of events by means of MQTT <em>PUBLISH</em> packets using QoS 1 only.
+The adapter will send an MQTT <em>PUBACK</em> packet to the client once the event has been settled with the <em>accepted</em> outcome by the AMQP 1.0 Messaging Network.</p>
+
+<p>This requires that</p>
+
+<ul>
+<li>the AMQP 1.0 Messaging Network has capacity to process events for the client&rsquo;s tenant and</li>
+<li>the events published by the client comply with the format defined by the Event API.</li>
+</ul>
+
+<p>The protocol adapter checks the configured <a href="/hono/docs/1.2/concepts/resource-limits/">message limit</a> before accepting any event messages. If the message limit is exceeded or the incoming event message cannot be processed, the connection to the client is closed.</p>
+
+<p>The devices can optionally indicate a <em>time-to-live</em> duration for event messages by setting the <em>hono-ttl</em> property explicitly in the <code>property-bag</code>. The <code>property-bag</code> is an optional collection of properties intended for the receiver of the message. A property bag is only allowed at the very end of a topic. It always starts with a <code>/?</code> character, followed by pairs of URL encoded property names and values that are separated by <code>&amp;</code>. For example, a property bag containing two properties <em>seqNo</em> and <em>importance</em> looks like this: <code>/topic/name/?seqNo=10034&amp;importance=high</code>.</p>
+
+<p>The MQTT adapter currently does not use any properties except <em>hono-ttl</em>.</p>
+
+<h2 id="publish-an-event-authenticated-device">Publish an Event (authenticated Device)</h2>
+
+<ul>
+<li>Topic: <code>event</code> or <code>e</code></li>
+<li>Authentication: required</li>
+<li>Payload:
+
+<ul>
+<li>(required) Arbitrary payload</li>
+</ul></li>
+</ul>
+
+<p>This is the preferred way for devices to publish events. It is available only if the protocol adapter has been configured to require devices to authenticate (which is the default).</p>
+
+<p><strong>Example</strong></p>
+
+<p>Upload a JSON string for device <code>4711</code>:</p>
+
+<pre><code class="language-sh">mosquitto_pub -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t event -q 1 -m '{&quot;alarm&quot;: 1}'
+</code></pre>
+
+<p>Upload a JSON string for device <code>4711</code> with <code>time-to-live</code> as 10 seconds:</p>
+
+<pre><code class="language-sh">mosquitto_pub -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t event/?hono-ttl=10 -q 1 -m '{&quot;alarm&quot;: 1}'
+</code></pre>
+
+<h2 id="publish-an-event-unauthenticated-device">Publish an Event (unauthenticated Device)</h2>
+
+<ul>
+<li>Topic: <code>event/${tenant-id}/${device-id}</code> or <code>e/${tenant-id}/${device-id}</code></li>
+<li>Authentication: none</li>
+<li>Payload:
+
+<ul>
+<li>(required) Arbitrary payload</li>
+</ul></li>
+</ul>
+
+<p>This topic can be used by devices that have not authenticated to the protocol adapter. Note that this requires the
+<code>HONO_MQTT_AUTHENTICATION_REQUIRED</code> configuration property to be explicitly set to <code>false</code>.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Publish some JSON data for device <code>4711</code>:</p>
+
+<pre><code class="language-sh">mosquitto_pub -t event/DEFAULT_TENANT/4711 -q 1 -m '{&quot;alarm&quot;: 1}'
+</code></pre>
+
+<p>Publish some JSON data for device <code>4711</code> with <code>time-to-live</code> as 15 seconds:</p>
+
+<pre><code class="language-sh">mosquitto_pub -t event/DEFAULT_TENANT/4711/?hono-ttl=15 -q 1 -m '{&quot;alarm&quot;: 1}'
+</code></pre>
+
+<h2 id="publish-an-event-authenticated-gateway">Publish an Event (authenticated Gateway)</h2>
+
+<ul>
+<li>Topic: <code>event/${tenant-id}/${device-id}</code> or <code>e/${tenant-id}/${device-id}</code></li>
+<li>Authentication: required</li>
+<li>Payload:
+
+<ul>
+<li>(required) Arbitrary payload</li>
+</ul></li>
+</ul>
+
+<p>This topic can be used by <em>gateway</em> components to publish data <em>on behalf of</em> other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like <a href="https://www.sigfox.com">SigFox</a> or <a href="https://lora-alliance.org/">LoRa</a>. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the topic name are used to identify the device that the gateway publishes data for.</p>
+
+<p>The protocol adapter checks the gateway&rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a <em>registration assertion</em> for the device from the <a href="/hono/docs/1.2/admin-guide/common-config/#device-registration-service-connection-configuration">configured Device Registration service</a>.</p>
+
+<p><strong>Examples</strong></p>
+
+<p>Publish some JSON data for device <code>4712</code> via gateway <code>gw-1</code>:</p>
+
+<pre><code class="language-sh">mosquitto_pub -u 'gw@DEFAULT_TENANT' -P gw-secret -t event/DEFAULT_TENANT/4712 -q 1 -m '{&quot;temp&quot;: 5}'
+</code></pre>
+
+<p><strong>NB</strong> The example above assumes that a gateway device with ID <code>gw-1</code> has been registered with <code>hashed-password</code> credentials with <em>auth-id</em> <code>gw</code> and password <code>gw-secret</code>.</p>
+
+<h2 id="command-control">Command &amp; Control</h2>
+
+<p>The MQTT adapter enables devices to receive commands that have been sent by business applications by means of sending an MQTT <em>SUBSCRIBE</em> packet containing a device specific <em>topic filter</em> as described below. Devices can subscribe with QoS 1 or QoS 0. The adapter indicates the outcome of the subscription request by sending back a corresponding <em>SUBACK</em> packet. The SUBACK packet will contain <em>Success - QoS 0</em> (<code>0x00</code>) or <em>Success - QoS 1</em> (<code>0x01</code>) for a command topic filter indicating QoS 0 or 1 and will contain the <em>Failure</em> (<code>0x80</code>) value for all other filters. When a device no longer wants to receive commands anymore, it can send an MQTT <em>UNSUBSCRIBE</em> packet to the adapter, including the same topic filter that has been used to subscribe.</p>
+
+<p>When a device has successfully subscribed, the adapter sends an <a href="/hono/docs/1.2/api/event/#empty-notification">empty notification</a> on behalf of the device to the downstream AMQP 1.0 Messaging Network with the <em>ttd</em> header set to <code>-1</code>, indicating that the device will be ready to receive commands until further notice. Analogously, the adapter sends an empty notification with the <em>ttd</em> header set to <code>0</code> when a device unsubscribes from commands.</p>
+
+<p>Commands can be sent following a <em>request/response</em> pattern or being <em>one-way</em>.</p>
+
+<p>For <em>Request/Response</em> commands, devices send their responses to commands by means of sending an MQTT <em>PUBLISH</em> message to a topic that is specific to the command that has been executed. The MQTT adapter accepts responses being published using either QoS 0 or QoS 1.</p>
+
+<p>The MQTT adapter checks the configured <a href="/hono/docs/1.2/concepts/resource-limits/">message limit</a> before accepting any command requests and responses. In case of incoming command requests from business applications, if the message limit is exceeded, the Adapter rejects the message with the reason <code>amqp:resource-limit-exceeded</code>. And for the incoming command responses from devices, the Adapter rejects the message and closes the connection to the client.</p>
+
+<p>The following sections define the topic filters/names to use for subscribing to and responding to commands. The following <em>shorthand</em> versions of topic path segments are supported:</p>
+
+<ul>
+<li><code>c</code> instead of <code>command</code></li>
+<li><code>q</code> instead of <code>req</code></li>
+<li><code>s</code> instead of <code>res</code></li>
+</ul>
+
+<p>The following variables are used:</p>
+
+<ul>
+<li><code>${command}</code> : An arbitrary string that indicates the command to execute, e.g. <code>setBrightness</code>. The command is provided by the application that sends the command.</li>
+<li><code>${req-id}</code> (only for <em>Request/Response</em> commands) : The unique identifier of the command execution request. The identifier is passed to the device as part of the name of the topic that the command is published to. The device needs to publish its response to the command to a topic which includes this identifier, thus allowing the adapter to correlate the response with the request.</li>
+<li><code>${status}</code> : The HTTP status code indicating the outcome of executing the command. This status code is passed on to the application in the AMQP message&rsquo;s <em>status</em> application property.</li>
+</ul>
+
+<h3 id="receiving-commands-authenticated-device">Receiving Commands (authenticated Device)</h3>
+
+<p>An authenticated device MUST use the topic filter <code>command///req/#</code> to subscribe to commands.</p>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Deprecation</h4>
+    <div>Previous versions of Hono required authenticated devices to use <code>command/+/+/req/#</code> for subscribing to commands.
+This old topic filter is deprecated. Devices MAY still use it until support for it will be removed in a future Hono version.</div>
+</div>
+
+
+<p><strong>Example</strong></p>
+
+<pre><code class="language-sh">mosquitto_sub -v -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t command///req/#
+</code></pre>
+
+<p>The adapter will then publish <em>Request/Response</em> commands for the device to topic <code>command///req/${req-id}/${command}</code> and <em>one-way</em> commands to topic <code>command///req//${command}</code>.</p>
+
+<p>For example, a request/response command with name <code>setBrightness</code> from an application might look like this:</p>
+
+<pre><code class="language-plaintext">command///q/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/setBrightness
+{
+  &quot;brightness&quot;: 79
+}
+</code></pre>
+
+<p>A corresponding <em>one-way</em> command might look like this:</p>
+
+<pre><code class="language-plaintext">command///q//setBrightness
+{
+  &quot;brightness&quot;: 79
+}
+</code></pre>
+
+<p>Note that the topic in the latter case doesn&rsquo;t contain a request identifier.</p>
+
+<h3 id="receiving-commands-unauthenticated-device">Receiving Commands (unauthenticated Device)</h3>
+
+<p>An unauthenticated device MUST use the topic filter <code>command/${tenant-id}/${device-id}/req/#</code> to subscribe to commands.</p>
+
+<p><strong>Example</strong></p>
+
+<pre><code class="language-sh">mosquitto_sub -v -t command/DEFAULT_TENANT/4711/req/#
+</code></pre>
+
+<p>The adapter will then publish <em>Request/Response</em> commands for the device to topic <code>command/${tenant-id}/${device-id}/req/${req-id}/${command}</code> and <em>one-way</em> commands to topic <code>command/${tenant-id}/${device-id}/req//${command}</code>.</p>
+
+<p>For example, a request/response command with name <code>setBrightness</code> from an application might look like this:</p>
+
+<pre><code class="language-plaintext">command/DEFAULT_TENANT/4711/q/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/setBrightness
+{
+  &quot;brightness&quot;: 79
+}
+</code></pre>
+
+<p>A corresponding <em>one-way</em> command might look like this:</p>
+
+<pre><code class="language-plaintext">command/DEFAULT_TENANT/4711/q//setBrightness
+{
+  &quot;brightness&quot;: 79
+}
+</code></pre>
+
+<p>Note that the topic in the latter case doesn&rsquo;t contain a request identifier.</p>
+
+<h3 id="receiving-commands-authenticated-gateway">Receiving Commands (authenticated Gateway)</h3>
+
+<p><em>Gateway</em> components can receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like <a href="https://www.sigfox.com">SigFox</a> or <a href="https://lora-alliance.org/">LoRa</a>. Corresponding devices have to be configured so that they can be used with a gateway. See <a href="/hono/docs/1.2/admin-guide/device-registry-config/#configuring-gateway-devices">Configuring Gateway Devices</a> for details.</p>
+
+<p>An authenticated gateway MUST use the topic filter <code>command//+/req/#</code> to subscribe to commands for all devices in whose behalf it acts.</p>
+
+<p>To subscribe only to commands for a specific device, an authenticated gateway MUST use the topic filter <code>command//${device-id}/req/#</code>.</p>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Deprecation</h4>
+    <div>Previous versions of Hono required authenticated gateways to use <code>command/+/+/req/#</code> for subscribing to commands.
+This old topic filter is deprecated. Gateways MAY still use it until support for it will be removed in a future Hono version.</div>
+</div>
+
+
+<p>When processing an incoming command message, the protocol adapter will give precedence to a device-specific command subscription matching the command target device, whether the subscription comes from a gateway or the device itself. If there are multiple such subscriptions from multiple gateways and/or from the device itself, the subscription initiated last will get the command messages.</p>
+
+<p>If no device-specific command subscription exists for a command target device, but <em>one</em> gateway, that may act on behalf of the device, has subscribed to commands for all its devices, then the command message is sent to that gateway.</p>
+
+<p>If <em>multiple</em> gateways have initiated such generic subscriptions, the protocol adapter may have to decide to which gateway a particular command message will be sent to.
+In case the command target device has already sent a telemetry, event or command response message via a gateway and if that gateway has created such a command subscription, that gateway will be chosen. Otherwise one gateway that may act on behalf of the command target device and that has an open subscription will be chosen randomly to receive the command message.</p>
+
+<p><strong>Example</strong></p>
+
+<p>A subscription to commands for all devices that a gateway acts on behalf of looks like this:</p>
+
+<pre><code class="language-sh">mosquitto_sub -v -u 'gw@DEFAULT_TENANT' -P gw-secret -t command//+/req/#
+</code></pre>
+
+<p>A subscription to commands for a specific device can be done like this:</p>
+
+<pre><code class="language-sh">mosquitto_sub -v -u 'gw@DEFAULT_TENANT' -P gw-secret -t command//4711/req/#
+</code></pre>
+
+<p>The adapter will then publish <em>Request/Response</em> commands for devices, that the gateway has acted on behalf of, to topic <code>command//${device-id}/req/${req-id}/${command}</code> and <em>one-way</em> commands to topic <code>command//${device-id}/req//${command}</code>.</p>
+
+<p>For example, a request/response command for device <code>4711</code> with name <code>setBrightness</code> from an application might look like this:</p>
+
+<pre><code class="language-plaintext">command//4711/q/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/setBrightness
+{
+  &quot;brightness&quot;: 79
+}
+</code></pre>
+
+<p>A corresponding <em>one-way</em> command might look like this:</p>
+
+<pre><code class="language-plaintext">command//4711/q//setBrightness
+{
+  &quot;brightness&quot;: 79
+}
+</code></pre>
+
+<p>Note that the topic in the latter case doesn&rsquo;t contain a request identifier.</p>
+
+<h3 id="sending-a-response-to-a-command-authenticated-device">Sending a Response to a Command (authenticated Device)</h3>
+
+<p>An authenticated device MUST send the response to a previously received command to the topic <code>command///res/${req-id}/${status}</code>.</p>
+
+<p><strong>Example</strong></p>
+
+<p>After a command has arrived as in the above example, you send a response using the arrived <code>${req-id}</code>:</p>
+
+<pre><code class="language-sh">mosquitto_pub -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t command///res/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/200 -m '{&quot;lumen&quot;: 200}'
+</code></pre>
+
+<h3 id="sending-a-response-to-a-command-unauthenticated-device">Sending a Response to a Command (unauthenticated Device)</h3>
+
+<p>An unauthenticated device MUST send the response to a previously received command to the topic <code>command/${tenant-id}/${device-id}/res/${req-id}/${status}</code>.</p>
+
+<p><strong>Example</strong></p>
+
+<p>After a command has arrived as in the above example, you send a response using the arrived <code>${req-id}</code>:</p>
+
+<pre><code class="language-sh">mosquitto_pub -t command/DEFAULT_TENANT/4711/res/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/200 -m '{&quot;lumen&quot;: 200}'
+</code></pre>
+
+<h3 id="sending-a-response-to-a-command-authenticated-gateway">Sending a Response to a Command (authenticated Gateway)</h3>
+
+<p>An authenticated gateway MUST send a device&rsquo;s response to a command it has received on behalf of the device to the topic <code>command//${device-id}/res/${req-id}/${status}</code>.</p>
+
+<p><strong>Example</strong></p>
+
+<p>After a command has arrived as in the above example, the response is sent using the <code>${req-id}</code> from the topic that the command had been published to:</p>
+
+<pre><code class="language-sh">mosquitto_pub -u 'gw@DEFAULT_TENANT' -P gw-secret -t command//4711/res/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/200 -m '{&quot;lumen&quot;: 200}'
+</code></pre>
+
+<h2 id="downstream-meta-data">Downstream Meta Data</h2>
+
+<p>The adapter includes the following meta data in messages being sent downstream:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="left">Location</th>
+<th align="left">Type</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>device_id</em></td>
+<td align="left"><em>application</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The identifier of the device that the message originates from.</td>
+</tr>
+
+<tr>
+<td align="left"><em>orig_adapter</em></td>
+<td align="left"><em>application</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">Contains the adapter&rsquo;s <em>type name</em> which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The MQTT adapter&rsquo;s type name is <code>hono-mqtt</code>.</td>
+</tr>
+
+<tr>
+<td align="left"><em>orig_address</em></td>
+<td align="left"><em>application</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">Contains the name of the MQTT topic that the device has originally published the data to.</td>
+</tr>
+
+<tr>
+<td align="left"><em>x-opt-retain</em></td>
+<td align="left">* <em>message-annotations</em></td>
+<td align="left"><em>boolean</em></td>
+<td align="left">Contains <code>true</code> if the device has published an event or telemetry message with its <em>retain</em> flag set to <code>1</code></td>
+</tr>
+</tbody>
+</table>
+
+<p>The adapter also considers <em>defaults</em> registered for the device at either the <a href="/hono/docs/1.2/api/tenant/#tenant-information-format">tenant</a> or the <a href="/hono/docs/1.2/api/device-registration/#assert-device-registration">device level</a>. The values of the default properties are determined as follows:</p>
+
+<ol>
+<li>If the message already contains a non-empty property of the same name, the value if unchanged.</li>
+<li>Otherwise, if a default property of the same name is defined in the device&rsquo;s registration information, that value is used.</li>
+<li>Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.</li>
+</ol>
+
+<p>Note that of the standard AMQP 1.0 message properties only the <em>content-type</em> and <em>ttl</em> can be set this way to a default value.</p>
+
+<h3 id="event-message-time-to-live">Event Message Time-to-live</h3>
+
+<p>Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers.
+In most cases the AMQP Messaging Network can be configured with a maximum <em>time-to-live</em> to apply to the events so that the events will be removed
+from the persistent store if no consumer has attached to receive the event before the message expires.</p>
+
+<p>In order to support environments where the AMQP Messaging Network cannot be configured accordingly, the MQTT protocol adapter supports setting a
+downstream event message&rsquo;s <em>ttl</em> property based on the <em>hono-ttl</em> property set as <em>property-bag</em> at the end of the event topic.
+Also the default <em>ttl</em> and <em>max-ttl</em> values can be configured for a tenant/device as described in the <a href="/hono/docs/1.2/api/tenant/#resource-limits-configuration-format">Tenant API</a>.</p>
+
+<h2 id="tenant-specific-configuration">Tenant specific Configuration</h2>
+
+<p>The adapter uses the <a href="/hono/docs/1.2/api/tenant/#get-tenant-information">Tenant API</a> to retrieve <em>tenant specific configuration</em> for adapter type <code>hono-mqtt</code>.
+The following properties are (currently) supported:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Name</th>
+<th align="left">Type</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><em>enabled</em></td>
+<td align="left"><em>boolean</em></td>
+<td align="left"><code>true</code></td>
+<td align="left">If set to <code>false</code> the adapter will reject all data from devices belonging to the tenant.</td>
+</tr>
+</tbody>
+</table>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/1.2/user-guide/sigfox-adapter/index.html b/docs/1.2/user-guide/sigfox-adapter/index.html
new file mode 100644
index 0000000..27fef7f
--- /dev/null
+++ b/docs/1.2/user-guide/sigfox-adapter/index.html
@@ -0,0 +1,2624 @@
+<!DOCTYPE html>
+<html lang="1.2" class="js csstransforms3d">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="generator" content="Hugo 0.54.0" />
+    <meta name="description" content="A set of micro-services for connecting millions of devices.">
+<meta name="author" content="The Eclipse Hono Project">
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
+<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
+<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
+<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
+<meta name="msapplication-TileColor" content="#da532c">
+<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
+<meta name="theme-color" content="#ffffff">
+
+    <title>Sigfox Adapter :: Eclipse Hono&trade; Vers.: 1.2</title>
+
+    
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
+    
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
+    
+
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
+
+    <style type="text/css">
+      :root #header + #content > #left > #rlblock_left{
+          display:none !important;
+      }
+      
+        :not(pre) > code + span.copy-to-clipboard {
+            display: none;
+        }
+      
+    </style>
+    
+
+<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
+<link rel="stylesheet" href='/hono/docs/css/hono.css'>
+
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:site" content="@EclipseHono">
+<meta name="twitter:title" content="Sigfox Adapter :: Eclipse Hono&amp;trade; Vers.: 1.2">
+<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
+<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
+
+
+<meta property="og:title" content="Sigfox Adapter :: Eclipse Hono&amp;trade; Vers.: 1.2" />
+<meta property="og:type" content="website" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/user-guide/sigfox-adapter//" />
+<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
+
+  </head>
+  <body class="" data-url="/hono/docs/1.2/user-guide/sigfox-adapter/">
+    <nav id="sidebar" class="">
+
+
+
+  <div id="header-wrapper">
+    <div id="header">
+      <a href="https://www.eclipse.org/hono/">
+    <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
+</a>
+
+    </div>
+    
+        <div class="searchbox">
+    <label for="search-by"><i class="fas fa-search"></i></label>
+    <input data-search-input id="search-by" type="search" placeholder="Search...">
+    <span data-search-clear=""><i class="fas fa-times"></i></span>
+</div>
+
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
+<script type="text/javascript">
+    
+        var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
+    
+</script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
+
+    
+  </div>
+
+    <div class="highlightable">
+    <ul class="topics">
+
+        
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/concepts/">
+          <i class="far fa-lightbulb"></i> Concepts
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-identity/">
+        Device Identity
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/tenancy/">
+        Multi-Tenancy
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-provisioning/">
+        Device Provisioning
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connecting-devices/">
+        Connecting Devices
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/device-notifications/">
+        Device Notifications
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/command-and-control/">
+        Command &amp; Control
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/resource-limits/">
+        Resource limits
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
+        <a href="/hono/docs/1.2/concepts/connection-events/">
+        Connection Events
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item 
+        parent
+        
+        
+        ">
+      <a href="/hono/docs/1.2/user-guide/">
+          <i class="fas fa-book-reader"></i> User Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/device-registry/">
+        Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/http-adapter/">
+        HTTP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
+        MQTT Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
+        AMQP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/coap-adapter/">
+        CoAP Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/kura-adapter/">
+        Kura Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item active">
+        <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
+        Sigfox Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
+        <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
+        Load Tests with JMeter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/admin-guide/">
+          <i class="fas fa-sliders-h"></i> Admin Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/common-config/">
+        Common Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
+        Auth Server Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
+        Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
+        Device Connection Service Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
+        HTTP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
+        AMQP Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
+        Kura Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
+        Hono Client Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
+        AMQP 1.0 Messaging Network Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/secure_communication/">
+        Secure Communication
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
+        <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
+        Monitoring &amp; Tracing
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/dev-guide/">
+          <i class="fas fa-tools"></i> Developer Guide
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/building_hono/">
+        Building from Source
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
+        AMQP Adapter Client for Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
+        Consuming Messages from Java
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
+        <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
+        Implement a Custom Hono HTTP Protocol Adapter
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/api/">
+          &nbsp;<i class='fas fa-plug'></i>&nbsp;API
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/telemetry/">
+        Telemetry API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/event/">
+        Event API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/command-and-control/">
+        Command &amp; Control API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/tenant/">
+        Tenant API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-connection/">
+        Device Connection API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/device-registration/">
+        Device Registration API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/credentials/">
+        Credentials API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/authentication/">
+        Authentication API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
+        <a href="/hono/docs/1.2/api/management/">
+        Device Registry Management API
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
+        <a href="/hono/docs/1.2/api/metrics/">
+        Metrics
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/deployment/">
+          <i class="fas fa-shipping-fast"></i> Deployment
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
+        Helm based Deployment
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/openshift/">
+        OpenShift / OKD
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
+        Setting up a Kubernetes Cluster
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
+        <a href="/hono/docs/1.2/deployment/resource-limitation/">
+        Limiting Resource Usage
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+          
+
+
+ 
+  
+    
+    <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item 
+        
+        
+        
+        ">
+      <a href="/hono/docs/1.2/architecture/">
+          <i class="fas fa-landmark"></i> Architecture
+          
+      </a>
+      
+      
+        <ul>
+          
+          
+          
+          
+        
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/component-view/">
+        Component View
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
+        <a href="/hono/docs/1.2/architecture/auth/">
+        Authentication/Authorization
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+        
+        </ul>
+              
+    </li>
+  
+ 
+
+          
+         
+    </ul>
+
+    
+    
+      <section id="shortcuts">
+        <h3></h3>
+        <ul>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
+              </li>
+          
+              <li> 
+                  <a class="padding" href="https://www.eclipse.org/hono/getting-started/" title="Getting started with Eclipse Hono"><i class='fas fa-plane-departure'></i> Getting Started</a>
+              </li>
+          
+        </ul>
+      </section>
+    
+
+    
+    <section id="prefooter">
+      <hr/>
+      <ul>
+      
+        <li>
+          <div id="select-box-wrapper">
+          <div id="select-box">
+          <a class="padding">
+            Version:&nbsp;
+          <div class="select-style">
+            <select id="select-language" onchange="location = this.value;">
+          
+          
+          
+              
+              
+                  
+                    
+                    
+                      <option id="stable" value="/hono/docs/user-guide/sigfox-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/sigfox-adapter/" selected>1.2</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.1" value="/hono/docs/1.1/user-guide/sigfox-adapter/">1.1</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.0" value="/hono/docs/1.0/user-guide/sigfox-adapter/">1.0</option>
+                    
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="dev" value="/hono/docs/dev/user-guide/sigfox-adapter/">dev</option>
+                    
+                  
+              
+          
+        </select>
+        <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+          width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
+          <g>
+            <g id="arrow-drop-down">
+              <polygon points="0,63.75 127.5,191.25 255,63.75 		" />
+            </g>
+          </g>
+        </svg>
+        </div>
+        </a>
+        </div>
+        </div>
+        </li>
+      
+      
+      
+      </ul>
+    </section>
+    
+    <section id="footer">
+      
+
+<p>&copy; 2020 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
+
+<p>
+    Documentation built with
+    <a href="https://gohugo.io/" target="_blank">Hugo</a>
+    using the
+    <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
+</p>
+
+<div class="eclipse-logo">
+    <a href="https://www.eclipse.org" target="_blank">
+        <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
+    </a>
+</div>
+
+    </section>
+  </div>
+</nav>
+
+
+
+
+
+        <section id="body">
+        <div id="overlay"></div>
+        
+        
+    <div class="old-version-hint">
+        <p>This page refers to version <em>1.2</em>.
+            You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
+        </p>
+    </div>
+
+
+    
+        <div class="padding highlightable">
+              
+              <div>
+                <div id="top-bar">
+                
+                  
+                  
+                  
+                  <div id="top-github-link">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/user-guide/sigfox-adapter.md" target="blank">
+                      <i class="fas fa-code-branch"></i>
+                      <span id="top-github-link-text">Edit this page</span>
+                    </a>
+                  </div>
+                  
+                
+                
+                <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
+                    <span id="sidebar-toggle-span">
+                        <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
+                          <i class="fas fa-bars"></i>
+                        </a>
+                    </span>
+                  
+                  <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
+                  
+                  <span class="links">
+                 
+                 
+                    
+          
+          
+            
+            
+          
+          
+            
+            
+          
+          
+            <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/user-guide/'>User Guide</a> > Sigfox Adapter
+          
+         
+          
+         
+          
+        
+                 
+                  </span>
+                </div>
+                
+                    <div class="progress">
+    <div class="wrapper">
+<nav id="TableOfContents">
+<ul>
+<li>
+<ul>
+<li><a href="#pre-requisites">Pre-requisites</a></li>
+<li><a href="#devices-and-credentials">Devices and credentials</a></li>
+<li><a href="#setup-example">Setup example</a>
+<ul>
+<li><a href="#registering-devices">Registering devices</a></li>
+<li><a href="#setting-up-callbacks">Setting up callbacks</a></li>
+<li><a href="#enabling-command-control">Enabling command &amp; control</a></li>
+</ul></li>
+<li><a href="#events">Events</a></li>
+<li><a href="#consuming-data">Consuming data</a></li>
+<li><a href="#known-bugs-and-limitations">Known bugs and limitations</a></li>
+</ul></li>
+</ul>
+</nav>
+    </div>
+</div>
+
+                
+              </div>
+            </div>
+            
+
+        
+        <div id="body-inner">
+          
+            <h1>Sigfox Adapter</h1>
+          
+
+        
+
+
+<p>The Sigfox protocol adapter exposes an HTTP endpoint for connecting up with
+the Sigfox backend for publishing telemetry, events and use command &amp; control.</p>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Tech preview</h4>
+    <div>This protocol adapter is not considered production ready. Its APIs might still
+be subject to change without warning.</div>
+</div>
+
+
+<h2 id="pre-requisites">Pre-requisites</h2>
+
+<p>This Sigfox adapter only connects to the Sigfox backend system
+(<code>backend.sigfox.com</code>). It does not allow direct access to Sigfox devices.</p>
+
+<p>So you need to set up your Sigfox devices on <code>backend.sigfox.com</code> and then
+configure the callbacks connect to your installation of Hono.</p>
+
+<h2 id="devices-and-credentials">Devices and credentials</h2>
+
+<p>In a nutshell, the Sigfox adapter requires a single <em>device</em> identity, acting
+as a gateway device. This identity will be used to connect to Hono. All devices
+registered with Sigfox (the actual Sigfox devices), will be registered in Hono
+to allow this first identity as their gateway device.</p>
+
+<h2 id="setup-example">Setup example</h2>
+
+<p>The following sub-sections walk you through an example setup.</p>
+
+<h3 id="registering-devices">Registering devices</h3>
+
+<p>This example assumes that the Sigfox protocol adapter is available as
+<code>https://iot-sigfox-adapter.my.hono</code>.</p>
+
+<p>Create a new <em>gateway device</em> with the following registration:</p>
+
+<pre><code class="language-json">{
+  &quot;device-id&quot;: &quot;sigfox-backend&quot;
+}
+</code></pre>
+
+<p>Create new credentials for the <em>gateway device</em>. For example, using
+a username of <code>sigfox</code> and a password of <code>test12</code>:</p>
+
+<pre><code class="language-json">{
+  &quot;auth-id&quot;: &quot;sigfox&quot;,
+  &quot;device-id&quot;: &quot;sigfox-backend&quot;,
+  &quot;enabled&quot;: true,
+  &quot;secrets&quot;: [
+    {
+      &quot;pwd-plain&quot;: &quot;test12&quot;,
+    }
+  ],
+  &quot;type&quot;: &quot;hashed-password&quot;
+}
+</code></pre>
+
+<p>Create a new <em>device</em>, referencing the previous <em>gateway device</em>. The
+<em>device id</em> must be your Sigfox device ID (e.g. <code>1AB2C3</code>):</p>
+
+<pre><code class="language-json">{
+  &quot;device-id&quot;: &quot;1AB2C3&quot;,
+  &quot;via&quot;: &quot;sigfox-backend&quot;
+}
+</code></pre>
+
+<h3 id="setting-up-callbacks">Setting up callbacks</h3>
+
+<p>Log in to the Sigfox backend at <a href="https://backend.sigfox.com">https://backend.sigfox.com</a> and then open up
+the view <code>Device Type</code> -&gt; <code>Callbacks</code>.</p>
+
+<p>Create a new &ldquo;Custom&rdquo; callback, with the following settings
+(replacing <code>&lt;TENANT&gt;</code> with the name of the tenant):</p>
+
+<ul>
+<li><strong>Type</strong>: <code>DATA</code> – <code>UPLINK</code></li>
+<li><strong>Channel</strong>: <code>URL</code></li>
+<li><strong>Url pattern</strong>: <code>https://iot-sigfox-adapter.my.hono/data/telemetry/&lt;TENANT&gt;?device={device}&amp;data={data}</code></li>
+<li><strong>Use HTTP Method</strong>: <code>GET</code></li>
+<li><strong>Headers</strong>
+
+<ul>
+<li><code>Authorization</code> – <code>Basic …</code> (see note below)</li>
+</ul></li>
+<li><strong>Send SNI</strong>: ☑ (Enabled)</li>
+</ul>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Credentials</h4>
+    <div><p>At the moment you need to manually put in the <code>Authorization</code> header,
+you cannot put the credentials into the URL, as there is a bug in the
+Sigfox backend, which cannot be fixed by Hono. The backend does not
+properly escape the <code>@</code> character, and thus sends <code>foo%40tenant</code>
+instead of <code>foo@tenant</code> to the Hono protocol adapter.</p>
+
+<p>As a workaround, you can explicitly set the <code>Authorization</code> header to a
+value of <code>Basic &lt;base64 encoded credentials&gt;</code>. You can encode the
+credentials using:</p>
+
+<pre><code class="language-sh">echo -n &quot;sigfox@tenant:password&quot; | base64
+</code></pre>
+
+<p>To get the full value, including the <code>Basic</code> you may use:</p>
+
+<pre><code class="language-sh">echo &quot;Basic $(echo -n &quot;sigfox@tenant:password&quot; | base64)&quot;
+</code></pre>
+</div>
+</div>
+
+
+<h3 id="enabling-command-control">Enabling command &amp; control</h3>
+
+<p>It is possible to enable command &amp; control as well. For this you need to:</p>
+
+<ul>
+<li>Switch the <strong>Type</strong> of the <code>DATA</code> callback from <code>UPLINK</code> to <code>BIDIR</code></li>
+<li>Add the <code>ack</code> query parameter to the <strong>Url pattern</strong>, e.g. <code>https://iot-sigfox-adapter.my.hono/data/telemetry/&lt;TENANT&gt;?device={device}&amp;data={data}&amp;ack={ack}</code></li>
+</ul>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Command requirements</h4>
+    <div>Sigfox allows only a very specific payload in command messages. You must send
+exactly 8 bytes of data. It only supports <em>one way commands</em>.</div>
+</div>
+
+
+<h2 id="events">Events</h2>
+
+<p>You can send events by using the path <code>/data/event</code> on the URL.</p>
+
+<h2 id="consuming-data">Consuming data</h2>
+
+<p>Use the standard way of consuming Hono messages.</p>
+
+<h2 id="known-bugs-and-limitations">Known bugs and limitations</h2>
+
+<ul>
+<li>Only the simple <code>URL</code> and only <em>data</em> (no <em>service</em> or <em>device events</em> are
+currently supported.</li>
+</ul>
+
+<footer class=" footline" >
+	
+</footer>
+
+
+        
+        </div> 
+        
+
+      </div>
+
+    <div id="navigation">
+        
+        
+        
+        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                        
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+            
+        
+                    
+            
+        
+        
+        
+
+
+	 
+	 
+    </div>
+
+    </section>
+    
+    <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
+      <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
+    </div>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
+    <script>hljs.initHighlightingOnLoad();</script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
+
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
+    <script>
+        mermaid.initialize({ startOnLoad: true });
+    </script>
+    
+
+
+
+
+<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>
+
+
+<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
+
+  </body>
+</html>
+
diff --git a/docs/404.html b/docs/404.html
index 21c8d4c..8f9d5c9 100644
--- a/docs/404.html
+++ b/docs/404.html
@@ -18,16 +18,16 @@
   <title>404 Page not found</title>
   
    
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/horsey.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/horsey.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 <style type="text/css">
     :root #header + #content > #left > #rlblock_left {
diff --git a/docs/admin-guide/amqp-adapter-config/index.html b/docs/admin-guide/amqp-adapter-config/index.html
index bf48e51..ebf3ce2 100644
--- a/docs/admin-guide/amqp-adapter-config/index.html
+++ b/docs/admin-guide/amqp-adapter-config/index.html
@@ -21,19 +21,19 @@
     <title>AMQP Adapter Configuration :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item active">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/amqp-adapter-config/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/amqp-adapter-config/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/amqp-adapter-config/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/amqp-adapter-config/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/amqp-adapter-config/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/amqp-adapter-config/">dev</option>
@@ -1473,9 +1556,10 @@
         
 
 
-<p>The AMQP protocol adapter allows clients (devices and gateway components) that speaks AMQP 1.0 to publish telemetry messages and events to Eclipse Hono&trade;&rsquo;s Telemetry and Event endpoints.</p>
+<p>The AMQP protocol adapter exposes AMQP based endpoints for Eclipse Hono&trade;&rsquo;s south bound Telemetry, Event and Command &amp; Control APIs.</p>
 
-<p>The adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding <a href="https://hub.docker.com/r/eclipse/hono-adapter-amqp-vertx/">Docker image</a> created from it.</p>
+<p>The adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the
+corresponding <a href="https://hub.docker.com/r/eclipse/hono-adapter-amqp-vertx/">Docker image</a> created from it.</p>
 
 <p>The adapter supports the following standard configuration options:</p>
 
@@ -1537,6 +1621,13 @@
 </tr>
 
 <tr>
+<td align="left"><code>HONO_AMQP_SEND_MESSAGE_TO_DEVICE_TIMEOUT</code><br><code>--hono.amqp.sendMessageToDeviceTimeout</code></td>
+<td align="center">no</td>
+<td align="left"><code>1000</code></td>
+<td align="left">The time interval (milliseconds) to wait for a device to acknowledge receiving a (command) message before the AMQP link used for sending the message will be closed. Setting this property to <code>0</code> means the adapter waits indefinitely for a device to acknowledge receiving the message.</td>
+</tr>
+
+<tr>
 <td align="left"><code>HONO_AMQP_INSECURE_PORT_BIND_ADDRESS</code><br><code>--hono.amqp.insecurePortBindAddress</code></td>
 <td align="center">no</td>
 <td align="left"><code>127.0.0.1</code></td>
@@ -2021,6 +2112,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2126,6 +2233,38 @@
             
                 
                     
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
                     
                 
                 
@@ -2639,20 +2778,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/admin-guide/amqp-network-config/index.html b/docs/admin-guide/amqp-network-config/index.html
index 9acfd1e..0bc535a 100644
--- a/docs/admin-guide/amqp-network-config/index.html
+++ b/docs/admin-guide/amqp-network-config/index.html
@@ -21,19 +21,19 @@
     <title>AMQP 1.0 Messaging Network Configuration :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/amqp-network-config/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/amqp-network-config/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/amqp-network-config/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/amqp-network-config/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/amqp-network-config/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/amqp-network-config/">dev</option>
@@ -1802,6 +1885,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -1971,6 +2070,38 @@
             
                 
                     
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
                     
                 
                 
@@ -2420,20 +2551,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/admin-guide/auth-server-config/index.html b/docs/admin-guide/auth-server-config/index.html
index 140089f..d169071 100644
--- a/docs/admin-guide/auth-server-config/index.html
+++ b/docs/admin-guide/auth-server-config/index.html
@@ -21,19 +21,19 @@
     <title>Auth Server Configuration :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/auth-server-config/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/auth-server-config/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/auth-server-config/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/auth-server-config/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/auth-server-config/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/auth-server-config/">dev</option>
@@ -2015,6 +2098,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2231,6 +2330,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2633,20 +2764,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/user-guide/device-registry/index.html b/docs/admin-guide/coap-adapter-config/index.html
similarity index 63%
copy from docs/user-guide/device-registry/index.html
copy to docs/admin-guide/coap-adapter-config/index.html
index 5ff6a71..3dc19c7 100644
--- a/docs/user-guide/device-registry/index.html
+++ b/docs/admin-guide/coap-adapter-config/index.html
@@ -18,22 +18,22 @@
 <meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
 <meta name="theme-color" content="#ffffff">
 
-    <title>Device Registry :: Eclipse Hono&trade;</title>
+    <title>CoAP Adapter Configuration :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -53,18 +53,18 @@
 
 <meta name="twitter:card" content="summary_large_image">
 <meta name="twitter:site" content="@EclipseHono">
-<meta name="twitter:title" content="Device Registry :: Eclipse Hono&amp;trade;">
+<meta name="twitter:title" content="CoAP Adapter Configuration :: Eclipse Hono&amp;trade;">
 <meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
 <meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
 
 
-<meta property="og:title" content="Device Registry :: Eclipse Hono&amp;trade;" />
+<meta property="og:title" content="CoAP Adapter Configuration :: Eclipse Hono&amp;trade;" />
 <meta property="og:type" content="website" />
-<meta property="og:url" content="https://www.eclipse.org/hono/docs/user-guide/device-registry//" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/admin-guide/coap-adapter-config//" />
 <meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
 
   </head>
-  <body class="" data-url="/hono/docs/user-guide/device-registry/">
+  <body class="" data-url="/hono/docs/admin-guide/coap-adapter-config/">
     <nav id="sidebar" class="">
 
 
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -291,7 +291,7 @@
   
     
     <li data-nav-id="/hono/docs/user-guide/" title="User Guide" class="dd-item 
-        parent
+        
         
         
         ">
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item active">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -475,7 +494,7 @@
   
     
     <li data-nav-id="/hono/docs/admin-guide/" title="Admin Guide" class="dd-item 
-        
+        parent
         
         
         ">
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item active">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,7 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/device-registry/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/coap-adapter-config/" selected>stable (1.3)</option>
                     
                   
               
@@ -1287,24 +1344,14 @@
               
                   
               
+                  
+              
           
               
               
                   
               
                   
-                    
-                    
-                      <option id="1.1" value="/hono/docs/1.1/user-guide/device-registry/">1.1</option>
-                    
-                  
-              
-                  
-              
-                  
-              
-          
-              
               
                   
               
@@ -1313,12 +1360,10 @@
                   
                     
                     
-                      <option id="1.0" value="/hono/docs/1.0/user-guide/device-registry/">1.0</option>
+                      <option id="dev" value="/hono/docs/dev/admin-guide/coap-adapter-config/">dev</option>
                     
                   
               
-                  
-              
           
         </select>
         <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
@@ -1381,7 +1426,7 @@
                   
                   
                   <div id="top-github-link">
-                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/user-guide/device-registry.md" target="blank">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/admin-guide/coap-adapter-config.md" target="blank">
                       <i class="fas fa-code-branch"></i>
                       <span id="top-github-link-text">Edit this page</span>
                     </a>
@@ -1412,7 +1457,7 @@
             
           
           
-            <a href='/hono/docs/'>Documentation</a> > <a href='/hono/docs/user-guide/'>User Guide</a> > Device Registry
+            <a href='/hono/docs/'>Documentation</a> > <a href='/hono/docs/admin-guide/'>Admin Guide</a> > CoAP Adapter Configuration
           
          
           
@@ -1429,25 +1474,15 @@
 <ul>
 <li>
 <ul>
-<li><a href="#managing-tenants">Managing Tenants</a>
+<li><a href="#service-configuration">Service Configuration</a></li>
+<li><a href="#port-configuration">Port Configuration</a>
 <ul>
-<li><a href="#add-a-tenant">Add a Tenant</a></li>
-<li><a href="#get-configuration-details-of-a-tenant">Get configuration details of a Tenant</a></li>
-<li><a href="#update-tenant">Update Tenant</a></li>
-<li><a href="#delete-tenant">Delete Tenant</a></li>
+<li><a href="#secure-port-only">Secure Port Only</a></li>
+<li><a href="#insecure-port-only">Insecure Port Only</a></li>
+<li><a href="#dual-port">Dual Port</a></li>
+<li><a href="#ephemeral-ports">Ephemeral Ports</a></li>
 </ul></li>
-<li><a href="#managing-device-registration-information">Managing Device Registration Information</a>
-<ul>
-<li><a href="#register-device">Register Device</a></li>
-<li><a href="#read-device">Read Device</a></li>
-<li><a href="#update-device">Update Device</a></li>
-<li><a href="#delete-device">Delete Device</a></li>
-</ul></li>
-<li><a href="#managing-credentials">Managing Credentials</a>
-<ul>
-<li><a href="#update-credentials-for-a-device">Update Credentials for a Device</a></li>
-<li><a href="#get-all-credentials-for-a-device">Get all Credentials for a Device</a></li>
-</ul></li>
+<li><a href="#authentication">Authentication</a></li>
 </ul></li>
 </ul>
 </nav>
@@ -1462,541 +1497,295 @@
         
         <div id="body-inner">
           
-            <h1>Device Registry</h1>
+            <h1>CoAP Adapter Configuration</h1>
           
 
         
 
 
-<p>The Device Registry component provides exemplary implementations of Hono&rsquo;s <a href="/hono/docs/api/tenant/">Tenant API</a>, <a href="/hono/docs/api/device-registration/">Device Registration API</a> and <a href="/hono/docs/api/credentials/">Credentials API</a>.</p>
+<p>The CoAP protocol adapter exposes CoAP based endpoints for Eclipse Hono&trade;&rsquo;s south bound Telemetry, Event and Command &amp; Control APIs.</p>
 
-<p>As such it exposes AMQP 1.0 based endpoints for retrieving the relevant information and persists data in the local filesystem.</p>
+<p>The adapter is implemented as a Spring Boot application using <a href="https://www.eclipse.org/californium">Eclipse Californium&trade;</a> for implementing
+the CoAP protocol handling. It can be run either directly from the command line or by means of starting the corresponding
+<a href="https://hub.docker.com/r/eclipse/hono-adapter-coap-vertx/">Docker image</a> created from it.</p>
 
-<p>In addition, the Device Registry also exposes HTTP resources for managing the contents of the registry according to the <a href="/hono/docs/api/management/">Device Registry HTTP API</a>.</p>
+<p>The adapter supports the following standard configuration options:</p>
 
-<div class="alert alert-warning">
-    <h4 class="alert-heading"><i class="fas fa-exclamation-triangle"></i> Warning</h4>
-    <div><p>The Device Registry is not intended to be used in production environments. In particular, access to the HTTP resources described below is not restricted to authorized clients only.</p>
+<ul>
+<li><a href="/hono/docs/admin-guide/common-config/#java-vm-options">Common Java VM Options</a></li>
+<li><a href="/hono/docs/admin-guide/common-config/#vert-x-options">Common vert.x Options</a></li>
+<li><a href="/hono/docs/admin-guide/common-config/#protocol-adapter-options">Common Protocol Adapter Options</a></li>
+<li><a href="/hono/docs/admin-guide/monitoring-tracing-config/">Monitoring Options</a></li>
+</ul>
 
-<p>The resources have been designed to provide convenient access to the registry&rsquo;s content using command line tools like <em>curl</em> or <em>HTTPie</em>.</p>
-</div>
+<h2 id="service-configuration">Service Configuration</h2>
+
+<p>The following table provides an overview of the configuration variables and corresponding command line options for configuring the CoAP adapter.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="center">Mandatory</th>
+<th align="left">Default</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>HONO_APP_MAX_INSTANCES</code><br><code>--hono.app.maxInstances</code></td>
+<td align="center">no</td>
+<td align="left"><em>#CPU cores</em></td>
+<td align="left">The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_AUTHENTICATION_REQUIRED</code><br><code>--hono.coap.authenticationRequired</code></td>
+<td align="center">no</td>
+<td align="left"><code>true</code></td>
+<td align="left">If set to <code>true</code> the protocol adapter requires devices to authenticate when connecting to the adapter. The credentials provided by the device are verified using the configured <a href="#credentials-service-connection-configuration">Credentials Service</a>. Devices that fail to authenticate are not allowed to connect to the adapter.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_BIND_ADDRESS</code><br><code>--hono.coap.bindAddress</code></td>
+<td align="center">no</td>
+<td align="left"><code>127.0.0.1</code></td>
+<td align="left">The IP address of the network interface that the secure port should be bound to.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_CERT_PATH</code><br><code>--hono.coap.certPath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the PEM file containing the certificate that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with <code>HONO_COAP_KEY_PATH</code>.<br>Alternatively, the <code>HONO_COAP_KEY_STORE_PATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_COAP_THREADS</code><br><code>--hono.coap.coapThreads</code></td>
+<td align="center">no</td>
+<td align="left">2</td>
+<td align="left">The number of threads to use for processing CoAP message exchanges at the protocol layer.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_CONNECTOR_THREADS</code><br><code>--hono.coap.connectorThreads</code></td>
+<td align="center">no</td>
+<td align="left">2</td>
+<td align="left">The number of threads to use for receiving/sending UDP packets. The connector will start the given number of threads for each direction, outbound (sending) as well as inbound (receiving).</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_DTLS_THREADS</code><br><code>--hono.coap.dtlsThreads</code></td>
+<td align="center">no</td>
+<td align="left">32</td>
+<td align="left">The number of threads to use for processing DTLS message exchanges at the connection layer.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_DTLS_RETRANSMISSION_TIMEOUT</code><br><code>--hono.coap.dtlsRetransmissionTimeout</code></td>
+<td align="center">no</td>
+<td align="left">2000</td>
+<td align="left">The timeout in milliseconds for DTLS retransmissions.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_DEFAULTS_ENABLED</code><br><code>--hono.coap.defaultsEnabled</code></td>
+<td align="center">no</td>
+<td align="left"><code>true</code></td>
+<td align="left">If set to <code>true</code> the protocol adapter uses <em>default values</em> registered for a device to augment messages published by the device with missing information like a content type. In particular, the protocol adapter adds default values registered for the device as (application) properties with the same name to the AMQP 1.0 messages it sends downstream to the AMQP Messaging Network.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_EXCHANGE_LIFETIME</code><br><code>--hono.coap.exchangeLifetime</code></td>
+<td align="center">no</td>
+<td align="left">247000</td>
+<td align="left">The exchange lifetime in milliseconds. According RFC 7252, that value is 247s. Such a large time requires also a huge amount of heap. That time includes a processing time of 100s and retransmissions of CON messages. Therefore a practical value could be much smaller.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_INSECURE_NETWORK_CONFIG</code><br><code>--hono.coap.insecureNetworkConfig</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to a Californium properties file containing network configuration properties that should be used for the insecure CoAP port. If not set, Californium&rsquo;s default properties will be used.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_INSECURE_PORT</code><br><code>--hono.coap.insecurePort</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The insecure port the protocol adapter should listen on.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_INSECURE_PORT_BIND_ADDRESS</code><br><code>--hono.coap.insecurePortBindAddress</code></td>
+<td align="center">no</td>
+<td align="left"><code>127.0.0.1</code></td>
+<td align="left">The IP address of the network interface that the insecure port should be bound to.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_INSECURE_PORT_ENABLED</code><br><code>--hono.coap.insecurePortEnabled</code></td>
+<td align="center">no</td>
+<td align="left"><code>false</code></td>
+<td align="left">If set to <code>true</code> the protocol adapter will open an insecure port (not secured by TLS) using either the port number set via <code>HONO_COAP_INSECURE_PORT</code> or the default port number (<code>5683</code>) if not set explicitly.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_KEY_PATH</code><br><code>--hono.coap.keyPath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the (PKCS8) PEM file containing the private key that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with <code>HONO_COAP_CERT_PATH</code>. Alternatively, the <code>HONO_COAP_KEY_STORE_PATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_KEY_STORE_PASSWORD</code><br><code>--hono.coap.keyStorePassword</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The password required to read the contents of the key store.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_KEY_STORE_PATH</code><br><code>--hono.coap.keyStorePath</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to the Java key store containing the private key and certificate that the protocol adapter should use for authenticating to clients. Either this option or the <code>HONO_COAP_KEY_PATH</code> and <code>HONO_COAP_CERT_PATH</code> options need to be set in order to enable TLS secured connections with clients. The key store format can be either <code>JKS</code> or <code>PKCS12</code> indicated by a <code>.jks</code> or <code>.p12</code> file suffix respectively.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_MAX_CONNECTIONS</code><br><code>--hono.coap.maxConnections</code></td>
+<td align="center">no</td>
+<td align="left"><code>0</code></td>
+<td align="left">The maximum number of concurrent DTLS connections that the protocol adapter should accept. If set to <code>0</code>, the protocol adapter determines a reasonable value based on the available resources like memory and CPU.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_MAX_PAYLOAD_SIZE</code><br><code>--hono.coap.maxPayloadSize</code></td>
+<td align="center">no</td>
+<td align="left"><code>2048</code></td>
+<td align="left">The maximum allowed size of an incoming CoAP request&rsquo;s body in bytes. Requests with a larger body size are rejected with a 4.13 <code>Request entity too large</code> response.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_MESSAGE_OFFLOADING_ENABLED</code><br><code>--hono.coap.messageOffloadingEnabled</code></td>
+<td align="center">no</td>
+<td align="left">true</td>
+<td align="left">Enables to clear payload and serialized messages kept for deduplication in order to reduce the heap consumption. Experimental.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_NETWORK_CONFIG</code><br><code>--hono.coap.networkConfig</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The absolute path to a Californium properties file containing network configuration properties that should be used for the secure CoAP port. If not set, Californium&rsquo;s default properties will be used.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_PORT</code><br><code>--hono.coap.port</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The secure port that the protocol adapter should listen on.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_TENANT_IDLE_TIMEOUT</code><br><code>--hono.coap.tenantIdleTimeout</code></td>
+<td align="center">no</td>
+<td align="left"><code>0ms</code></td>
+<td align="left">The duration after which the protocol adapter removes local state of the tenant (e.g. open AMQP links) with an amount and a unit, e.g. <code>2h</code> for 2 hours. See the <a href="https://docs.spring.io/spring-boot/docs/current/reference/html/spring-boot-features.html#boot-features-external-config-conversion-duration">Spring Boot documentation</a> for an explanation of the format. The value <code>0ms</code> disables the timeout.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_COAP_TIMEOUT_TO_ACK</code><br><code>--hono.coap.timeoutToAck</code></td>
+<td align="center">no</td>
+<td align="left">500</td>
+<td align="left">Timeout to send a ACK and separate response. CoAP offers a very efficient piggybacked response, if that could be generated in time. This timeout waits for responding. If it expires without result, a ACK is sent and the response later. If the  result is available in time, it is sent as piggybacked response. Special values: 0, always use piggybacked-response, -1, never use piggybacked-response.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The variables only need to be set if the default value needs to be changed.</p>
+
+<h2 id="port-configuration">Port Configuration</h2>
+
+<p>The CoAP protocol adapter can be configured to listen for connections on</p>
+
+<ul>
+<li>a secure port only (default) or</li>
+<li>an insecure port only or</li>
+<li>both a secure and an insecure port (dual port configuration)</li>
+</ul>
+
+<p>The CoAP protocol adapter will fail to start if none of the ports is configured properly.</p>
+
+<h3 id="secure-port-only">Secure Port Only</h3>
+
+<p>The protocol adapter opens a DTLS secured port if any of the following criteria are met</p>
+
+<ul>
+<li>The <code>HONO_COAP_KEY_STORE_PATH</code> and <code>HONO_COAP_KEY_STORE_PASSWORD</code> environment variables are set in order to load a key and certificate from a password protected key store or</li>
+<li>the <code>HONO_COAP_KEY_PATH</code> and <code>HONO_COAP_CERT_PATH</code> environment variables are set in order to load a key and certificate from two separate PEM files in PKCS8 format or</li>
+<li>the <code>HONO_COAP_PORT</code> environment variable is set to a valid port number.</li>
+</ul>
+
+<p>When starting up, the protocol adapter will bind a DTLS secured UDP socket to the configured port. If the port is not set explicitly, the default CoAP secure port 5684 is used.</p>
+
+<p>The <code>HONO_COAP_BIND_ADDRESS</code> variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the <em>loopback device</em> only,
+i.e. the port will only be accessible from the local host. Setting this variable to <code>0.0.0.0</code> will let the port being bound to <strong>all</strong> network interfaces (be careful not to expose
+the port unintentionally to the outside world).</p>
+
+<h3 id="insecure-port-only">Insecure Port Only</h3>
+
+<p>The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-DTLS secured port instead, e.g. for testing purposes.
+In any case, the non-secure port needs to be explicitly enabled by</p>
+
+<ul>
+<li>explicitly setting <code>HONO_COAP_AUTHENTICATION_REQUIRED</code> to <code>false</code> and either
+
+<ul>
+<li>explicitly setting <code>HONO_COAP_INSECURE_PORT</code> to a valid port number or</li>
+<li>implicitly configuring the default insecure CoAP port (5683) by setting <code>HONO_COAP_INSECURE_PORT_ENABLED</code> to <code>true</code>.</li>
+</ul></li>
+</ul>
+
+<p>The protocol adapter issues a warning on the console if <code>HONO_COAP_INSECURE_PORT</code> is set to the default secure CoAP port (5684).</p>
+
+<p>The <code>HONO_COAP_INSECURE_PORT_BIND_ADDRESS</code> variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the <em>loopback device</em> only,
+i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-DTLS secured port on a local interface only, thus providing easy access from within
+the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.</p>
+
+<p>Setting this variable to <code>0.0.0.0</code> will let the port being bound to <strong>all</strong> network interfaces (be careful not to expose the port unintentionally to the outside world).</p>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Note</h4>
+    <div>The insecure port will only be bound if the <code>HONO_COAP_AUTHENTICATION_REQUIRED</code> variable is set to <code>false</code> because CoAP authenticates clients (devices) as
+part of the DTLS handshake. Thus, requiring devices to authenticate effectively rules out setting up a non-DTLS secured port.</div>
 </div>
 
 
-<h2 id="managing-tenants">Managing Tenants</h2>
+<h3 id="dual-port">Dual Port</h3>
 
-<p>The following sections describe the resources representing the operations of the Tenant API and how they can be used to manage tenants.
-Please refer to the <a href="/hono/docs/api/management/">Device Registry HTTP API</a> for the specific elements that are explained in detail there.</p>
+<p>The protocol adapter may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work,
+both ports must be configured to use different port numbers, otherwise startup will fail.</p>
 
-<h3 id="add-a-tenant">Add a Tenant</h3>
+<h3 id="ephemeral-ports">Ephemeral Ports</h3>
 
-<ul>
-<li>URI: <code>/v1/tenants/${tenantId}</code></li>
-<li>Method: <code>POST</code></li>
-<li>Request Headers:
+<p>Both the secure as well as the insecure port numbers may be explicitly set to <code>0</code>. The protocol adapter will then use arbitrary (unused) port numbers determined by the operating system during startup.</p>
 
-<ul>
-<li>(required) <code>Content-Type</code>: <code>application/json</code> (no other type supported)</li>
-</ul></li>
-<li>Request Body:
+<h2 id="authentication">Authentication</h2>
 
-<ul>
-<li>(Optional) A JSON object as specified by <a href="/hono/docs/api/management/">Tenant schema</a> of the HTTP API specification.</li>
-</ul></li>
-<li>Status Codes:
+<p>The CoAP protocol is UDP based and as such uses the DTLS protocol to secure the communication between a client (device) and a server (adapter). The CoAP adapter also uses the DTLS handshake
+to prove its identity to devices and to authenticate the devices themselves. The DTLS protocol allows for different <em>cipher suites</em> to be
+used for doing so. These suites mainly differ from each other in the type of secret being used for proving the participants&rsquo; identity to each other.
+One class of suites is based on a secret that is shared between the client and the server, very much like in a username/password based authentication scheme. This class of suites
+is called <em>pre-shared key</em> or PSK-based and is very popular for use cases where the devices are very constrained regarding CPU and memory. Another class of cipher suites is based
+on certificates which use asymmetric encryption for proving possession of the secret (the private key). The CoAP adapter supports cipher suites from both classes but only supports
+<em>elliptic curve cryptography</em> (ECC) based keys for the latter class of cipher suites.</p>
 
-<ul>
-<li>201 (Created): Tenant has been added successfully under the resource indicated by <code>Location</code> header.</li>
-<li>400 (Bad Request): The tenant has not been created because the request was malformed, e .g. because the payload was malformed. The response body may contain hints regarding the cause of the problem.</li>
-<li>409 (Conflict): A tenant with the given <code>tenantId</code> already exists. The request has not been processed.</li>
-</ul></li>
-<li>Response Headers:
+<p>When enabling the secure port without configuring an ECC based key and certificate, the adapter will only use PSK based cipher suites for authentication.
+When configuring an ECC based key and certificate, the adapter will also offer certificate based cipher suites to the client to use for authentication.</p>
 
-<ul>
-<li><code>Location</code>: The URI under which the newly created resource can be accessed.</li>
-<li><code>ETag</code>: Version of the resource</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<p>The following commands add some tenants with different adapter configurations:</p>
-
-<p>Add a tenant that has all adapters set to enabled:</p>
-
-<pre><code class="language-sh">curl -i -X POST http://localhost:28080/v1/tenants/tenantAllAdapters
-
-HTTP/1.1 201 Created
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4
-Location: /v1/tenants/tenantAllAdapters
-Content-Type: application/json; charset=utf-8
-
-{&quot;id&quot;: &quot;tenantAllAdapters&quot;}
-</code></pre>
-
-<p>Add a tenant that can only use the MQTT adapter:</p>
-
-<pre><code class="language-sh">curl -i -X POST -H 'Content-Type: application/json' --data-binary '{
-    &quot;adapters&quot;: [ {
-        &quot;type&quot;: &quot;hono-mqtt&quot;,
-        &quot;enabled&quot;: true
-        } ]
-  }' http://localhost:28080/v1/tenants/tenantMqttAdapter
-
-HTTP/1.1 201 Created
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4
-Location:  /v1/tenants/tenantMqttAdapter
-Content-Type: application/json; charset=utf-8
-
-{&quot;id&quot;: &quot;tenantMqttAdapter&quot;}
-</code></pre>
-
-<h3 id="get-configuration-details-of-a-tenant">Get configuration details of a Tenant</h3>
-
-<ul>
-<li>URI: <code>/v1/tenants/${tenantId}</code></li>
-<li>Method: <code>GET</code></li>
-<li>Status Codes:
-
-<ul>
-<li>200 (OK): A tenant with the given identifier has been found. The response body contains the tenant data as specified by <a href="/hono/docs/api/management/">Tenant schema</a> of the HTTP API specification.</li>
-<li>404 (Not Found): No tenant with the given identifier is registered.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<p>The following command retrieves the details for the tenant <code>tenantMqttAdapter</code>:</p>
-
-<pre><code class="language-sh">curl -i http://localhost:28080/v1/tenants/tenantMqttAdapter
-
-HTTP/1.1 200 OK
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4
-Content-Type: application/json; charset=utf-8
-
-{
-     &quot;enabled&quot;: true,
-     &quot;adapters&quot;: [ {
-         &quot;type&quot;: &quot;hono-mqtt&quot;,
-         &quot;enabled&quot;: true
-     } ]
-}
-</code></pre>
-
-<p><strong>NB</strong> A tenant can be created without specifying a tenant identifier. The device registry will generate a tenant ID:</p>
-
-<pre><code class="language-sh">curl -i  -X POST http://localhost:28080/v1/tenants/
-
-HTTP/1.1 201 Created
-Etag: edc93899-7838-4dd1-93c8-839748c2fa42
-location: /v1/tenants/0b2df55f-1a02-43f7-a1c0-f3dbd25041e0
-content-type: application/json; charset=utf-8
-content-length: 45
-
-{&quot;id&quot;:&quot;0b2df55f-1a02-43f7-a1c0-f3dbd25041e0&quot;}
-</code></pre>
-
-<h3 id="update-tenant">Update Tenant</h3>
-
-<ul>
-<li>URI: <code>/v1/tenants/${tenantId}</code></li>
-<li>Method: <code>PUT</code></li>
-<li>Request Headers:
-
-<ul>
-<li>(required) <code>Content-Type</code>: <code>application/json</code> (no other type supported)</li>
-</ul></li>
-<li>Request Body:
-
-<ul>
-<li>(required) A JSON object as specified by <a href="/hono/docs/api/management/">Tenant schema</a> of the HTTP API specification.</li>
-</ul></li>
-<li>Status Codes:
-
-<ul>
-<li>204 (No Content): The tenant has been updated successfully.</li>
-<li>400 (Bad Request): The tenant has not been updated because the request was malformed, e .g. because the payload was malformed. The response body may contain hints regarding the cause of the problem.</li>
-<li>404 (Not Found): The request could not be processed because no tenant with the given identifier exists.</li>
-</ul></li>
-</ul>
-
-<p>This resource can be used to change the configuration of a particular tenant.</p>
-
-<p><strong>Example</strong></p>
-
-<p>The following command disables the MQTT adapter for devices that belong to the tenant <code>tenantMqttAdapter</code>:</p>
-
-<pre><code class="language-sh">curl -i -X PUT -H 'Content-Type: application/json' --data-binary '{
-      &quot;adapters&quot;: [ {
-          &quot;type&quot;: &quot;hono-mqtt&quot;,
-          &quot;enabled&quot;: true
-          } ]
-  }' http://localhost:28080/v1/tenants/tenantMqttAdapter
-
-HTTP/1.1 204 No Content
-ETag: 8919c736-30aa-40ce-a45a-830b90c4cd42
-Content-Length: 0
-</code></pre>
-
-<h3 id="delete-tenant">Delete Tenant</h3>
-
-<ul>
-<li>URI: <code>/v1/tenants/${tenantId}</code></li>
-<li>Method: <code>DELETE</code></li>
-<li>Status Codes:
-
-<ul>
-<li>204 (No Content): The tenant with the given identifier has been deleted.</li>
-<li>404 (Not Found): The request could not be processed because no tenant with the given identifier exists.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<pre><code class="language-sh">curl -i -X DELETE http://localhost:28080/v1/tenants/tenantMqttAdapter
-
-HTTP/1.1 204 No Content
-Content-Length: 0
-</code></pre>
-
-<h2 id="managing-device-registration-information">Managing Device Registration Information</h2>
-
-<p>The following sections describe the resources representing the operations of the <a href="/hono/docs/api/device-registration/">Device Registration API</a> and how they can be used to manage device registration information.
-Please refer to the <a href="/hono/docs/api/management/">Device Registry HTTP API</a> for the specific elements that are explained in detail there.</p>
-
-<h3 id="register-device">Register Device</h3>
-
-<ul>
-<li>URI: <code>/v1/devices/${tenantId}/${deviceId}</code></li>
-<li>Method: <code>POST</code></li>
-<li>Headers:
-
-<ul>
-<li>(required) <code>Content-Type</code>: <code>application/json</code></li>
-</ul></li>
-<li>Request Body:
-
-<ul>
-<li>(Optional) A JSON object as specified by <a href="/hono/docs/api/management/">Device schema</a> of the HTTP API specification.</li>
-</ul></li>
-<li>Status Codes:
-
-<ul>
-<li>201 (Created): Device has been registered successfully under resource indicated by <code>Location</code> header.</li>
-<li>400 (Bad Request): Device has not been registered because the request was malformed, e .g. a required header is missing (the body may contain hints regarding the problem).</li>
-<li>409 (Conflict): There already exists a device with the given ID. The request has not been processed.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<p>The following command registers a device with ID <code>4711</code> for tenant <code>DEFAULT_TENANT</code></p>
-
-<pre><code class="language-sh">curl -i -X POST -H 'Content-Type: application/json' --data-binary '{
-    &quot;ext&quot;: {
-        &quot;ep&quot;: &quot;IMEI4711&quot;
-    }
-}' http://localhost:28080/v1/devices/DEFAULT_TENANT/4711
-</code></pre>
-
-<p>The response will contain a <code>Location</code> header containing the resource path created for the device. In this example it will look
-like this:</p>
-
-<pre><code class="language-sh">HTTP/1.1 201 Created
-Location: /v1/devices/DEFAULT_TENANT/4711
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4
-Content-Type: application/json; charset=utf-8
-
-{&quot;id&quot;: &quot;4711&quot;}
-</code></pre>
-
-<p><strong>NB</strong> A device can be created without specifying a device identifier. The device registry will generate a device identifier:</p>
-
-<pre><code class="language-sh">curl -i -X POST http://localhost:28080/v1/devices/DEFAULT_TENANT
-
-HTTP/1.1 201 Created
-Etag: 0d615bcd-0825-44d9-9ef5-54a7b12165d8
-location: /v1/devices/DEFAULT_TENANT/98d25103-d49d-44b0-bdd0-0de84743c522
-content-type: application/json; charset=utf-8
-content-length: 45
-
-{&quot;id&quot;:&quot;98d25103-d49d-44b0-bdd0-0de84743c522&quot;}
-</code></pre>
-
-<h3 id="read-device">Read Device</h3>
-
-<ul>
-<li>URI: <code>/v1/devices/${tenantId}/${deviceId}</code></li>
-<li>Method: <code>GET</code></li>
-<li>Status Codes:
-
-<ul>
-<li>200 (OK): A device with the given identifier has been found. The response body contains the registration information as specified by <a href="/hono/docs/api/management/">Device schema</a> of the HTTP API specification.</li>
-<li>404 (Not Found): No device with the given identifier is registered for the given tenant.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<p>The following command retrieves registration data for device <code>4711</code>:</p>
-
-<pre><code class="language-sh">curl -i http://localhost:28080/v1/devices/DEFAULT_TENANT/4711
-
-HTTP/1.1 200 OK
-Content-Type: application/json; charset=utf-8
-
-{
-    &quot;enabled&quot;: true,
-    &quot;ext&quot;: {
-        &quot;ep&quot;: &quot;IMEI4711&quot;
-    }
-}
-</code></pre>
-
-<h3 id="update-device">Update Device</h3>
-
-<ul>
-<li>URI: <code>/devices/v1/${tenantId}/${deviceId}</code></li>
-<li>Method: <code>PUT</code></li>
-<li>Headers:
-
-<ul>
-<li>(required) <code>Content-Type</code>: <code>application/json</code></li>
-</ul></li>
-<li>Parameters (encoded as a JSON object in the request body):</li>
-<li>Request Body:
-
-<ul>
-<li>(required) A JSON object as specified by <a href="/hono/docs/api/management/">Device schema</a> of the HTTP API specification. All existing registration information will be replaced by the data provided in the object.</li>
-</ul></li>
-<li>Status Codes:
-
-<ul>
-<li>204 (No Content): Device registration data has been updated.</li>
-<li>400 (Bad Request): Device registration has not been updated because the request was malformed, e .g. a required header is missing (the body may contain hints regarding the problem).</li>
-<li>404 (Not Found): No device with the given identifier is registered for the given tenant.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<pre><code class="language-sh">curl -i -X PUT -H 'Content-Type: application/json' --data-binary '{
-    &quot;ext&quot;: {
-        &quot;ep&quot;: &quot;IMEI4711&quot;,
-        &quot;psk-id&quot;: &quot;psk4711&quot;
-    }
-}' http://localhost:28080/v1/devices/DEFAULT_TENANT/4711
-
-HTTP/1.1 204 No Content
-Content-Length: 0
-</code></pre>
-
-<h3 id="delete-device">Delete Device</h3>
-
-<ul>
-<li>URI: <code>/v1/devices/${tenantId}/${deviceId}</code></li>
-<li>Method: <code>DELETE</code></li>
-<li>Status Codes:
-
-<ul>
-<li>204 (No Content): Device registration has been deleted.</li>
-<li>404 (Not Found): No device with the given identifier is registered for the given tenant.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<pre><code class="language-sh">curl -i -X DELETE http://localhost:28080/v1/devices/DEFAULT_TENANT/4711
-
-HTTP/1.1 204 No Content
-Content-Length: 0
-</code></pre>
-
-<h2 id="managing-credentials">Managing Credentials</h2>
-
-<p>The following sections describe the resources representing the operations of the Credentials API and how they can be used to manage credentials for devices.
-Please refer to the <a href="/hono/docs/api/management/">Device Registry HTTP API</a> for the specific elements that are explained in detail there.</p>
-
-<h3 id="update-credentials-for-a-device">Update Credentials for a Device</h3>
-
-<ul>
-<li>URI: <code>/v1/credentials/${tenantId}/${deviceId}</code></li>
-<li>Method: <code>PUT</code></li>
-<li>Request Headers:
-
-<ul>
-<li>(required) <code>Content-Type</code>: <code>application/json</code> (no other type supported)</li>
-</ul></li>
-<li>Request Body:
-
-<ul>
-<li>(required) A JSON object as specified by <a href="/hono/docs/api/management/">Credentials schema</a> of the HTTP API specification.</li>
-</ul></li>
-<li>Status Codes:
-
-<ul>
-<li>204 (No Content): Credentials have been updated successfully.</li>
-<li>400 (Bad Request): The credentials have not been added because the request was malformed, e .g. because the payload did not contain required values. The response body may contain hints regarding the cause of the problem.</li>
-</ul></li>
-<li>Response Headers:
-
-<ul>
-<li><code>ETag</code>: Version of the resource</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<p>The following command adds some <code>hashed-password</code> credentials from a given plain text password for device <code>4710</code> using authentication identifier <code>sensor10</code>:</p>
-
-<pre><code class="language-sh">curl -i -X PUT -H 'Content-Type: application/json' --data-binary '[{
-  &quot;type&quot;: &quot;hashed-password&quot;,
-  &quot;auth-id&quot;: &quot;sensor10&quot;,
-  &quot;secrets&quot;: [{
-      &quot;pwd-plain&quot;: &quot;mylittlesecret&quot;
-  }]
-}]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4710
-  
-HTTP/1.1 204 No Content
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4x
-</code></pre>
-
-<p>This uses a convenient option which lets the Device Registry do the hashing of the password. The following command retrieves the credentials that are stored by the Device Registry as a result of the command above:</p>
-
-<pre><code class="language-sh">curl -i http://localhost:28080/v1/credentials/DEFAULT_TENANT/4710
-
-HTTP/1.1 200 OK
-Content-Type: application/json; charset=utf-8
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4x
-
-[{
-  &quot;type&quot;: &quot;hashed-password&quot;,
-  &quot;auth-id&quot;: &quot;sensor10&quot;,
-  &quot;enabled&quot;: true,
-  &quot;secrets&quot;: [
-    {
-      &quot;id&quot;: &quot;349556ea-4902-47c7-beb0-1009ab693fb4&quot;
-    }
-  ]
-}]
-</code></pre>
-
-<p>The above result does not contain <code>pwd_hash</code> and <code>hash_function</code> of the secret, as these values are confidential.</p>
-
-<p>The following commands set some <code>hashed-password</code> credentials for device <code>4720</code> using authentication identifier <code>sensor20</code>:</p>
-
-<pre><code class="language-sh">curl -i -X PUT -H 'Content-Type: application/json' --data-binary '[{
-    &quot;type&quot;: &quot;hashed-password&quot;,
-    &quot;auth-id&quot;: &quot;sensor20&quot;,
-    &quot;secrets&quot;: [{
-        &quot;pwd-plain&quot;: &quot;mylittlesecret&quot;
-    }]
-  }]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720
-
-HTTP/1.1 204 No Content
-ETag: 02c99fb5-af8c-409f-8520-b405e224b27f
-</code></pre>
-
-<p>The following command adds an expiration date to the <code>hashed-password</code> credentials for authentication identifier <code>sensor20</code>:</p>
-
-<pre><code class="language-sh">curl -i -X PUT -H 'Content-Type: application/json' --data-binary '{
-    &quot;device-id&quot;: &quot;4720&quot;,
-    &quot;type&quot;: &quot;hashed-password&quot;,
-    &quot;auth-id&quot;: &quot;sensor20&quot;,
-    &quot;secrets&quot;: [{
-        &quot;pwd-plain&quot;: &quot;mylittlesecret&quot;,
-        &quot;not-after&quot;: &quot;2018-01-01T00:00:00+01:00&quot;
-    }]
-}' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720
-
-HTTP/1.1 204 No Content
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4x
-</code></pre>
-
-<p>Multiple credentials of different type can be registered for the same authentication identifier.
-The following commands add <code>psk</code> credentials for the same device <code>4720</code> using authentication identifier <code>sensor20</code>:</p>
-
-<pre><code class="language-sh">SHARED_KEY=$(echo -n &quot;TheSharedKey&quot; | base64 -w 0)
-curl -i -X PUT -H 'Content-Type: application/json' --data-binary '[
-{
-    &quot;type&quot;: &quot;hashed-password&quot;,
-    &quot;auth-id&quot;: &quot;sensor20&quot;,
-    &quot;secrets&quot;: [{
-        &quot;pwd-plain&quot;: &quot;mylittlesecret&quot;
-    }]
-},
-{
-   &quot;device-id&quot;: &quot;4720&quot;,
-   &quot;type&quot;: &quot;psk&quot;,
-   &quot;auth-id&quot;: &quot;sensor20&quot;,
-   &quot;secrets&quot;: [{
-     &quot;key&quot;: &quot;'$SHARED_KEY'&quot;
-     }]
-  }]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720
-
-HTTP/1.1 204 No Content
-ETag: 122c971a-505a-4336-8f7d-640360e909bc
-</code></pre>
-
-<p>The following command deletes all credentials for device <code>4710</code>:</p>
-
-<pre><code class="language-sh">curl -i -X PUT -H 'Content-Type: application/json' --data-binary '[]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4710
-
-HTTP/1.1 204 No Content
-ETag: d383ba4d-1853-4d03-b322-b7ff5af05ae2
-</code></pre>
-
-<h3 id="get-all-credentials-for-a-device">Get all Credentials for a Device</h3>
-
-<ul>
-<li>URI: <code>/v1/credentials/${tenantId}/${deviceId}</code></li>
-<li>Method: <code>GET</code></li>
-<li>Status Codes:
-
-<ul>
-<li>200 (OK): Credentials for the device have been found, body contains the credentials. The response body contains the registration information as specified by <a href="/hono/docs/api/management/">Credentials schema</a> of the HTTP API specification.</li>
-<li>404 (Not Found): No credentials for the device are registered.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<p>The following command retrieves credentials metadata for device <code>4720</code>:</p>
-
-<pre><code class="language-sh">curl -i http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720
-
-HTTP/1.1 200 OK
-Content-Type: application/json; charset=utf-8
-ETag: f3449b77-2c84-4b09-8d04-2b305876e0cb
-
-{[
-    {
-        &quot;auth-id&quot;: &quot;sensor20&quot;,
-        &quot;enabled&quot;: true,
-        &quot;secrets&quot;: [
-            {
-                &quot;id&quot;: &quot;d383ba4d-1853-4d03-b322-b7ff5af05ae2&quot;
-                &quot;not-after&quot;: &quot;2020-02-1T00:00:00+01:00&quot;
-            },
-            {
-                &quot;id&quot;: &quot;46810d5c-133e-4c1c-994d-ed7745516b8e&quot;
-                &quot;not-before&quot;: &quot;2020-01-01T00:00:00+01:00&quot;
-            }
-        ],
-        &quot;type&quot;: &quot;hashed-password&quot;
-    },
-    {
-        &quot;auth-id&quot;: &quot;sensor20&quot;,
-        &quot;enabled&quot;: true,
-        &quot;secrets&quot;: [
-            {
-                &quot;key&quot;: &quot;VGhlU2hhcmVkS2V5&quot;
-            }
-        ],
-        &quot;type&quot;: &quot;psk&quot;
-    }
-]}
-</code></pre>
+<p>In any case the device&rsquo;s credentials need to be registered with the device registry. Please refer to the <a href="/hono/docs/api/credentials/#standard-credential-types">Standard Credential Types</a>
+and the <a href="/hono/docs/api/management/">Device Registry Management API</a> for additional information.</p>
 
 <footer class=" footline" >
 	
@@ -2181,155 +1970,6 @@
             
                 
                     
-                    
-                
-                
-
-                    
-                    
-                    
-
-                    
-                        
-            
-            
-                
-                    
-                    
-                
-                
-
-                    
-                    
-                    
-
-                    
-            
-        
-                    
-                        
-            
-            
-                
-                    
-                        
-                        
-                    
-                
-                
-
-                    
-                    
-                    
-
-                    
-            
-        
-                    
-                        
-            
-            
-                
-                    
-                
-                
-
-                    
-                    
-                    
-
-                    
-            
-        
-                    
-                        
-            
-            
-                
-                    
-                
-                
-
-                    
-                    
-                    
-
-                    
-            
-        
-                    
-                        
-            
-            
-                
-                    
-                
-                
-
-                    
-                    
-                    
-
-                    
-            
-        
-                    
-                        
-            
-            
-                
-                    
-                
-                
-
-                    
-                    
-                    
-
-                    
-            
-        
-                    
-                        
-            
-            
-                
-                    
-                
-                
-
-                    
-                    
-                    
-
-                    
-            
-        
-                    
-                        
-            
-            
-                
-                    
-                
-                
-
-                    
-                    
-                    
-
-                    
-            
-        
-                    
-            
-        
-                    
-                        
-            
-            
-                
-                    
                 
                 
 
@@ -2482,6 +2122,206 @@
             
         
                     
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
                         
             
             
@@ -2932,20 +2772,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/admin-guide/common-config/index.html b/docs/admin-guide/common-config/index.html
index dc2256d..e1e1de7 100644
--- a/docs/admin-guide/common-config/index.html
+++ b/docs/admin-guide/common-config/index.html
@@ -21,19 +21,19 @@
     <title>Common Configuration :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/common-config/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/common-config/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/common-config/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/common-config/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/common-config/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/common-config/">dev</option>
@@ -1462,6 +1545,7 @@
 <li><a href="#direct-connection-to-data-grid">Direct Connection to Data Grid</a></li>
 </ul></li>
 <li><a href="#resource-limits-checker-configuration">Resource Limits Checker Configuration</a></li>
+<li><a href="#connection-event-producer-configuration">Connection Event Producer Configuration</a></li>
 </ul></li>
 </ul></li>
 </ul>
@@ -1630,7 +1714,7 @@
 
 <h4 id="direct-connection-to-data-grid">Direct Connection to Data Grid</h4>
 
-<p>Protocol adapters can alternatively be configured to directly access an data grid for storing and retrieving
+<p>Protocol adapters can alternatively be configured to directly access a data grid for storing and retrieving
 device connection information using <a href="https://infinispan.org">Infinispan</a>&rsquo;s Hotrod protocol.
 This has the advantage of saving the network hop to the Device Connection service. However,
 this is only beneficial if the Device Connection service implementation itself uses a remote service (like a data grid) for
@@ -1714,25 +1798,32 @@
 </tr>
 
 <tr>
-<td align="left"><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_CACHE_MIN_SIZE</code><br><code>--hono.resourceLimits.prometheusBased.cacheMinSize</code></td>
+<td align="left"><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_CACHEMINSIZE</code><br><code>--hono.resourceLimits.prometheusBased.cacheMinSize</code></td>
 <td align="center">no</td>
 <td align="left"><code>20</code></td>
 <td align="left">The minimum size of the cache to store the metrics data retrieved from the Prometheus server. The cache is used for storing the current amount of data exchanged with devices of tenants.</td>
 </tr>
 
 <tr>
-<td align="left"><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_CACHE_MAX_SIZE</code><br><code>--hono.resourceLimits.prometheusBased.cacheMaxSize</code></td>
+<td align="left"><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_CACHEMAXSIZE</code><br><code>--hono.resourceLimits.prometheusBased.cacheMaxSize</code></td>
 <td align="center">no</td>
 <td align="left"><code>1000</code></td>
 <td align="left">The maximum size of the cache to store the metrics data retrieved from the Prometheus server.</td>
 </tr>
 
 <tr>
-<td align="left"><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_CACHE_TIMEOUT</code><br><code>--hono.resourceLimits.prometheusBased.cacheTimeout</code></td>
+<td align="left"><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_CACHETIMEOUT</code><br><code>--hono.resourceLimits.prometheusBased.cacheTimeout</code></td>
 <td align="center">no</td>
-<td align="left"><code>600</code></td>
+<td align="left"><code>15</code></td>
 <td align="left">The number of seconds after which the cached metrics data should be considered invalid.</td>
 </tr>
+
+<tr>
+<td align="left"><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_QUERYTIMEOUT</code><br><code>--hono.resourceLimits.prometheusBased.queryTimeout</code></td>
+<td align="center">no</td>
+<td align="left"><code>500</code></td>
+<td align="left">The number of milliseconds after which a request to a Prometheus server is closed. Setting zero or a negative value disables the timeout.</td>
+</tr>
 </tbody>
 </table>
 
@@ -1754,6 +1845,42 @@
 <li><code>HONO_RESOURCELIMITS_PROMETHEUSBASED_USERNAME</code></li>
 </ul>
 
+<h3 id="connection-event-producer-configuration">Connection Event Producer Configuration</h3>
+
+<p>Some of the protocol adapters report the establishment and termination of a connection with a device by means of a
+<a href="/hono/docs/concepts/connection-events/">Connection Event Producer</a>.</p>
+
+<p>The producer being used by the adapter can be configured as follows:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="center">Mandatory</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>HONO_CONNECTIONEVENTS_PRODUCER</code><br><code>--hono.connectionEvents.producer</code></td>
+<td align="center">no</td>
+<td align="left"><code>logging</code></td>
+<td align="left">The type of connection event producer to use for reporting the establishment/termination of device connections. Supported values are<br><code>none</code> - No information is reported at all.<br><code>logging</code> - All information is reported at <em>INFO</em> level via the logging framework.<br><code>events</code> - All information is being sent downstream as <a href="/hono/docs/api/event/#connection-event">Connection Events</a>.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_CONNECTIONEVENTS_LOGLEVEL</code><br><code>--hono.connectionEvents.logLevel</code></td>
+<td align="center">no</td>
+<td align="left"><code>info</code></td>
+<td align="left">The level to log connection information at. Supported values are <code>debug</code> and <code>info</code>.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The <code>events</code> based connection event producer sets the TTL of event messages that it emits to the <em>max TTL</em> <a href="/hono/docs/api/tenant/#resource-limits-configuration-format">configured at the tenant level</a>.</p>
+
 <footer class=" footline" >
 	
 </footer>
@@ -2073,6 +2200,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2286,6 +2429,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2688,20 +2863,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/admin-guide/device-connection-config/index.html b/docs/admin-guide/device-connection-config/index.html
index 5665702..4d33f55 100644
--- a/docs/admin-guide/device-connection-config/index.html
+++ b/docs/admin-guide/device-connection-config/index.html
@@ -21,19 +21,19 @@
     <title>Configuring the Device Connection Service :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/device-connection-config/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/device-connection-config/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/device-connection-config/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/device-connection-config/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/device-connection-config/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/device-connection-config/">dev</option>
@@ -1453,7 +1536,11 @@
 <li><a href="#dual-port">Dual Port</a></li>
 <li><a href="#ephemeral-ports">Ephemeral Ports</a></li>
 </ul></li>
-<li><a href="#data-grid-connection-configuration">Data Grid Connection Configuration</a></li>
+<li><a href="#data-grid-connection-configuration">Data Grid Connection Configuration</a>
+<ul>
+<li><a href="#remote-cache">Remote cache</a></li>
+<li><a href="#embedded-cache">Embedded cache</a></li>
+</ul></li>
 <li><a href="#authentication-service-connection-configuration">Authentication Service Connection Configuration</a></li>
 <li><a href="#metrics-configuration">Metrics Configuration</a></li>
 </ul></li>
@@ -1653,7 +1740,50 @@
 
 <h2 id="data-grid-connection-configuration">Data Grid Connection Configuration</h2>
 
-<p>The Device Connection component requires a connection to a remote data grid using the Infinispan Hotrod protocol to store device connection information in.</p>
+<p>The Device Connection component requires either an embedded cache or a remote
+data grid, using the Infinispan Hotrod protocol to store device information.</p>
+
+<p>The following table provides an overview of the configuration variables and corresponding command line options for configuring the common aspects of the service:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="center">Mandatory</th>
+<th align="left">Default</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_COMMON_CACHENAME</code><br><code>--hono.deviceConnection.common.cacheName</code></td>
+<td align="center">no</td>
+<td align="left"><code>device-connection</code></td>
+<td align="left">The name of the cache</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_COMMON_CHECKKEY</code><br><code>--hono.deviceConnection.common.checkKey</code></td>
+<td align="center">no</td>
+<td align="left"><code>KEY_CONNECTION_CHECK</code></td>
+<td align="left">The key used to check the health of the cache.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_COMMON_CHECKVALUE</code><br><code>--hono.deviceConnection.common.checkValue</code></td>
+<td align="center">no</td>
+<td align="left"><code>VALUE_CONNECTION_CHECK</code></td>
+<td align="left">The value used to check the health of the cache.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The type of the cache is selected on startup by enabling or disabling the
+profile <code>embedded-cache</code>. If the profile is enabled the embedded cache is
+used, otherwise the remote cache is being used. The remote cache is the default.</p>
+
+<h3 id="remote-cache">Remote cache</h3>
 
 <p>The following table provides an overview of the configuration variables and corresponding command line options for configuring the connection to the data grid:</p>
 
@@ -1669,28 +1799,35 @@
 
 <tbody>
 <tr>
-<td align="left"><code>HONO_DEVICECONNECTION_REMOTE_SERVER_LIST</code><br><code>--hono.deviceConnection.remote.serverList</code></td>
+<td align="left"><code>HONO_DEVICECONNECTION_REMOTE_SERVERLIST</code><br><code>--hono.deviceConnection.remote.serverList</code></td>
 <td align="center">yes</td>
 <td align="left">-</td>
 <td align="left">A list of remote servers in the form: <code>host1[:port][;host2[:port]]....</code>.</td>
 </tr>
 
 <tr>
-<td align="left"><code>HONO_DEVICECONNECTION_REMOTE_AUTH_SERVER_NAME</code><br><code>--hono.deviceConnection.remote.authServerName</code></td>
+<td align="left"><code>HONO_DEVICECONNECTION_REMOTE_AUTHSERVERNAME</code><br><code>--hono.deviceConnection.remote.authServerName</code></td>
 <td align="center">yes</td>
 <td align="left">-</td>
 <td align="left">The server name to indicate in the SASL handshake when authenticating to the server.</td>
 </tr>
 
 <tr>
-<td align="left"><code>HONO_DEVICECONNECTION_REMOTE_AUTH_USERNAME</code><br><code>--hono.deviceConnection.remote.authUsername</code></td>
+<td align="left"><code>HONO_DEVICECONNECTION_REMOTE_AUTHREALM</code><br><code>--hono.deviceConnection.remote.authRealm</code></td>
+<td align="center">yes</td>
+<td align="left">-</td>
+<td align="left">The authentication realm for the SASL handshake when authenticating to the server.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_REMOTE_AUTHUSERNAME</code><br><code>--hono.deviceConnection.remote.authUsername</code></td>
 <td align="center">yes</td>
 <td align="left">-</td>
 <td align="left">The username to use for authenticating to the server.</td>
 </tr>
 
 <tr>
-<td align="left"><code>HONO_DEVICECONNECTION_REMOTE_AUTH_PASSWORD</code><br><code>--hono.deviceConnection.remote.authPassword</code></td>
+<td align="left"><code>HONO_DEVICECONNECTION_REMOTE_AUTHPASSWORD</code><br><code>--hono.deviceConnection.remote.authPassword</code></td>
 <td align="center">yes</td>
 <td align="left">-</td>
 <td align="left">The password to use for authenticating to the server.</td>
@@ -1700,6 +1837,32 @@
 
 <p>In general, the service supports all configuration properties of the <a href="https://docs.jboss.org/infinispan/9.4/apidocs/org/infinispan/client/hotrod/configuration/package-summary.html#package.description">Infinispan Hotrod client</a> using <code>hono.deviceConnection.remote</code> instead of the <code>infinispan.client.hotrod</code> prefix.</p>
 
+<h3 id="embedded-cache">Embedded cache</h3>
+
+<p>The following table provides an overview of the configuration variables and corresponding command line options for configuring the embedded cache:</p>
+
+<p>hono.device-connection.embedded.configuration-file</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="center">Mandatory</th>
+<th align="left">Default</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>HONO_DEVICECONNECTION_EMBEDDED_CONFIGURATIONFILE</code><br><code>--hono.deviceConnection.embedded.configurationFile</code></td>
+<td align="center">yes</td>
+<td align="left">-</td>
+<td align="left">The absolute path to an Infinispan configuration file. Also see the <a href="https://docs.jboss.org/infinispan/9.4/configdocs/">Infinispan Configuration Schema</a>.</td>
+</tr>
+</tbody>
+</table>
+
 <h2 id="authentication-service-connection-configuration">Authentication Service Connection Configuration</h2>
 
 <p>The Device Connection component requires a connection to an implementation of Hono&rsquo;s Authentication API in order to authenticate and authorize client requests.</p>
@@ -2060,6 +2223,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2133,6 +2312,22 @@
             
                 
                     
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
                     
                 
                 
@@ -2276,6 +2471,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2678,20 +2889,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/admin-guide/device-registry-config/index.html b/docs/admin-guide/file-based-device-registry-config/index.html
similarity index 92%
rename from docs/admin-guide/device-registry-config/index.html
rename to docs/admin-guide/file-based-device-registry-config/index.html
index bde4a3d..d80fcc2 100644
--- a/docs/admin-guide/device-registry-config/index.html
+++ b/docs/admin-guide/file-based-device-registry-config/index.html
@@ -18,22 +18,22 @@
 <meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
 <meta name="theme-color" content="#ffffff">
 
-    <title>Device Registry Configuration :: Eclipse Hono&trade;</title>
+    <title>File Based Device Registry Configuration :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -53,18 +53,18 @@
 
 <meta name="twitter:card" content="summary_large_image">
 <meta name="twitter:site" content="@EclipseHono">
-<meta name="twitter:title" content="Device Registry Configuration :: Eclipse Hono&amp;trade;">
+<meta name="twitter:title" content="File Based Device Registry Configuration :: Eclipse Hono&amp;trade;">
 <meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
 <meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
 
 
-<meta property="og:title" content="Device Registry Configuration :: Eclipse Hono&amp;trade;" />
+<meta property="og:title" content="File Based Device Registry Configuration :: Eclipse Hono&amp;trade;" />
 <meta property="og:type" content="website" />
-<meta property="og:url" content="https://www.eclipse.org/hono/docs/admin-guide/device-registry-config//" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/admin-guide/file-based-device-registry-config//" />
 <meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
 
   </head>
-  <body class="" data-url="/hono/docs/admin-guide/device-registry-config/">
+  <body class="" data-url="/hono/docs/admin-guide/file-based-device-registry-config/">
     <nav id="sidebar" class="">
 
 
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item active">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item active">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,7 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/device-registry-config/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/file-based-device-registry-config/" selected>stable (1.3)</option>
                     
                   
               
@@ -1287,24 +1344,14 @@
               
                   
               
+                  
+              
           
               
               
                   
               
                   
-                    
-                    
-                      <option id="1.1" value="/hono/docs/1.1/admin-guide/device-registry-config/">1.1</option>
-                    
-                  
-              
-                  
-              
-                  
-              
-          
-              
               
                   
               
@@ -1313,12 +1360,10 @@
                   
                     
                     
-                      <option id="1.0" value="/hono/docs/1.0/admin-guide/device-registry-config/">1.0</option>
+                      <option id="dev" value="/hono/docs/dev/admin-guide/file-based-device-registry-config/">dev</option>
                     
                   
               
-                  
-              
           
         </select>
         <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
@@ -1381,7 +1426,7 @@
                   
                   
                   <div id="top-github-link">
-                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/admin-guide/device-registry-config.md" target="blank">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/admin-guide/file-based-device-registry-config.md" target="blank">
                       <i class="fas fa-code-branch"></i>
                       <span id="top-github-link-text">Edit this page</span>
                     </a>
@@ -1412,7 +1457,7 @@
             
           
           
-            <a href='/hono/docs/'>Documentation</a> > <a href='/hono/docs/admin-guide/'>Admin Guide</a> > Device Registry Configuration
+            <a href='/hono/docs/'>Documentation</a> > <a href='/hono/docs/admin-guide/'>Admin Guide</a> > File Based Device Registry Configuration
           
          
           
@@ -1457,20 +1502,19 @@
         
         <div id="body-inner">
           
-            <h1>Device Registry Configuration</h1>
+            <h1>File Based Device Registry Configuration</h1>
           
 
         
 
 
-<p>The Device Registry component provides an exemplary implementation of Eclipse Hono&trade;&rsquo;s <a href="/hono/docs/api/device-registration/">Device Registration</a>,
-<a href="/hono/docs/api/credentials/">Credentials</a>, <a href="/hono/docs/api/tenant/">Tenant</a> and <a href="/hono/docs/api/device-connection/">Device Connection</a> APIs.</p>
+<p>The File based Device Registry component provides an exemplary implementation of Eclipse Hono&trade;&rsquo;s <a href="/hono/docs/api/device-registration/">Device Registration</a>, <a href="/hono/docs/api/credentials/">Credentials</a>, <a href="/hono/docs/api/tenant/">Tenant</a> and <a href="/hono/docs/api/device-connection/">Device Connection</a> APIs.</p>
 
 <p>Protocol adapters use these APIs to determine a device&rsquo;s registration status, e.g. if it is enabled and if it is registered with a particular tenant, and to authenticate a device before accepting any data for processing from it.</p>
 
 <p>There is no particular technical reason to implement these three APIs in one component, so for production scenarios there might be up to three different components each implementing one of the API&rsquo;s.</p>
 
-<p>The Device Registry component also exposes <a href="/hono/docs/user-guide/device-registry/">HTTP based resources</a> for managing tenants and the registration information and credentials of devices.</p>
+<p>The Device Registry component also exposes <a href="/hono/docs/api/management/">HTTP based resources</a> for managing tenants and the registration information and credentials of devices.</p>
 
 <p>The Device Registry is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding <a href="https://hub.docker.com/r/eclipse/hono-service-device-registry-file/">Docker image</a> created from it.</p>
 
@@ -1639,6 +1683,20 @@
 </tr>
 
 <tr>
+<td align="left"><code>HONO_REGISTRY_REST_TENANT_ID_REGEX</code><br><code>--hono.registry.rest.tenantIdRegex</code></td>
+<td align="center">no</td>
+<td align="left"><code>^[a-zA-Z0-9-_.]+$</code></td>
+<td align="left">The regular expression to use to validate tenant ID. Please refer to the <a href="https://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html">java pattern documentation</a>.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_REGISTRY_REST_DEVICE_ID_REGEX</code><br><code>--hono.registry.rest.deviceIdRegex</code></td>
+<td align="center">no</td>
+<td align="left"><code>^[a-zA-Z0-9-_]+$</code></td>
+<td align="left">The regular expression to use to validate device ID. Please refer to the <a href="https://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html">java pattern documentation</a>.</td>
+</tr>
+
+<tr>
 <td align="left"><code>HONO_REGISTRY_REST_BIND_ADDRESS</code><br><code>--hono.registry.rest.bindAddress</code></td>
 <td align="center">no</td>
 <td align="left"><code>127.0.0.1</code></td>
@@ -2271,6 +2329,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2328,6 +2402,22 @@
             
                 
                     
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
                     
                 
                 
@@ -2487,6 +2577,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2889,20 +2995,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/admin-guide/hono-client-configuration/index.html b/docs/admin-guide/hono-client-configuration/index.html
index 3ccacee..7c845f5 100644
--- a/docs/admin-guide/hono-client-configuration/index.html
+++ b/docs/admin-guide/hono-client-configuration/index.html
@@ -21,19 +21,19 @@
     <title>Hono Client Configuration :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/hono-client-configuration/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/hono-client-configuration/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/hono-client-configuration/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/hono-client-configuration/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/hono-client-configuration/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/hono-client-configuration/">dev</option>
@@ -1448,6 +1531,7 @@
 <li><a href="#connection-properties">Connection Properties</a></li>
 <li><a href="#response-caching">Response Caching</a></li>
 <li><a href="#using-tls">Using TLS</a></li>
+<li><a href="#address-rewriting">Address rewriting</a></li>
 </ul></li>
 </ul>
 </nav>
@@ -1753,6 +1837,36 @@
 
 <p>The factory supports TLS 1.2 only by default for negotiating TLS sessions with servers. Additional protocols can be enabled by setting the <code>${PREFIX}_SECUREPROTOCOLS</code> variable to a comma separated list of protocol names as defined in the <a href="https://vertx.io/docs/vertx-core/java/#ssl">vert.x documentation</a>. However, great care should be taken when enabling older protocols because most of them are vulnerable to attacks.</p>
 
+<h2 id="address-rewriting">Address rewriting</h2>
+
+<p>In some multi-tenant messaging environments external can have their addresses internally mapped to enforce consistent namespaces. For example, the addresses can be prefixed by the virtual host the client uses to connect or some other internal identifier. So address like <code>telemetry/DEFAULT_TENANT</code> would be internally represented as <code>test-vhost/telemetry/DEFAULT_TENANT</code> for example.</p>
+
+<p>To successfully address those external clients, infrastructure Hono components need to apply the same mapping rules. The client factory can be configured to automatically rewrite addresses when opening links to the AMQP network. The <code>${PREFIX}_ADDRESSREWRITERULE</code> variable contains rewrite rule for addresses based on the regular expressions.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="center">Mandatory</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>${PREFIX}_ADDRESSREWRITERULE</code><br><code>--${prefix}.addressRewriteRule</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The address rewrite rule in the <code>&quot;$PATTERN $REPLACEMENT&quot;</code> format.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The rule is defined in the <code>&quot;$PATTERN $REPLACEMENT&quot;</code> format, where the pattern and replacement use the standard <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/regex/Pattern.html">Java regular expression</a> syntax. The pattern should match the address or otherwise the original address will be used.</p>
+
+<p>For example, setting <code>HONO_ADDRESSREWRITERULE</code> to <code>([a-z_]+)/([\\w-]+) test-vhost/$1/$2</code> would result in adding the <code>test-vhost/</code> prefix to all addresses used by the client.</p>
+
 <footer class=" footline" >
 	
 </footer>
@@ -2072,6 +2186,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2225,6 +2355,38 @@
             
                 
                     
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
                     
                 
                 
@@ -2690,20 +2852,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/admin-guide/http-adapter-config/index.html b/docs/admin-guide/http-adapter-config/index.html
index 3401beb..ac8f30d 100644
--- a/docs/admin-guide/http-adapter-config/index.html
+++ b/docs/admin-guide/http-adapter-config/index.html
@@ -21,19 +21,19 @@
     <title>HTTP Adapter Configuration :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/http-adapter-config/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/http-adapter-config/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/http-adapter-config/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/http-adapter-config/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/http-adapter-config/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/http-adapter-config/">dev</option>
@@ -1473,9 +1556,10 @@
         
 
 
-<p>The HTTP protocol adapter exposes a HTTP based API for Eclipse Hono&trade;&rsquo;s Telemetry and Event endpoints.</p>
+<p>The HTTP protocol adapter exposes HTTP based endpoints for Eclipse Hono&trade;&rsquo;s south bound Telemetry, Event and Command &amp; Control APIs.</p>
 
-<p>The adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding <a href="https://hub.docker.com/r/eclipse/hono-adapter-http-vertx/">Docker image</a> created from it.</p>
+<p>The adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the
+corresponding <a href="https://hub.docker.com/r/eclipse/hono-adapter-http-vertx/">Docker image</a> created from it.</p>
 
 <p>The adapter supports the following standard configuration options:</p>
 
@@ -2000,6 +2084,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2089,6 +2189,22 @@
             
                 
                     
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
                     
                 
                 
@@ -2216,6 +2332,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2618,20 +2750,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/admin-guide/index.html b/docs/admin-guide/index.html
index c458a8c..69de185 100644
--- a/docs/admin-guide/index.html
+++ b/docs/admin-guide/index.html
@@ -21,19 +21,19 @@
     <title>Admin Guide :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/">dev</option>
@@ -1771,6 +1854,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -1983,6 +2082,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2385,20 +2516,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/admin-guide/index.xml b/docs/admin-guide/index.xml
index 9edc6b9..d67104a 100644
--- a/docs/admin-guide/index.xml
+++ b/docs/admin-guide/index.xml
@@ -30,13 +30,21 @@
     </item>
     
     <item>
-      <title>Device Registry Configuration</title>
-      <link>https://www.eclipse.org/hono/docs/admin-guide/device-registry-config/</link>
+      <title>MongoDB Based Device Registry Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/admin-guide/mongodb-device-registry-config/</link>
       <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
       
-      <guid>https://www.eclipse.org/hono/docs/admin-guide/device-registry-config/</guid>
-      <description>&lt;p&gt;The Device Registry component provides an exemplary implementation of Eclipse Hono&amp;trade;&amp;rsquo;s &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/device-registration/&#34;&gt;Device Registration&lt;/a&gt;,
-&lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/credentials/&#34;&gt;Credentials&lt;/a&gt;, &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/tenant/&#34;&gt;Tenant&lt;/a&gt; and &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/device-connection/&#34;&gt;Device Connection&lt;/a&gt; APIs.&lt;/p&gt;
+      <guid>https://www.eclipse.org/hono/docs/admin-guide/mongodb-device-registry-config/</guid>
+      <description>The MongoDB based Device Registry component provides an implementation of Eclipse Hono&amp;trade;&amp;rsquo;s Device Registration, Credentials and Tenant APIs. Protocol adapters use these APIs to determine a device&amp;rsquo;s registration status, e.g. if it is enabled and if it is registered with a particular tenant, and to authenticate a device before accepting any data for processing from it. In addition to the above, this Device Registry also provides an implementation of Device Registry Management APIs for managing tenants, registration information and credentials of devices.</description>
+    </item>
+    
+    <item>
+      <title>File Based Device Registry Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/admin-guide/file-based-device-registry-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/admin-guide/file-based-device-registry-config/</guid>
+      <description>&lt;p&gt;The File based Device Registry component provides an exemplary implementation of Eclipse Hono&amp;trade;&amp;rsquo;s &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/device-registration/&#34;&gt;Device Registration&lt;/a&gt;, &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/credentials/&#34;&gt;Credentials&lt;/a&gt;, &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/tenant/&#34;&gt;Tenant&lt;/a&gt; and &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/device-connection/&#34;&gt;Device Connection&lt;/a&gt; APIs.&lt;/p&gt;
 
 &lt;p&gt;Protocol adapters use these APIs to determine a device&amp;rsquo;s registration status, e.g. if it is enabled and if it is registered with a particular tenant, and to authenticate a device before accepting any data for processing from it.&lt;/p&gt;</description>
     </item>
@@ -58,16 +66,7 @@
       <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
       
       <guid>https://www.eclipse.org/hono/docs/admin-guide/http-adapter-config/</guid>
-      <description>&lt;p&gt;The HTTP protocol adapter exposes a HTTP based API for Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry and Event endpoints.&lt;/p&gt;</description>
-    </item>
-    
-    <item>
-      <title>AMQP Adapter Configuration</title>
-      <link>https://www.eclipse.org/hono/docs/admin-guide/amqp-adapter-config/</link>
-      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-      
-      <guid>https://www.eclipse.org/hono/docs/admin-guide/amqp-adapter-config/</guid>
-      <description>&lt;p&gt;The AMQP protocol adapter allows clients (devices and gateway components) that speaks AMQP 1.0 to publish telemetry messages and events to Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry and Event endpoints.&lt;/p&gt;</description>
+      <description>&lt;p&gt;The HTTP protocol adapter exposes HTTP based endpoints for Eclipse Hono&amp;trade;&amp;rsquo;s south bound Telemetry, Event and Command &amp;amp; Control APIs.&lt;/p&gt;</description>
     </item>
     
     <item>
@@ -76,7 +75,25 @@
       <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
       
       <guid>https://www.eclipse.org/hono/docs/admin-guide/mqtt-adapter-config/</guid>
-      <description>&lt;p&gt;The MQTT protocol adapter exposes an MQTT topic hierarchy for publishing messages and events to Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry and Event endpoints.&lt;/p&gt;</description>
+      <description>&lt;p&gt;The MQTT protocol adapter exposes an MQTT topic hierarchy for Eclipse Hono&amp;trade;&amp;rsquo;s south bound Telemetry, Event and Command &amp;amp; Control APIs.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>AMQP Adapter Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/admin-guide/amqp-adapter-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/admin-guide/amqp-adapter-config/</guid>
+      <description>&lt;p&gt;The AMQP protocol adapter exposes AMQP based endpoints for Eclipse Hono&amp;trade;&amp;rsquo;s south bound Telemetry, Event and Command &amp;amp; Control APIs.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>CoAP Adapter Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/admin-guide/coap-adapter-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/admin-guide/coap-adapter-config/</guid>
+      <description>&lt;p&gt;The CoAP protocol adapter exposes CoAP based endpoints for Eclipse Hono&amp;trade;&amp;rsquo;s south bound Telemetry, Event and Command &amp;amp; Control APIs.&lt;/p&gt;</description>
     </item>
     
     <item>
@@ -85,7 +102,8 @@
       <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
       
       <guid>https://www.eclipse.org/hono/docs/admin-guide/kura-adapter-config/</guid>
-      <description>&lt;p&gt;The Kura protocol adapter exposes an MQTT topic hierarchy allowing Eclipse Kura&amp;trade; based gateways to publish &lt;em&gt;control&lt;/em&gt; and &lt;em&gt;data&lt;/em&gt; messages to Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry and Event endpoints.&lt;/p&gt;</description>
+      <description>&lt;p&gt;The Kura protocol adapter exposes an MQTT topic hierarchy allowing Eclipse Kura&amp;trade; based gateways to access Eclipse Hono&amp;trade;&amp;rsquo;s
+south bound Telemetry, Event and Command &amp;amp; Control APIs.&lt;/p&gt;</description>
     </item>
     
     <item>
diff --git a/docs/admin-guide/kura-adapter-config/index.html b/docs/admin-guide/kura-adapter-config/index.html
index c65e240..fd19a02 100644
--- a/docs/admin-guide/kura-adapter-config/index.html
+++ b/docs/admin-guide/kura-adapter-config/index.html
@@ -21,19 +21,19 @@
     <title>Kura Adapter Configuration :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/kura-adapter-config/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/kura-adapter-config/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/kura-adapter-config/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/kura-adapter-config/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/kura-adapter-config/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/kura-adapter-config/">dev</option>
@@ -1473,9 +1556,11 @@
         
 
 
-<p>The Kura protocol adapter exposes an MQTT topic hierarchy allowing Eclipse Kura&trade; based gateways to publish <em>control</em> and <em>data</em> messages to Eclipse Hono&trade;&rsquo;s Telemetry and Event endpoints.</p>
+<p>The Kura protocol adapter exposes an MQTT topic hierarchy allowing Eclipse Kura&trade; based gateways to access Eclipse Hono&trade;&rsquo;s
+south bound Telemetry, Event and Command &amp; Control APIs.</p>
 
-<p>The adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding <a href="https://hub.docker.com/r/eclipse/hono-adapter-kura/">Docker image</a> created from it.</p>
+<p>The adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the
+corresponding <a href="https://hub.docker.com/r/eclipse/hono-adapter-kura/">Docker image</a> created from it.</p>
 
 <p>The adapter supports the following standard configuration options:</p>
 
@@ -1607,6 +1692,13 @@
 </tr>
 
 <tr>
+<td align="left"><code>HONO_MQTT_MAX_CONNECTIONS</code><br><code>--hono.mqtt.maxConnections</code></td>
+<td align="center">no</td>
+<td align="left"><code>0</code></td>
+<td align="left">The maximum number of concurrent connections that the protocol adapter should accept. If not set (or set to <code>0</code>), the protocol adapter determines a reasonable value based on the available resources like memory and CPU.</td>
+</tr>
+
+<tr>
 <td align="left"><code>HONO_KURA_MAX_PAYLOAD_SIZE</code><br><code>--hono.kura.maxPayloadSize</code></td>
 <td align="center">no</td>
 <td align="left"><code>2048</code></td>
@@ -1640,6 +1732,13 @@
 <td align="left"><code>0ms</code></td>
 <td align="left">The duration after which the protocol adapter removes local state of the tenant (e.g. open AMQP links) with an amount and a unit, e.g. <code>2h</code> for 2 hours. See the <a href="https://docs.spring.io/spring-boot/docs/current/reference/html/spring-boot-features.html#boot-features-external-config-conversion-duration">Spring Boot documentation</a> for an explanation of the format. The value <code>0ms</code> disables the timeout.</td>
 </tr>
+
+<tr>
+<td align="left"><code>HONO_KURA_SEND_MESSAGE_TO_DEVICE_TIMEOUT</code><br><code>--hono.kura.sendMessageToDeviceTimeout</code></td>
+<td align="center">no</td>
+<td align="left"><code>1000</code></td>
+<td align="left">The amount of time (milliseconds) after which the sending of a command to a device using QoS 1 is considered to be failed. The value of this variable should be increased in cases where devices are connected over a network with high latency.</td>
+</tr>
 </tbody>
 </table>
 
@@ -2014,6 +2113,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2151,6 +2266,38 @@
             
                 
                     
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
                     
                 
                 
@@ -2632,20 +2779,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/admin-guide/device-registry-config/index.html b/docs/admin-guide/mongodb-device-registry-config/index.html
similarity index 70%
copy from docs/admin-guide/device-registry-config/index.html
copy to docs/admin-guide/mongodb-device-registry-config/index.html
index bde4a3d..d8065de 100644
--- a/docs/admin-guide/device-registry-config/index.html
+++ b/docs/admin-guide/mongodb-device-registry-config/index.html
@@ -18,22 +18,22 @@
 <meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
 <meta name="theme-color" content="#ffffff">
 
-    <title>Device Registry Configuration :: Eclipse Hono&trade;</title>
+    <title>MongoDB Based Device Registry Configuration :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -53,18 +53,18 @@
 
 <meta name="twitter:card" content="summary_large_image">
 <meta name="twitter:site" content="@EclipseHono">
-<meta name="twitter:title" content="Device Registry Configuration :: Eclipse Hono&amp;trade;">
+<meta name="twitter:title" content="MongoDB Based Device Registry Configuration :: Eclipse Hono&amp;trade;">
 <meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
 <meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
 
 
-<meta property="og:title" content="Device Registry Configuration :: Eclipse Hono&amp;trade;" />
+<meta property="og:title" content="MongoDB Based Device Registry Configuration :: Eclipse Hono&amp;trade;" />
 <meta property="og:type" content="website" />
-<meta property="og:url" content="https://www.eclipse.org/hono/docs/admin-guide/device-registry-config//" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/admin-guide/mongodb-device-registry-config//" />
 <meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
 
   </head>
-  <body class="" data-url="/hono/docs/admin-guide/device-registry-config/">
+  <body class="" data-url="/hono/docs/admin-guide/mongodb-device-registry-config/">
     <nav id="sidebar" class="">
 
 
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item active">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item active">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,7 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/device-registry-config/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/mongodb-device-registry-config/" selected>stable (1.3)</option>
                     
                   
               
@@ -1287,24 +1344,14 @@
               
                   
               
+                  
+              
           
               
               
                   
               
                   
-                    
-                    
-                      <option id="1.1" value="/hono/docs/1.1/admin-guide/device-registry-config/">1.1</option>
-                    
-                  
-              
-                  
-              
-                  
-              
-          
-              
               
                   
               
@@ -1313,12 +1360,10 @@
                   
                     
                     
-                      <option id="1.0" value="/hono/docs/1.0/admin-guide/device-registry-config/">1.0</option>
+                      <option id="dev" value="/hono/docs/dev/admin-guide/mongodb-device-registry-config/">dev</option>
                     
                   
               
-                  
-              
           
         </select>
         <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
@@ -1381,7 +1426,7 @@
                   
                   
                   <div id="top-github-link">
-                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/admin-guide/device-registry-config.md" target="blank">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/admin-guide/mongodb-device-registry-config.md" target="blank">
                       <i class="fas fa-code-branch"></i>
                       <span id="top-github-link-text">Edit this page</span>
                     </a>
@@ -1412,7 +1457,7 @@
             
           
           
-            <a href='/hono/docs/'>Documentation</a> > <a href='/hono/docs/admin-guide/'>Admin Guide</a> > Device Registry Configuration
+            <a href='/hono/docs/'>Documentation</a> > <a href='/hono/docs/admin-guide/'>Admin Guide</a> > MongoDB Based Device Registry Configuration
           
          
           
@@ -1430,19 +1475,9 @@
 <li>
 <ul>
 <li><a href="#service-configuration">Service Configuration</a></li>
-<li><a href="#port-configuration">Port Configuration</a>
-<ul>
-<li><a href="#secure-port-only">Secure Port Only</a></li>
-<li><a href="#insecure-port-only">Insecure Port Only</a></li>
-<li><a href="#dual-port">Dual Port</a></li>
-<li><a href="#ephemeral-ports">Ephemeral Ports</a></li>
-</ul></li>
+<li><a href="#port-configuration">Port Configuration</a></li>
 <li><a href="#authentication-service-connection-configuration">Authentication Service Connection Configuration</a></li>
 <li><a href="#metrics-configuration">Metrics Configuration</a></li>
-<li><a href="#device-identities-file-format">Device Identities File Format</a></li>
-<li><a href="#credentials-file-format">Credentials File Format</a></li>
-<li><a href="#tenants-file-format">Tenants File Format</a></li>
-<li><a href="#configuring-gateway-devices">Configuring Gateway Devices</a></li>
 </ul></li>
 </ul>
 </nav>
@@ -1457,28 +1492,22 @@
         
         <div id="body-inner">
           
-            <h1>Device Registry Configuration</h1>
+            <h1>MongoDB Based Device Registry Configuration</h1>
           
 
         
 
 
-<p>The Device Registry component provides an exemplary implementation of Eclipse Hono&trade;&rsquo;s <a href="/hono/docs/api/device-registration/">Device Registration</a>,
-<a href="/hono/docs/api/credentials/">Credentials</a>, <a href="/hono/docs/api/tenant/">Tenant</a> and <a href="/hono/docs/api/device-connection/">Device Connection</a> APIs.</p>
 
-<p>Protocol adapters use these APIs to determine a device&rsquo;s registration status, e.g. if it is enabled and if it is registered with a particular tenant, and to authenticate a device before accepting any data for processing from it.</p>
 
-<p>There is no particular technical reason to implement these three APIs in one component, so for production scenarios there might be up to three different components each implementing one of the API&rsquo;s.</p>
+<p>The MongoDB based Device Registry component provides an implementation of Eclipse Hono&trade;&rsquo;s <a href="/hono/docs/api/device-registration/">Device Registration</a>,
+<a href="/hono/docs/api/credentials/">Credentials</a> and <a href="/hono/docs/api/tenant/">Tenant</a> APIs. Protocol adapters use these APIs to determine a device&rsquo;s registration status, e.g. if it is enabled and if it is registered with a particular tenant, and to authenticate a device before accepting any data for processing from it. In addition to the above, this Device Registry also provides an implementation of <a href="/hono/docs/api/management/">Device Registry Management APIs</a> for managing tenants, registration information and credentials of devices.</p>
 
-<p>The Device Registry component also exposes <a href="/hono/docs/user-guide/device-registry/">HTTP based resources</a> for managing tenants and the registration information and credentials of devices.</p>
-
-<p>The Device Registry is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding <a href="https://hub.docker.com/r/eclipse/hono-service-device-registry-file/">Docker image</a> created from it.</p>
+<p>The Device Registry is implemented as a Spring Boot application, and the data is persisted in a MongoDB database. It can be run either directly from the command line or by means of starting the corresponding <a href="https://hub.docker.com/r/eclipse/hono-service-device-registry-mongodb/">Docker image</a> created from it.</p>
 
 <h2 id="service-configuration">Service Configuration</h2>
 
-<p>In addition to the following options, this component supports the options described in <a href="/hono/docs/admin-guide/common-config/">Common Configuration</a>.</p>
-
-<p>The following table provides an overview of the configuration variables and corresponding command line options for configuring the Device Registry.</p>
+<p>The following table provides an overview of the configuration variables and corresponding command line options for configuring the MongoDB based Device Registry. In addition to the following options, this component also supports the options described in <a href="/hono/docs/admin-guide/common-config/">Common Configuration</a>.</p>
 
 <table>
 <thead>
@@ -1492,13 +1521,6 @@
 
 <tbody>
 <tr>
-<td align="left"><code>HONO_APP_TYPE</code><br><code>--hono.app.type</code></td>
-<td align="center">no</td>
-<td align="left"><code>file</code></td>
-<td align="left">The device registry implementation to use. This may be either <code>file</code> or <code>dummy</code>. In the case of <code>dummy</code> a dummy implementation will be used which will consider all devices queried for as valid devices, having the access credentials <code>hono-secret</code>. Of course this shouldn&rsquo;t be used for productive use.</td>
-</tr>
-
-<tr>
 <td align="left"><code>HONO_CREDENTIALS_SVC_CACHE_MAX_AGE</code><br><code>--hono.credentials.svc.cacheMaxAge</code></td>
 <td align="center">no</td>
 <td align="left"><code>180</code></td>
@@ -1506,10 +1528,10 @@
 </tr>
 
 <tr>
-<td align="left"><code>HONO_CREDENTIALS_SVC_FILENAME</code><br><code>--hono.credentials.svc.filename</code></td>
+<td align="left"><code>HONO_CREDENTIALS_SVC_COLLECTION_NAME</code><br><code>--hono.credentials.svc.collectionName</code></td>
 <td align="center">no</td>
-<td align="left"><code>/var/lib/hono/device-registry/</code><br><code>credentials.json</code></td>
-<td align="left">The path to the file where the server stores credentials of devices. Hono tries to read credentials from this file during start-up and writes out all identities to this file periodically if property <code>HONO_CREDENTIALS_SVC_SAVE_TO_FILE</code> is set to <code>true</code>.<br>Please refer to <a href="#credentials-file-format">Credentials File Format</a> for details regarding the file&rsquo;s format.</td>
+<td align="left"><code>credentials</code></td>
+<td align="left">The name of the MongoDB collection where the server stores credentials of devices.</td>
 </tr>
 
 <tr>
@@ -1541,24 +1563,59 @@
 </tr>
 
 <tr>
-<td align="left"><code>HONO_CREDENTIALS_SVC_SAVE_TO_FILE</code><br><code>--hono.credentials.svc.saveToFile</code></td>
+<td align="left"><code>HONO_MONGODB_CONNECTION_STRING</code><br><code>--hono.mongodb.connectionString</code></td>
 <td align="center">no</td>
-<td align="left"><code>false</code></td>
-<td align="left">When set to <code>true</code> the server will periodically write out the registered credentials to the file specified by the <code>HONO_CREDENTIALS_SVC_FILENAME</code> property.</td>
+<td align="left">-</td>
+<td align="left">The connection string used by the Device Registry application to connect to the MongoDB database. If <code>HONO_MONGODB_CONNECTION_STRING</code> is set, it overrides the other MongoDB connection settings.<br> See <a href="https://docs.mongodb.com/manual/reference/connection-string/">Connection String URI Format</a> for more information.</td>
 </tr>
 
 <tr>
-<td align="left"><code>HONO_CREDENTIALS_SVC_STARTEMPTY</code><br><code>--hono.credentials.svc.startEmpty</code></td>
+<td align="left"><code>HONO_MONGODB_CONNECTION_TIMEOUT_IN_MS</code><br><code>--hono.mongodb.connectionTimeoutInMs</code></td>
 <td align="center">no</td>
-<td align="left"><code>false</code></td>
-<td align="left">When set to <code>true</code> the server will not try to load credentials from the file specified by the <code>HONO_CREDENTIALS_SVC_FILENAME</code> property during startup.</td>
+<td align="left"><code>10000</code></td>
+<td align="left">The time in milliseconds to attempt a connection before timing out.</td>
 </tr>
 
 <tr>
-<td align="left"><code>HONO_DEVICE_CONNECTION_SVC_MAX_DEVICES_PER_TENANT</code><br><code>--hono.deviceConnection.svc.maxDevicesPerTenant</code></td>
+<td align="left"><code>HONO_MONGODB_DB_NAME</code><br><code>--hono.mongodb.dbName</code></td>
 <td align="center">no</td>
-<td align="left"><code>100</code></td>
-<td align="left">The number of devices per tenant for which connection related data is stored. It is an error to set this property to a value &lt;= 0.</td>
+<td align="left">-</td>
+<td align="left">The name of the MongoDB database that should be used by the Device Registry application.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MONGODB_HOST</code><br><code>--hono.mongodb.host</code></td>
+<td align="center">no</td>
+<td align="left"><code>localhost</code></td>
+<td align="left">The host name or IP address of the MongoDB instance.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MONGODB_PORT</code><br><code>--hono.mongodb.port</code></td>
+<td align="center">no</td>
+<td align="left"><code>27017</code></td>
+<td align="left">The port that the MongoDB instance is listening on.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MONGODB_PASSWORD</code><br><code>--hono.mongodb.password</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The password to use for authenticating to the MongoDB instance.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MONGODB_SERVER_SELECTION_TIMEOUT_IN_MS</code><br><code>--hono.mongodb.serverSelectionTimeoutInMs</code></td>
+<td align="center">no</td>
+<td align="left"><code>1000</code></td>
+<td align="left">The time in milliseconds that the mongo driver will wait to select a server for an operation before raising an error.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MONGODB_USERNAME</code><br><code>--hono.mongodb.username</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The user name to use for authenticating to the MongoDB instance.</td>
 </tr>
 
 <tr>
@@ -1639,69 +1696,90 @@
 </tr>
 
 <tr>
-<td align="left"><code>HONO_REGISTRY_REST_BIND_ADDRESS</code><br><code>--hono.registry.rest.bindAddress</code></td>
+<td align="left"><code>HONO_REGISTRY_HTTP_AUTHENTICATION_REQUIRED</code><br><code>--hono.registry.http.authenticationRequired</code></td>
+<td align="center">no</td>
+<td align="left"><code>true</code></td>
+<td align="left">If set to <code>true</code> the HTTP endpoint of the Device Registry requires clients to authenticate when connecting to the Device Registry. The MongoDB based Device Registry currently supports basic authentication and the user credentials are to be stored in a MongoDB collection with name <code>user</code>. <br>For more information on how to manage users please refer to <a href="https://vertx.io/docs/vertx-auth-mongo/java/">Mongo Auth Provider</a>.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_REGISTRY_HTTP_BIND_ADDRESS</code><br><code>--hono.registry.http.bindAddress</code></td>
 <td align="center">no</td>
 <td align="left"><code>127.0.0.1</code></td>
 <td align="left">The IP address of the network interface that the secure HTTP port should be bound to.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
 </tr>
 
 <tr>
-<td align="left"><code>HONO_REGISTRY_REST_CERT_PATH</code><br><code>--hono.registry.rest.certPath</code></td>
+<td align="left"><code>HONO_REGISTRY_HTTP_CERT_PATH</code><br><code>--hono.registry.http.certPath</code></td>
 <td align="center">no</td>
 <td align="left">-</td>
-<td align="left">The absolute path to the PEM file containing the certificate that the server should use for authenticating to clients. This option must be used in conjunction with <code>HONO_REGISTRY_REST_KEY_PATH</code>.<br>Alternatively, the <code>HONO_REGISTRY_REST_KEY_STORE_PATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
+<td align="left">The absolute path to the PEM file containing the certificate that the server should use for authenticating to clients. This option must be used in conjunction with <code>HONO_REGISTRY_HTTP_KEY_PATH</code>.<br>Alternatively, the <code>HONO_REGISTRY_HTTP_KEY_STORE_PATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
 </tr>
 
 <tr>
-<td align="left"><code>HONO_REGISTRY_REST_INSECURE_PORT</code><br><code>--hono.registry.rest.insecurePort</code></td>
+<td align="left"><code>HONO_REGISTRY_HTTP_DEVICE_ID_REGEX</code><br><code>--hono.registry.http.deviceIdRegex</code></td>
+<td align="center">no</td>
+<td align="left"><code>^[a-zA-Z0-9-_]+$</code></td>
+<td align="left">The regular expression to use to validate device ID. Please refer to the <a href="https://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html">java pattern documentation</a>.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_REGISTRY_HTTP_INSECURE_PORT</code><br><code>--hono.registry.http.insecurePort</code></td>
 <td align="center">no</td>
 <td align="left">-</td>
 <td align="left">The insecure port the server should listen on for HTTP requests.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
 </tr>
 
 <tr>
-<td align="left"><code>HONO_REGISTRY_REST_INSECURE_PORT_BIND_ADDRESS</code><br><code>--hono.registry.rest.insecurePortBindAddress</code></td>
+<td align="left"><code>HONO_REGISTRY_HTTP_INSECURE_PORT_BIND_ADDRESS</code><br><code>--hono.registry.http.insecurePortBindAddress</code></td>
 <td align="center">no</td>
 <td align="left"><code>127.0.0.1</code></td>
 <td align="left">The IP address of the network interface that the insecure HTTP port should be bound to.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
 </tr>
 
 <tr>
-<td align="left"><code>HONO_REGISTRY_REST_INSECURE_PORT_ENABLED</code><br><code>--hono.registry.rest.insecurePortEnabled</code></td>
+<td align="left"><code>HONO_REGISTRY_HTTP_INSECURE_PORT_ENABLED</code><br><code>--hono.registry.http.insecurePortEnabled</code></td>
 <td align="center">no</td>
 <td align="left"><code>false</code></td>
-<td align="left">If set to <code>true</code> the server will open an insecure port (not secured by TLS) using either the port number set via <code>HONO_REGISTRY_REST_INSECURE_PORT</code> or the default AMQP port number (<code>5672</code>) if not set explicitly.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
+<td align="left">If set to <code>true</code> the server will open an insecure port (not secured by TLS) using either the port number set via <code>HONO_REGISTRY_HTTP_INSECURE_PORT</code> or the default AMQP port number (<code>5672</code>) if not set explicitly.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
 </tr>
 
 <tr>
-<td align="left"><code>HONO_REGISTRY_REST_KEY_PATH</code><br><code>--hono.registry.rest.keyPath</code></td>
+<td align="left"><code>HONO_REGISTRY_HTTP_KEY_PATH</code><br><code>--hono.registry.http.keyPath</code></td>
 <td align="center">no</td>
 <td align="left">-</td>
-<td align="left">The absolute path to the (PKCS8) PEM file containing the private key that the server should use for authenticating to clients. This option must be used in conjunction with <code>HONO_REGISTRY_REST_CERT_PATH</code>. Alternatively, the <code>HONO_REGISTRY_REST_KEY_STORE_PATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
+<td align="left">The absolute path to the (PKCS8) PEM file containing the private key that the server should use for authenticating to clients. This option must be used in conjunction with <code>HONO_REGISTRY_HTTP_CERT_PATH</code>. Alternatively, the <code>HONO_REGISTRY_HTTP_KEY_STORE_PATH</code> option can be used to configure a key store containing both the key as well as the certificate.</td>
 </tr>
 
 <tr>
-<td align="left"><code>HONO_REGISTRY_REST_KEY_STORE_PASSWORD</code><br><code>--hono.registry.rest.keyStorePassword</code></td>
+<td align="left"><code>HONO_REGISTRY_HTTP_KEY_STORE_PASSWORD</code><br><code>--hono.registry.http.keyStorePassword</code></td>
 <td align="center">no</td>
 <td align="left">-</td>
 <td align="left">The password required to read the contents of the key store.</td>
 </tr>
 
 <tr>
-<td align="left"><code>HONO_REGISTRY_REST_KEY_STORE_PATH</code><br><code>--hono.registry.rest.keyStorePath</code></td>
+<td align="left"><code>HONO_REGISTRY_HTTP_KEY_STORE_PATH</code><br><code>--hono.registry.http.keyStorePath</code></td>
 <td align="center">no</td>
 <td align="left">-</td>
-<td align="left">The absolute path to the Java key store containing the private key and certificate that the server should use for authenticating to clients. Either this option or the <code>HONO_REGISTRY_REST_KEY_PATH</code> and <code>HONO_REGISTRY_REST_CERT_PATH</code> options need to be set in order to enable TLS secured connections with clients. The key store format can be either <code>JKS</code> or <code>PKCS12</code> indicated by a <code>.jks</code> or <code>.p12</code> file suffix respectively.</td>
+<td align="left">The absolute path to the Java key store containing the private key and certificate that the server should use for authenticating to clients. Either this option or the <code>HONO_REGISTRY_HTTP_KEY_PATH</code> and <code>HONO_REGISTRY_HTTP_CERT_PATH</code> options need to be set in order to enable TLS secured connections with clients. The key store format can be either <code>JKS</code> or <code>PKCS12</code> indicated by a <code>.jks</code> or <code>.p12</code> file suffix respectively.</td>
 </tr>
 
 <tr>
-<td align="left"><code>HONO_REGISTRY_REST_PORT</code><br><code>--hono.registry.rest.port</code></td>
+<td align="left"><code>HONO_REGISTRY_HTTP_PORT</code><br><code>--hono.registry.http.port</code></td>
 <td align="center">no</td>
 <td align="left"><code>5671</code></td>
 <td align="left">The secure port that the server should listen on for HTTP requests.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
 </tr>
 
 <tr>
+<td align="left"><code>HONO_REGISTRY_HTTP_TENANT_ID_REGEX</code><br><code>--hono.registry.http.tenantIdRegex</code></td>
+<td align="center">no</td>
+<td align="left"><code>^[a-zA-Z0-9-_.]+$</code></td>
+<td align="left">The regular expression to use to validate tenant ID. Please refer to the <a href="https://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html">java pattern documentation</a>.</td>
+</tr>
+
+<tr>
 <td align="left"><code>HONO_REGISTRY_SVC_CACHE_MAX_AGE</code><br><code>--hono.registry.svc.cacheMaxAge</code></td>
 <td align="center">no</td>
 <td align="left"><code>180</code></td>
@@ -1709,17 +1787,17 @@
 </tr>
 
 <tr>
-<td align="left"><code>HONO_REGISTRY_SVC_FILENAME</code><br><code>--hono.registry.svc.filename</code></td>
+<td align="left"><code>HONO_REGISTRY_SVC_COLLECTION_NAME</code><br><code>--hono.registry.svc.collectionName</code></td>
 <td align="center">no</td>
-<td align="left"><code>/var/lib/hono/device-registry/</code><br><code>device-identities.json</code></td>
-<td align="left">The path to the file where the server stores identities of registered devices. Hono tries to read device identities from this file during start-up and writes out all identities to this file periodically if property <code>HONO_REGISTRY_SVC_SAVE_TO_FILE</code> is set to <code>true</code>.<br>Please refer to <a href="#device-identities-file-format">Device Identities File Format</a> for details regarding the file&rsquo;s format.</td>
+<td align="left"><code>devices</code></td>
+<td align="left">The name of the MongoDB collection where the server stores registered device information.</td>
 </tr>
 
 <tr>
 <td align="left"><code>HONO_REGISTRY_SVC_MAX_DEVICES_PER_TENANT</code><br><code>--hono.registry.svc.maxDevicesPerTenant</code></td>
 <td align="center">no</td>
-<td align="left"><code>100</code></td>
-<td align="left">The number of devices that can be registered for each tenant. It is an error to set this property to a value &lt;= 0.</td>
+<td align="left"><code>-1</code></td>
+<td align="left">The number of devices that can be registered for each tenant. It is an error to set this property to a value &lt; -1. The value <code>-1</code> indicates that no limit is set.</td>
 </tr>
 
 <tr>
@@ -1737,41 +1815,6 @@
 </tr>
 
 <tr>
-<td align="left"><code>HONO_REGISTRY_SVC_SAVE_TO_FILE</code><br><code>--hono.registry.svc.saveToFile</code></td>
-<td align="center">no</td>
-<td align="left"><code>false</code></td>
-<td align="left">When set to <code>true</code> the server will periodically write out the registered device information to the file specified by the <code>HONO_REGISTRY_SVC_FILENAME</code> property.</td>
-</tr>
-
-<tr>
-<td align="left"><code>HONO_REGISTRY_SVC_SIGNING_KEY_PATH</code><br><code>--hono.registry.svc.signing.keyPath</code></td>
-<td align="center">no</td>
-<td align="left">-</td>
-<td align="left">The absolute path to the (PKCS8) PEM file containing the private key that the server should use for signing tokens asserting a device&rsquo;s registration status. When using this variable, other services that need to validate the tokens issued by this service need to be configured with the corresponding certificate/public key. Alternatively, a symmetric key can be used for signing (and validating) by setting the <code>HONO_REGISTRY_SVC_SIGNING_SHARED_SECRET</code> variable. If none of these variables is set, the server falls back to the key indicated by the <code>HONO_REGISTRY_AMP_KEY_PATH</code> variable. If that variable is also not set, startup of the server fails.</td>
-</tr>
-
-<tr>
-<td align="left"><code>HONO_REGISTRY_SVC_SIGNING_SHARED_SECRET</code><br><code>--hono.registry.svc.signing.sharedSecret</code></td>
-<td align="center">no</td>
-<td align="left">-</td>
-<td align="left">A string to derive a symmetric key from that is used for signing tokens asserting a device&rsquo;s registration status. The key is derived from the string by using the bytes of the String&rsquo;s UTF8 encoding. When setting the signing key using this variable, other services that need to validate the tokens issued by this service need to be configured with the same key. Alternatively, an asymmetric key pair can be used for signing (and validating) by setting the <code>HONO_REGISTRY_SVC_SIGNING_KEY_PATH</code> variable. If none of these variables is set, startup of the server fails.</td>
-</tr>
-
-<tr>
-<td align="left"><code>HONO_REGISTRY_SVC_SIGNING_TOKEN_EXPIRATION</code><br><code>--hono.registry.svc.signing.tokenExpiration</code></td>
-<td align="center">no</td>
-<td align="left"><code>10</code></td>
-<td align="left">The expiration period to use for the tokens asserting the registration status of devices.</td>
-</tr>
-
-<tr>
-<td align="left"><code>HONO_REGISTRY_SVC_STARTEMPTY</code><br><code>--hono.registry.svc.startEmpty</code></td>
-<td align="center">no</td>
-<td align="left"><code>false</code></td>
-<td align="left">When set to <code>true</code> the server will not try to load device identities from the file specified by the <code>HONO_REGISTRY_SVC_FILENAME</code> property during startup.</td>
-</tr>
-
-<tr>
 <td align="left"><code>HONO_TENANT_SVC_CACHE_MAX_AGE</code><br><code>--hono.tenant.svc.cacheMaxAge</code></td>
 <td align="center">no</td>
 <td align="left"><code>180</code></td>
@@ -1779,10 +1822,10 @@
 </tr>
 
 <tr>
-<td align="left"><code>HONO_TENANT_SVC_FILENAME</code><br><code>--hono.tenant.svc.filename</code></td>
+<td align="left"><code>HONO_TENANT_SVC_COLLECTION_NAME</code><br><code>--hono.tenant.svc.collectionName</code></td>
 <td align="center">no</td>
-<td align="left"><code>/var/lib/hono/device-registry/</code><br><code>tenants.json</code></td>
-<td align="left">The path to the file where the server stores tenants. Hono tries to read tenants from this file during start-up and writes out all identities to this file periodically if property <code>HONO_TENANT_SVC_SAVE_TO_FILE</code> is set to <code>true</code>.<br>Please refer to <a href="#tenants-file-format">Tenants File Format</a> for details regarding the file&rsquo;s format.</td>
+<td align="left"><code>tenants</code></td>
+<td align="left">The name of the MongoDB collection where the server stores tenants information.</td>
 </tr>
 
 <tr>
@@ -1798,20 +1841,6 @@
 <td align="left"><code>100</code></td>
 <td align="left">The number of credits to flow to a client connecting to the Tenant endpoint.</td>
 </tr>
-
-<tr>
-<td align="left"><code>HONO_TENANT_SVC_SAVE_TO_FILE</code><br><code>--hono.tenant.svc.saveToFile</code></td>
-<td align="center">no</td>
-<td align="left"><code>false</code></td>
-<td align="left">When set to <code>true</code> the server will periodically write out the registered tenants to the file specified by the <code>HONO_TENANTS_SVC_TENANT_FILENAME</code> property.</td>
-</tr>
-
-<tr>
-<td align="left"><code>HONO_TENANT_SVC_STARTEMPTY</code><br><code>--hono.tenant.svc.startEmpty</code></td>
-<td align="center">no</td>
-<td align="left"><code>false</code></td>
-<td align="left">When set to <code>true</code> the server will not try to load tenants from the file specified by the <code>HONO_TENANT_SVC_FILENAME</code> property during startup.</td>
-</tr>
 </tbody>
 </table>
 
@@ -1827,130 +1856,22 @@
 <li>both a secure and an insecure port (dual port configuration)</li>
 </ul>
 
-<p>The server will fail to start if none of the ports is configured properly.</p>
+<p>See <a href="/hono/docs/admin-guide/file-based-device-registry-config/#port-configuration">Port Configuration</a> for more information.</p>
 
-<p>The following sections apply to configuring both, the AMQP endpoint as well as the REST endpoint. The environment variables to use for configuring the REST endpoint are the same as the ones for the AMQP endpoint, substituting <code>_AMQP_</code> with <code>_REST_</code>, e.g. <code>HONO_REGISTRY_REST_KEY_PATH</code> instead of <code>HONO_REGISTRY_AMQP_KEY_PATH</code>.</p>
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Note</h4>
+    <div>The environment variables to use for configuring the REST endpoint are the same as the ones for the AMQP endpoint, substituting <code>_AMQP_</code> with <code>_HTTP_</code>.</div>
+</div>
 
-<h3 id="secure-port-only">Secure Port Only</h3>
-
-<p>The server needs to be configured with a private key and certificate in order to open a TLS secured port.</p>
-
-<p>There are two alternative ways for doing so:</p>
-
-<ol>
-<li>Setting the <code>HONO_REGISTRY_AMQP_KEY_STORE_PATH</code> and the <code>HONO_REGISTRY_AMQP_KEY_STORE_PASSWORD</code> variables in order to load the key &amp; certificate from a password protected key store, or</li>
-<li>setting the <code>HONO_REGISTRY_AMQP_KEY_PATH</code> and <code>HONO_REGISTRY_AMQP_CERT_PATH</code> variables in order to load the key and certificate from two separate PEM files in PKCS8 format.</li>
-</ol>
-
-<p>When starting up, the server will bind a TLS secured socket to the default secure AMQP port 5671. The port number can also be set explicitly using the <code>HONO_REGISTRY_AMQP_PORT</code> variable.</p>
-
-<p>The <code>HONO_REGISTRY_AMQP_BIND_ADDRESS</code> variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the <em>loopback device</em> only, i.e. the port will only be accessible from the local host. Setting this variable to <code>0.0.0.0</code> will let the port being bound to <strong>all</strong> network interfaces (be careful not to expose the port unintentionally to the outside world).</p>
-
-<h3 id="insecure-port-only">Insecure Port Only</h3>
-
-<p>The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by</p>
-
-<ul>
-<li>explicitly setting <code>HONO_REGISTRY_AMQP_INSECURE_PORT</code> to a valid port number, or by</li>
-<li>implicitly configuring the default AMQP port (5672) by simply setting <code>HONO_REGISTRY_AMQP_INSECURE_PORT_ENABLED</code> to <code>true</code>.</li>
-</ul>
-
-<p>The server issues a warning on the console if <code>HONO_REGISTRY_AMQP_INSECURE_PORT</code> is set to the default secure AMQP port (5671).</p>
-
-<p>The <code>HONO_REGISTRY_AMQP_INSECURE_PORT_BIND_ADDRESS</code> variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the <em>loopback device</em> only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.</p>
-
-<p>Setting this variable to <code>0.0.0.0</code> will let the port being bound to <strong>all</strong> network interfaces (be careful not to expose the port unintentionally to the outside world).</p>
-
-<h3 id="dual-port">Dual Port</h3>
-
-<p>In test setups and some production scenarios Hono server may be configured to open one secure <strong>and</strong> one insecure port at the same time.</p>
-
-<p>This is achieved by configuring both ports correctly (see above). The server will fail to start if both ports are configured to use the same port number.</p>
-
-<p>Since the secure port may need different visibility in the network setup compared to the secure port, it has it&rsquo;s own binding address <code>HONO_REGISTRY_AMQP_INSECURE_PORT_BIND_ADDRESS</code>.
-This can be used to narrow the visibility of the insecure port to a local network e.g., while the secure port may be visible worldwide.</p>
-
-<h3 id="ephemeral-ports">Ephemeral Ports</h3>
-
-<p>The server may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.</p>
 
 <h2 id="authentication-service-connection-configuration">Authentication Service Connection Configuration</h2>
 
-<p>The Device Registry requires a connection to an implementation of Hono&rsquo;s Authentication API in order to authenticate and authorize client requests.</p>
-
-<p>The connection is configured according to <a href="/hono/docs/admin-guide/hono-client-configuration/">Hono Client Configuration</a>
-where the <code>${PREFIX}</code> is set to <code>HONO_AUTH</code>. Since Hono&rsquo;s Authentication Service does not allow caching of the responses, the cache properties
-can be ignored.</p>
-
-<p>In addition to the standard client configuration properties, following properties may be set for the connection:</p>
-
-<table>
-<thead>
-<tr>
-<th align="left">Environment Variable<br>Command Line Option</th>
-<th align="center">Mandatory</th>
-<th align="left">Default</th>
-<th align="left">Description</th>
-</tr>
-</thead>
-
-<tbody>
-<tr>
-<td align="left"><code>HONO_AUTH_VALIDATION_CERT_PATH</code><br><code>--hono.auth.validation.certPath</code></td>
-<td align="center">no</td>
-<td align="left">-</td>
-<td align="left">The absolute path to the PEM file containing the an X.509 certificate that the service should use for validating tokens issued by the Authentication service. Alternatively, a symmetric key can be used for validating tokens by setting the <code>HONO_AUTH_VALIDATION_SHARED_SECRET</code> variable. If none of these variables is set, startup of the service fails.</td>
-</tr>
-
-<tr>
-<td align="left"><code>HONO_AUTH_VALIDATION_SHARED_SECRET</code><br><code>--hono.auth.validation.sharedSecret</code></td>
-<td align="center">no</td>
-<td align="left">-</td>
-<td align="left">A string to derive a symmetric key from which is used for validating tokens issued by the Authentication service. The key is derived from the string by using the bytes of the String&rsquo;s UTF8 encoding. When setting the validation key using this variable, the Authentication service <strong>must</strong> be configured with the same key. Alternatively, an X.509 certificate can be used for validating tokens by setting the <code>HONO_AUTH_VALIDATION_CERT_PATH</code> variable. If none of these variables is set, startup of the service fails.</td>
-</tr>
-
-<tr>
-<td align="left"><code>HONO_AUTH_SUPPORTED_SASL_MECHANISMS</code><br><code>--hono.auth.supportedSaslMechanisms</code></td>
-<td align="center">no</td>
-<td align="left"><code>EXTERNAL, PLAIN</code></td>
-<td align="left">A (comma separated) list of the SASL mechanisms that the device registry should offer to clients for authentication. This option may be set to specify only one of <code>EXTERNAL</code> or <code>PLAIN</code>, or to use a different order.</td>
-</tr>
-</tbody>
-</table>
+<p>See <a href="/hono/docs/admin-guide/file-based-device-registry-config/#authentication-service-connection-configuration">Authentication Service Connection Configuration</a> for more information.</p>
 
 <h2 id="metrics-configuration">Metrics Configuration</h2>
 
 <p>See <a href="/hono/docs/admin-guide/monitoring-tracing-config/">Monitoring &amp; Tracing Admin Guide</a> for details on how to configure the reporting of metrics.</p>
 
-<h2 id="device-identities-file-format">Device Identities File Format</h2>
-
-<p>The Device Registry supports persisting the device identities and their registration information to a JSON file in the local file system.
-The <em>Getting started Guide</em> includes an example configuration which illustrates the file format used. The configuration file&rsquo;s location is <code>/deploy/src/main/deploy/example-device-identities.json</code>.</p>
-
-<h2 id="credentials-file-format">Credentials File Format</h2>
-
-<p>The Device Registry supports persisting the devices&rsquo; credentials to a JSON file in the local file system.
-The <em>Getting started Guide</em> includes an example configuration which illustrates the file format used. The configuration file&rsquo;s location is <code>/deploy/src/main/deploy/example-credentials.json</code>.</p>
-
-<h2 id="tenants-file-format">Tenants File Format</h2>
-
-<p>The Device Registry supports persisting tenants to a JSON file in the local file system.
-The configuration file&rsquo;s location is <code>/deploy/src/main/deploy/example-tenants.json</code>.</p>
-
-<h2 id="configuring-gateway-devices">Configuring Gateway Devices</h2>
-
-<p>The Device Registry supports devices to <em>act on behalf of</em> other devices. This is particularly useful for cases where a device does not connect directly to a Hono protocol adapter but is connected to a <em>gateway</em> component that is usually specific to the device&rsquo;s communication protocol. It is the gateway component which then connects to a Hono protocol adapter and publishes data on behalf of the device(s). Examples of such a set up include devices using <a href="https://www.sigfox.com">SigFox</a> or <a href="https://lora-alliance.org/">LoRa</a> for communication.</p>
-
-<p>In these cases the protocol adapter will authenticate the gateway component instead of the device for which it wants to publish data. In order to verify that the gateway is <em>authorized</em> to publish data on behalf of the particular device, the protocol adapter should include the gateway&rsquo;s device identifier (as determined during the authentication process) in its invocation of the Device Registration API&rsquo;s <em>assert Device Registration</em> operation.</p>
-
-<p>The Device Registry will then do the following:
-1. Verify that the device exists and is enabled.
-2. Verify that the gateway exists and is enabled.
-3. Verify that the device&rsquo;s registration information contains a property called <code>via</code> and that its value is either the gateway&rsquo;s device identifier or a JSON array which contains the gateway&rsquo;s device identifier as one of its values.</p>
-
-<p>Only if all conditions are met, the Device Registry returns an assertion of the device&rsquo;s registration status. The protocol adapter can then forward the published data to the AMQP Messaging Network in the same way as for any device that connects directly to the adapter.</p>
-
-<p>The example configuration file (located at <code>/deploy/src/main/deploy/example-device-identities.json</code>) includes a device and a corresponding gateway configured in this way.</p>
 
 <footer class=" footline" >
 	
@@ -2271,6 +2192,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2487,6 +2424,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2889,20 +2858,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/admin-guide/monitoring-tracing-config/index.html b/docs/admin-guide/monitoring-tracing-config/index.html
index bf6d4a1..af4e9d1 100644
--- a/docs/admin-guide/monitoring-tracing-config/index.html
+++ b/docs/admin-guide/monitoring-tracing-config/index.html
@@ -21,19 +21,19 @@
     <title>Monitoring & Tracing :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/monitoring-tracing-config/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/monitoring-tracing-config/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/monitoring-tracing-config/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/monitoring-tracing-config/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/monitoring-tracing-config/">dev</option>
@@ -1996,6 +2079,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2197,6 +2296,38 @@
             
                 
                     
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
                     
                 
                 
@@ -2614,20 +2745,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/admin-guide/mqtt-adapter-config/index.html b/docs/admin-guide/mqtt-adapter-config/index.html
index e0005a2..b01a05c 100644
--- a/docs/admin-guide/mqtt-adapter-config/index.html
+++ b/docs/admin-guide/mqtt-adapter-config/index.html
@@ -21,19 +21,19 @@
     <title>MQTT Adapter Configuration :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item active">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item active">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/mqtt-adapter-config/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/mqtt-adapter-config/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/mqtt-adapter-config/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/mqtt-adapter-config/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/mqtt-adapter-config/">dev</option>
@@ -1453,6 +1536,7 @@
 <li><a href="#dual-port">Dual Port</a></li>
 <li><a href="#ephemeral-ports">Ephemeral Ports</a></li>
 </ul></li>
+<li><a href="#custom-message-mapping">Custom Message Mapping</a></li>
 </ul></li>
 </ul>
 </nav>
@@ -1473,9 +1557,10 @@
         
 
 
-<p>The MQTT protocol adapter exposes an MQTT topic hierarchy for publishing messages and events to Eclipse Hono&trade;&rsquo;s Telemetry and Event endpoints.</p>
+<p>The MQTT protocol adapter exposes an MQTT topic hierarchy for Eclipse Hono&trade;&rsquo;s south bound Telemetry, Event and Command &amp; Control APIs.</p>
 
-<p>The adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding <a href="https://hub.docker.com/r/eclipse/hono-adapter-mqtt-vertx/">Docker image</a> created from it.</p>
+<p>The adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the
+corresponding <a href="https://hub.docker.com/r/eclipse/hono-adapter-mqtt-vertx/">Docker image</a> created from it.</p>
 
 <p>The adapter supports the following standard configuration options:</p>
 
@@ -1540,6 +1625,13 @@
 <td align="left"><code>HONO_MQTT_COMMAND_ACK_TIMEOUT</code><br><code>--hono.mqtt.commandAckTimeout</code></td>
 <td align="center">no</td>
 <td align="left"><code>100</code></td>
+<td align="left">Deprecated. Use <code>HONO_MQTT_SEND_MESSAGE_TO_DEVICE_TIMEOUT</code> instead. The amount of time (milliseconds) after which the sending of a command to a device using QoS 1 is considered to be failed. The value of this variable should be increased in cases where devices are connected over a network with high latency.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_SEND_MESSAGE_TO_DEVICE_TIMEOUT</code><br><code>--hono.mqtt.sendMessageToDeviceTimeout</code></td>
+<td align="center">no</td>
+<td align="left"><code>1000</code></td>
 <td align="left">The amount of time (milliseconds) after which the sending of a command to a device using QoS 1 is considered to be failed. The value of this variable should be increased in cases where devices are connected over a network with high latency.</td>
 </tr>
 
@@ -1688,6 +1780,54 @@
 
 <p>Both the secure as well as the insecure port numbers may be explicitly set to <code>0</code>. The protocol adapter will then use arbitrary (unused) port numbers determined by the operating system during startup.</p>
 
+<h2 id="custom-message-mapping">Custom Message Mapping</h2>
+
+<p>This protocol adapter supports transformation of messages that have been uploaded by devices before forwarding them to downstream consumers.</p>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Experimental</h4>
+    <div>This is an experimental feature. The names of the configuration properties, potential values and the overall functionality are therefore
+subject to change without prior notice.</div>
+</div>
+
+
+<p>The following table provides an overview of the configuration variables and corresponding command line options for configuring the external
+service endpoint(s) for transforming messages:</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">Environment Variable<br>Command Line Option</th>
+<th align="center">Mandatory</th>
+<th align="left">Default Value</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>HONO_MQTT_MAPPERENDPOINTS_&lt;mapperName&gt;_HOST</code><br><code>--hono.mqtt.mapperEndpoints.&lt;mapperName&gt;.host</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The host name or IP address of the service to invoke for transforming uploaded messages. The <code>&lt;mapperName&gt;</code> needs to contain the service name as set in the <em>mapper</em> property of the device&rsquo;s registration information.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_MAPPERENDPOINTS_&lt;mapperName&gt;_PORT</code><br><code>--hono.mqtt.mapperEndpoints.&lt;mapperName&gt;.port</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The port of the service to invoke for transforming uploaded messages. The <code>&lt;mapperName&gt;</code> needs to contain the service name as set in the <em>mapper</em> property of the device&rsquo;s registration information.</td>
+</tr>
+
+<tr>
+<td align="left"><code>HONO_MQTT_MAPPERENDPOINTS_&lt;mapperName&gt;_URI</code><br><code>--hono.mqtt.mapperEndpoints.&lt;mapperName&gt;.uri</code></td>
+<td align="center">no</td>
+<td align="left">-</td>
+<td align="left">The URI of the service to invoke for transforming uploaded messages. The <code>&lt;mapperName&gt;</code> needs to contain the service name as set in the <em>mapper</em> property of the device&rsquo;s registration information.</td>
+</tr>
+</tbody>
+</table>
+
 <footer class=" footline" >
 	
 </footer>
@@ -2007,6 +2147,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2223,6 +2379,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2625,20 +2813,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/admin-guide/secure_communication/index.html b/docs/admin-guide/secure_communication/index.html
index 9198805..0b22521 100644
--- a/docs/admin-guide/secure_communication/index.html
+++ b/docs/admin-guide/secure_communication/index.html
@@ -21,19 +21,19 @@
     <title>Secure Communication :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/secure_communication/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/secure_communication/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/secure_communication/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/secure_communication/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/secure_communication/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/secure_communication/">dev</option>
@@ -1449,7 +1532,8 @@
 <ul>
 <li><a href="#auth-server">Auth Server</a></li>
 <li><a href="#dispatch-router">Dispatch Router</a></li>
-<li><a href="#device-registry">Device Registry</a></li>
+<li><a href="#file-based-device-registry">File Based Device Registry</a></li>
+<li><a href="#mongodb-based-device-registry">MongoDB Based Device Registry</a></li>
 <li><a href="#http-adapter">HTTP Adapter</a></li>
 <li><a href="#mqtt-adapter">MQTT Adapter</a></li>
 <li><a href="#kura-adapter">Kura Adapter</a></li>
@@ -1563,12 +1647,50 @@
 </tbody>
 </table>
 
-<h3 id="device-registry">Device Registry</h3>
+<h3 id="file-based-device-registry">File Based Device Registry</h3>
 
-<p>The Device Registry supports the use of TLS for connections to protocol adapters and the Auth Server.
-Please refer to the <a href="/hono/docs/admin-guide/device-registry-config/">Device Registry admin guide</a> for details regarding the required configuration steps.</p>
+<p>The file based Device Registry supports the use of TLS for connections to protocol adapters and the Auth Server.
+Please refer to the <a href="/hono/docs/admin-guide/file-based-device-registry-config/">file based Device Registry admin guide</a> for details regarding the required configuration steps.</p>
 
-<p>The <code>demo-certs/certs</code> folder contains the following demo keys and certificates to be used with the Device Registry for that purpose.</p>
+<p>The <code>demo-certs/certs</code> folder contains the following demo keys and certificates to be used with the file based Device Registry for that purpose.</p>
+
+<table>
+<thead>
+<tr>
+<th align="left">File</th>
+<th align="left">Description</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td align="left"><code>auth-server-cert.pem</code></td>
+<td align="left">The certificate of the Auth Server, used to verify the signatures of tokens issued by the Auth Server.</td>
+</tr>
+
+<tr>
+<td align="left"><code>device-registry-key.pem</code></td>
+<td align="left">The example private key for creating signatures.</td>
+</tr>
+
+<tr>
+<td align="left"><code>device-registry-cert.pem</code></td>
+<td align="left">The example certificate asserting the server&rsquo;s identity.</td>
+</tr>
+
+<tr>
+<td align="left"><code>trusted-certs.pem</code></td>
+<td align="left">Trusted CA certificates to use for verifying signatures.</td>
+</tr>
+</tbody>
+</table>
+
+<h3 id="mongodb-based-device-registry">MongoDB Based Device Registry</h3>
+
+<p>The MongoDB based Device Registry supports the use of TLS for connections to protocol adapters and the Auth Server.
+Please refer to the <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">MongoDB based Device Registry admin guide</a> for details regarding the required configuration steps.</p>
+
+<p>The <code>demo-certs/certs</code> folder contains the following demo keys and certificates to be used with the MongoDB based Device Registry for that purpose.</p>
 
 <table>
 <thead>
@@ -2124,6 +2246,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2309,6 +2447,38 @@
             
                 
                     
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
                     
                 
                 
@@ -2742,20 +2912,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/api/authentication/index.html b/docs/api/authentication/index.html
index d80f03b..1f4717f 100644
--- a/docs/api/authentication/index.html
+++ b/docs/api/authentication/index.html
@@ -21,19 +21,19 @@
     <title>Authentication API Specification :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/authentication/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/authentication/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/authentication/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/authentication/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/authentication/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/authentication/">dev</option>
@@ -1950,6 +2033,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2158,6 +2257,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2568,20 +2699,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/api/command-and-control/index.html b/docs/api/command-and-control/index.html
index 53a8872..84b6e33 100644
--- a/docs/api/command-and-control/index.html
+++ b/docs/api/command-and-control/index.html
@@ -21,19 +21,19 @@
     <title>Command & Control API Specification :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/command-and-control/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/command-and-control/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/command-and-control/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/command-and-control/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/command-and-control/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/command-and-control/">dev</option>
@@ -2171,6 +2254,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2379,6 +2478,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2789,20 +2920,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/api/credentials/index.html b/docs/api/credentials/index.html
index db07e5f..3d53183 100644
--- a/docs/api/credentials/index.html
+++ b/docs/api/credentials/index.html
@@ -21,19 +21,19 @@
     <title>Credentials API Specification :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/credentials/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/credentials/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/credentials/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/credentials/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/credentials/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/credentials/">dev</option>
@@ -2031,7 +2114,7 @@
 
 <h3 id="pre-shared-key">Pre-Shared Key</h3>
 
-<p>A credential type for storing a <em>Pre-shared Key</em> as used in TLS handshakes.</p>
+<p>A credential type for storing a <em>Pre-shared Key</em> as used in (D)TLS handshakes.</p>
 
 <p>Example:</p>
 
@@ -2083,7 +2166,7 @@
 
 <h3 id="x-509-certificate">X.509 Certificate</h3>
 
-<p>A credential type for storing the <a href="https://www.ietf.org/rfc/rfc2253.txt">RFC 2253</a> formatted <em>subject DN</em> of a client certificate that is used to authenticate the device as part of a TLS handshake.</p>
+<p>A credential type for storing the <a href="https://www.ietf.org/rfc/rfc2253.txt">RFC 2253</a> formatted <em>subject DN</em> of a client certificate that is used to authenticate the device as part of a (D)TLS handshake.</p>
 
 <p>Example:</p>
 
@@ -2443,6 +2526,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2651,6 +2750,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -3061,20 +3192,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/api/device-connection/index.html b/docs/api/device-connection/index.html
index 5c9cfb1..feaeb8d 100644
--- a/docs/api/device-connection/index.html
+++ b/docs/api/device-connection/index.html
@@ -21,19 +21,19 @@
     <title>Device Connection API Specification :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/device-connection/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/device-connection/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/device-connection/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/device-connection/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/device-connection/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/device-connection/">dev</option>
@@ -1717,6 +1800,8 @@
 
 <p>Clients use this command to <em>set</em> the protocol adapter instance that currently handles command &amp; control messages for a given device.</p>
 
+<p>Clients can provide an optional <code>lifespan</code> parameter to make the protocol adapter instance entry expire after the given number of seconds. Note that implementations of this API have to support this feature, otherwise protocol adapters, as the clients of this API, might fail to correctly route command messages.</p>
+
 <p>This API doesn&rsquo;t mandate checks on the validity of the given device in order not to introduce a dependency on the <em>Device Registration API</em>. However, implementations of this API may choose to perform such checks or impose a restriction on the overall amount of data that can be stored per tenant in order to protect against malicious requests.</p>
 
 <p><strong>Message Flow</strong></p>
@@ -1760,6 +1845,14 @@
 <td align="left"><em>string</em></td>
 <td align="left">The identifier of the protocol adapter instance that currently handles commands for the device or gateway identified by the <em>device_id</em> property.</td>
 </tr>
+
+<tr>
+<td align="left"><em>lifespan</em></td>
+<td align="center">no</td>
+<td align="left"><em>application-properties</em></td>
+<td align="left"><em>int</em></td>
+<td align="left">The lifespan of the mapping entry in seconds. After that period, the mapping entry shall be treated as non-existent by the <em>Device Registration API</em> methods. A negative value, as well as an omitted property, is interpreted as an unlimited lifespan.</td>
+</tr>
 </tbody>
 </table>
 
@@ -1782,12 +1875,12 @@
 <tbody>
 <tr>
 <td align="left"><em>204</em></td>
-<td align="left">OK, the adapter instance for the device has been updated.</td>
+<td align="left">OK, the command-handling adapter instance for the device has been updated.</td>
 </tr>
 
 <tr>
 <td align="left"><em>400</em></td>
-<td align="left">Bad Request, the command-handling adapter instance has not been updated due to invalid or missing data in the request.</td>
+<td align="left">Bad Request, the adapter instance for the device has not been set or updated due to invalid or missing data in the request.</td>
 </tr>
 </tbody>
 </table>
@@ -1874,14 +1967,13 @@
 </tr>
 
 <tr>
-<td align="left"><em>404</em></td>
-<td align="left">Not Found, there is no matching command-handling adapter instance assigned to the device.</td>
+<td align="left"><em>412</em></td>
+<td align="left">Precondition failed, the adapter instance for the device has not been removed because there is no matching command-handling adapter instance assigned to the device.</td>
 </tr>
 </tbody>
 </table>
 
-<p>Implementors of this API may return a <em>404</em> status code in order to indicate that no device with the given identifier exists for the given tenant. However, performing such a check is optional.
-In case the currently mapped adapter instance doesn&rsquo;t match the given adapter instance id, a <em>412</em> status code may also be returned instead of <em>404</em>.</p>
+<p>Implementors of this API may return a <em>404</em> status code in order to indicate that no device with the given identifier exists for the given tenant. However, performing such a check is optional.</p>
 
 <p>For status codes indicating an error (codes in the <code>400 - 499</code> range) the message body MAY contain a detailed description of the error that occurred.</p>
 
@@ -2563,6 +2655,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2771,6 +2879,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -3181,20 +3321,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/api/device-connection/set_cmd_handling_adapter_instance.svg b/docs/api/device-connection/set_cmd_handling_adapter_instance.svg
index c4ddddb..13560e6 100644
--- a/docs/api/device-connection/set_cmd_handling_adapter_instance.svg
+++ b/docs/api/device-connection/set_cmd_handling_adapter_instance.svg
@@ -1,8 +1,8 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="253.2px" preserveAspectRatio="none" style="width:724px;height:253px;" version="1.1" viewBox="0 0 724 253" width="724.8px" zoomAndPan="magnify"><defs><filter height="300%" id="f1gt9jxm420dxu" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f1gt9jxm420dxu)" height="81.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="498.6" y="101.475"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="43.2" x2="43.2" y1="45.9563" y2="204.9938"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="504" x2="504" y1="45.9563" y2="204.9938"/><rect fill="#FEFECE" filter="url(#f1gt9jxm420dxu)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="27.5941">Client</text><rect fill="#FEFECE" filter="url(#f1gt9jxm420dxu)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="203.7938"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="227.7879">Client</text><rect fill="#FEFECE" filter="url(#f1gt9jxm420dxu)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="238.8" x="382.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="222" x="391.2" y="27.5941">Device Connection Service</text><rect fill="#FEFECE" filter="url(#f1gt9jxm420dxu)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="238.8" x="382.8" y="203.7938"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="222" x="391.2" y="227.7879">Device Connection Service</text><rect fill="#FFFFFF" filter="url(#f1gt9jxm420dxu)" height="81.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="498.6" y="101.475"/><polygon fill="#A80036" points="484.2,96.675,496.2,101.475,484.2,106.275,489,101.475" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="491.4" y1="101.475" y2="101.475"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="418.8" x="52.2" y="77.2365">transfer(subject: "set-cmd-handling-adapter-instance",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="427.2" x="57" y="95.3959">device_id: "device-1", adapter_instance_id: "adapter_1")</text><path d="M294,117.075 L294,147.075 L710.4,147.075 L710.4,129.075 L698.4,117.075 L294,117.075 " fill="#FBFB77" filter="url(#f1gt9jxm420dxu)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M698.4,117.075 L698.4,129.075 L710.4,129.075 L698.4,117.075 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="391.2" x="301.2" y="137.5553">set command-handling adapter instance for device</text><polygon fill="#A80036" points="57,178.5938,45,183.3937,57,188.1938,52.2,183.3937" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="503.4" y1="183.3937" y2="183.3937"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="170.4" x="64.2" y="177.3146">transfer(status: "204")</text><!--MD5=[1835b2c35a6af2f993db2cd294daab3a]
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="271.2px" preserveAspectRatio="none" style="width:728px;height:271px;" version="1.1" viewBox="0 0 728 271" width="728.4px" zoomAndPan="magnify"><defs><filter height="300%" id="fxerzl4s6z9dj" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#fxerzl4s6z9dj)" height="81.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="502.2" y="119.6344"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="43.2" x2="43.2" y1="45.9563" y2="223.1531"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="507.6" x2="507.6" y1="45.9563" y2="223.1531"/><rect fill="#FEFECE" filter="url(#fxerzl4s6z9dj)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="27.5941">Client</text><rect fill="#FEFECE" filter="url(#fxerzl4s6z9dj)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="63.6" x="9.6" y="221.9531"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="46.8" x="18" y="245.9473">Client</text><rect fill="#FEFECE" filter="url(#fxerzl4s6z9dj)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="238.8" x="386.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="222" x="394.8" y="27.5941">Device Connection Service</text><rect fill="#FEFECE" filter="url(#fxerzl4s6z9dj)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="238.8" x="386.4" y="221.9531"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="222" x="394.8" y="245.9473">Device Connection Service</text><rect fill="#FFFFFF" filter="url(#fxerzl4s6z9dj)" height="81.9188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="502.2" y="119.6344"/><polygon fill="#A80036" points="487.8,114.8344,499.8,119.6344,487.8,124.4344,492.6,119.6344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="43.8" x2="495" y1="119.6344" y2="119.6344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="418.8" x="52.2" y="77.2365">transfer(subject: "set-cmd-handling-adapter-instance",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="426" x="57" y="95.3959">device_id: "device-1", adapter_instance_id: "adapter_1",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="112.8" x="57" y="113.5553">lifespan: 3600)</text><path d="M297.6,135.2344 L297.6,165.2344 L714,165.2344 L714,147.2344 L702,135.2344 L297.6,135.2344 " fill="#FBFB77" filter="url(#fxerzl4s6z9dj)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M702,135.2344 L702,147.2344 L714,147.2344 L702,135.2344 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="391.2" x="304.8" y="155.7146">set command-handling adapter instance for device</text><polygon fill="#A80036" points="57,196.7531,45,201.5531,57,206.3531,52.2,201.5531" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="49.8" x2="507" y1="201.5531" y2="201.5531"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="170.4" x="64.2" y="195.474">transfer(status: "204")</text><!--MD5=[a6ac3462a1757a2cb56018529af2f61c]
 @startuml
 scale 1.2
 
-Client -> "Device Connection Service": transfer(subject: "set-cmd-handling-adapter-instance", \n device_id: "device-1", adapter_instance_id: "adapter_1")
+Client -> "Device Connection Service": transfer(subject: "set-cmd-handling-adapter-instance", \n device_id: "device-1", adapter_instance_id: "adapter_1", \n lifespan: 3600)
 activate "Device Connection Service"
 note over "Device Connection Service"
 set command-handling adapter instance for device
diff --git a/docs/api/device-registration/index.html b/docs/api/device-registration/index.html
index a12c9f7..3011823 100644
--- a/docs/api/device-registration/index.html
+++ b/docs/api/device-registration/index.html
@@ -21,19 +21,19 @@
     <title>Device Registration API Specification :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/device-registration/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/device-registration/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/device-registration/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/device-registration/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/device-registration/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/device-registration/">dev</option>
@@ -1657,17 +1740,25 @@
 <td align="left"><em>object</em></td>
 <td align="left">Default values to be used by protocol adapters for augmenting messages from devices with missing information like a <em>content type</em>. It is up to the discretion of a protocol adapter if and how to use the given default values when processing messages published by the device.</td>
 </tr>
+
+<tr>
+<td align="left"><em>mapper</em></td>
+<td align="center"><em>no</em></td>
+<td align="left"><em>string</em></td>
+<td align="left">The name of a service that can be used to transform messages uploaded by the device before they are forwarded to downstream consumers. The client needs to map this name to the particular service to invoke.</td>
+</tr>
 </tbody>
 </table>
 
-<p>Below is an example for a payload of a response to an <em>assert</em> request for device <code>4711</code> which also includes a default <em>content-type</em>:</p>
+<p>Below is an example for a payload of a response to an <em>assert</em> request for device <code>4711</code> which also includes a default <em>content-type</em> and a mapper service:</p>
 
 <pre><code class="language-json">{
   &quot;device-id&quot;: &quot;4711&quot;,
   &quot;via&quot;: [&quot;4712&quot;],
   &quot;defaults&quot;: {
     &quot;content-type&quot;: &quot;application/vnd.acme+json&quot;
-  }
+  },
+  &quot;mapper&quot;: &quot;my-payload-transformation&quot;
 }
 </code></pre>
 
@@ -2050,6 +2141,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2258,6 +2365,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2668,20 +2807,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/api/event/index.html b/docs/api/event/index.html
index 384b8ac..a64310d 100644
--- a/docs/api/event/index.html
+++ b/docs/api/event/index.html
@@ -21,19 +21,19 @@
     <title>Event API Specification :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/event/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/event/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/event/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/event/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/event/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/event/">dev</option>
@@ -2025,6 +2108,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2233,6 +2332,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2643,20 +2774,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/api/index.html b/docs/api/index.html
index 2b36f74..ece7995 100644
--- a/docs/api/index.html
+++ b/docs/api/index.html
@@ -21,19 +21,19 @@
     <title>API :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/">dev</option>
@@ -1773,6 +1856,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -1981,6 +2080,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2387,20 +2518,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/api/management/device-registry-v1.yaml b/docs/api/management/device-registry-v1.yaml
index 0b55f1d..6ea7ffa 100644
--- a/docs/api/management/device-registry-v1.yaml
+++ b/docs/api/management/device-registry-v1.yaml
@@ -24,10 +24,10 @@
       ## Code generation
 
       This model is not optimized for generating code from it. Code generators
-      try to understand the model and then translate this into the require
-      programming language. Even if the there would be no bugs in the code
-      generators, that process would be already only be an approximation. So
-      this model does focus in the description of the API, and doesn't tweak
+      try to understand the model and then translate this into the required
+      programming language. Even if there would be no bugs in the code
+      generators, that process would already only be an approximation. So
+      this model focuses on the description of the API, and does not tweak
       the specification in a way to please code generators.
 
    contact:
@@ -36,7 +36,7 @@
    license:
       name: EPL-2.0
       url: https://www.eclipse.org/legal/epl-2.0/
-   version: 1.1.0
+   version: 1.3.0
 
 externalDocs:
    description: Eclipse Hono™ web page
@@ -78,14 +78,22 @@
       post:
          tags:
             - tenants
-         summary: Create new tenant with auto-generated ID
+         summary: Create a new tenant with an auto-generated ID
+         description: |
+            Clients use this operation to register a new tenant with an identifier that
+            is generated by the registry.
          operationId: createTenant
          requestBody:
-            description: New tenant information
+            description: The configuration properties to register for the tenant.
             content:
                application/json:
                   schema:
                      $ref: '#/components/schemas/Tenant'
+                  examples:
+                     default:
+                        $ref: '#/components/examples/TenantAllAdaptersExample'
+                     mqtt-only:
+                        $ref: '#/components/examples/TenantMqttAdapterOnlyExample'
             required: false
          responses:
             201:
@@ -116,14 +124,21 @@
       post:
          tags:
             - tenants
-         summary: Create new tenant
+         summary: Create a new tenant with a given ID
+         description: |
+            Clients use this operation to register a new tenant with a given identifier.
          operationId: createTenantWithId
          requestBody:
-            description: New tenant registration
+            description: The configuration properties to register for the tenant.
             content:
                application/json:
                   schema:
                      $ref: '#/components/schemas/Tenant'
+                  examples:
+                     default:
+                        $ref: '#/components/examples/TenantAllAdaptersExample'
+                     mqtt-only:
+                        $ref: '#/components/examples/TenantMqttAdapterOnlyExample'
             required: false
          responses:
             201:
@@ -136,7 +151,7 @@
                $ref: '#/components/responses/NotAllowed'
             409:
                description: |
-                  Indicates that tenant with the given identifier already exists or that an existing tenant uses
+                  Indicates that a tenant with the given identifier already exists or that an existing tenant uses
                   a certificate authority with the same Subject DN.
                   If the client has no read access to the conflicting tenant then `403` should be returned instead.
                content:
@@ -150,6 +165,8 @@
          tags:
             - tenants
          summary: Get tenant information
+         description: |
+            Clients use this operation to retrieve the configuration properties of an existing tenant.
          operationId: getTenant
          responses:
             200:
@@ -158,6 +175,27 @@
                   application/json:
                      schema:
                         $ref: '#/components/schemas/Tenant'
+                     examples:
+                        mqtt-only:
+                           summary: Constrained tenant
+                           description: |
+                              The body contains the configuration properties of a tenant for which
+                              some resource limits have been defined.
+                           value: |
+                              {
+                                 "enabled": true,
+                                 "resource-limits": {
+                                    "max-connections": 1000,
+                                    "max-ttl": 3600,
+                                    "data-volume": {
+                                       "effective-since": "2019-12-01T00:00:00Z",
+                                       "max-bytes": 10000000,
+                                       "period": {
+                                          "mode": "monthly"
+                                       }
+                                    }
+                                 }
+                              }
                headers:
                   ETag:
                      description: Version of the resource
@@ -174,15 +212,32 @@
          tags:
             - tenants
          summary: Update tenant information
+         description: |
+            Clients use this operation to replace an existing tenant's registration information
+            with the information contained in the request body.
          operationId: updateTenant
          parameters:
             - $ref: '#/components/parameters/resourceVersion'
          requestBody:
-            description: Tenant information
+            description: The configuration properties to replace the tenant's existing configuration with.
             content:
                application/json:
                   schema:
                      $ref: '#/components/schemas/Tenant'
+                  examples:
+                     disable-tenant:
+                        summary: Disable a tenant
+                        description: |
+                           Disabling a tenant effectively prevents any devices of that tenant
+                           to connect to any of the protocol adapters. Devices that are
+                           already connected to an adapter can no longer upload any data
+                           nor receive any commands. Note that the example payload does
+                           not contain any other properties than *enabled* which means
+                           that all other configuration will be removed.
+                        value: |
+                           {
+                              "enabled": false
+                           }
             required: true
          responses:
             204:
@@ -213,6 +268,10 @@
          tags:
             - tenants
          summary: Delete tenant
+         description: |
+            Clients use this operation to remove an existing tenant from the registry.
+            Registry implementations may optionally perform a *cascading* delete of all
+            the tenant's devices and credentials as well.
          operationId: deleteTenant
          parameters:
             - $ref: '#/components/parameters/resourceVersion'
@@ -238,14 +297,22 @@
       post:
          tags:
             - devices
-         summary: Create new device registration with auto-generated ID
+         summary: Create a new device registration with auto-generated ID
+         description: |
+            Clients use this operation to register a new device for an existing tenant with
+            an identifier that is generated by the registry.
          operationId: createDeviceRegistration
          requestBody:
-            description: New device
+            description: The configuration properties to register for the device.
             content:
                application/json:
                   schema:
                      $ref: '#/components/schemas/Device'
+                  examples:
+                     default:
+                        $ref: '#/components/examples/DeviceDefaultExample'
+                     extensions:
+                        $ref: '#/components/examples/DeviceExtExample'
             required: false
          responses:
             201:
@@ -266,14 +333,21 @@
       post:
          tags:
             - devices
-         summary: Create new device registration
+         summary: Create a new device registration
+         description: |
+            Clients use this operation to register a new device with a given identifier.
          operationId: createDeviceRegistrationWithId
          requestBody:
-            description: New device
+            description: The configuration properties to register for the device.
             content:
                application/json:
                   schema:
                      $ref: '#/components/schemas/Device'
+                  examples:
+                     default:
+                        $ref: '#/components/examples/DeviceDefaultExample'
+                     extensions:
+                        $ref: '#/components/examples/DeviceExtExample'
             required: false
          responses:
             201:
@@ -291,6 +365,8 @@
          tags:
             - devices
          summary: Get device registration information
+         description: |
+            Clients use this operation to retrieve the configuration properties of an existing device.
          operationId: getRegistration
          responses:
             200:
@@ -299,6 +375,33 @@
                   application/json:
                      schema:
                         $ref: '#/components/schemas/Device'
+                     examples:
+                        fully-configured:
+                           summary: Fully configured device
+                           description: |
+                              The body contains the configuration properties of a device which
+                              has been configured extensively.
+                           value: |
+                              {
+                                 "enabled": true,
+                                 "defaults": {
+                                    "ttl": 300,
+                                    "content-type": "application/vnd.acme+json"
+                                 },
+                                 "via": [
+                                    "gw-1", "gw-4"
+                                 ],
+                                 "status": {
+                                    "created": "2019-10-03T13:45:16Z"
+                                    "updated": "2020-05-04T10:11:12Z"
+                                    "last-user": "Bob"
+                                 }
+                                 "ext": {
+                                    "manufacturer": "ACME",
+                                    "model-no": "TEMP-SEN",
+                                    "serial-no": "3435A-454"
+                                 }
+                              }
                headers:
                   ETag:
                      description: Version of the resource
@@ -314,16 +417,33 @@
       put:
          tags:
             - devices
-         summary: Update existing device registration
+         summary: Update an existing device registration
+         description: |
+            Clients use this operation to replace an existing device's registration information
+            with the information contained in the request body.
          operationId: updateRegistration
          parameters:
             - $ref: '#/components/parameters/resourceVersion'
          requestBody:
-            description: Updated device registration
+            description: The configuration properties to replace the device's existing configuration with.
             content:
                application/json:
                   schema:
                      $ref: '#/components/schemas/Device'
+                  examples:
+                     disable-device:
+                        summary: Disable a device
+                        description: |
+                           Disabling a device effectively prevents the device
+                           to connect to any of the protocol adapters. If the device is
+                           already connected to an adapter then it can no longer upload
+                           any data nor receive any commands. Note that the example payload does
+                           not contain any other properties than *enabled* which means
+                           that all other configuration will be removed.
+                        value: |
+                           {
+                              "enabled": false
+                           }
             required: true
          responses:
             204:
@@ -342,7 +462,11 @@
       delete:
          tags:
             - devices
-         summary: Delete device registration
+         summary: Delete an existing device registration
+         description: |
+            Clients use this operation to remove an existing device from the registry.
+            Registry implementations may optionally perform a *cascading* delete of all
+            the device's credentials as well.
          operationId: deleteRegistration
          parameters:
             - $ref: '#/components/parameters/resourceVersion'
@@ -367,15 +491,20 @@
       get:
          tags:
             - credentials
-         summary: Get credentials set of a device.
+         summary: Gets a device's set of credentials.
          description: |
-            Get the credentials set of a device. As long as the device is
-            registered and the user has read access to it, this call should
-            never return "not found".
-            Depending on its implementation (or configuration), the device registry
-            can either return all credentials information including full secret details or
-            secret metadata along with the generated identifier (an `id` property).
-            The identifier can be used for the follow-up `update` operation).
+            Clients use this operation to retrieve the set of credentials registered for an existing device.
+            Hono's protocol adapters use the credentials registered for a device in order to
+            authenticate the device when it connects to an adapter.
+            Implementors may return all of the credentials' data including all
+            details of its secrets like password hash and/or hash algortihm used.
+            This mode of operation is called *replace mode*. However, this behavior is
+            discouraged because it might disclose confidential information in plain text.
+            
+            Instead, implementors should remove all confidential information from the secrets
+            and include a (unique) identifier with each secret. Clients can then refer to
+            this identifier in order to update particular secrets. This mode of operation
+            is called *patch mode*.
          operationId: getAllCredentials
          responses:
             200:
@@ -385,8 +514,8 @@
                      schema:
                         $ref: '#/components/schemas/CredentialsSet'
                      examples:
-                        Credentials Metadata:
-                           $ref: '#/components/examples/MetaPasswordExample'
+                        meta-data:
+                           $ref: '#/components/examples/CredentialsMetaDataExample'
                headers:
                   ETag:
                      description: Version of the resource
@@ -402,10 +531,45 @@
       put:
          tags:
             - credentials
-         summary: Update credentials set for registered device
-         description: If the device registry is handling full secret details, the updated credential set
-                      will be an exact match of the provided content. If it is using secret metadata,
-                      data will be merged in based on the secret identities.
+         summary: Updates a device's credentials.
+         description: |
+            A client uses this operation to update a device's existing set of credentials
+            with the credentials contained in the request body.
+
+            A registry may run in one of two modes for updating credentials, *replace mode*
+            or *patch mode*. A client can determine the mode of operation by means of inspecting
+            any of the secrets returned by the *getAllCredentials* operation. If the secrets
+            do not contain an `id` property, then the registry uses *replace mode*, otherwise
+            it operates in *patch mode*.
+
+            In replace mode the registry simply replaces a device's existing set of credentials
+            with the credentials provided in the request body.
+
+            In patch mode the registry processes the set of updated credentials provided in the
+            request body as follows.
+            1. Start with an empty set `N` of new credentials.
+            1. For each updated credentials object `c-U` contained in the request body,
+               the registry looks up an existing credentials object `c-E` of the same device ID, type
+               and authentication identifier.
+               1. If no matching credentials object exists, `c-U` is added to the set of new
+                  credentials `N`.
+               1. Otherwise, `c-E` is patched over with `c-U` as follows. For each of `c-U`'s
+                  secrets `s-U` the registry does the following
+                  1. If `s-U` has no `id` property, the registry assigns a unique identifier to `s-U`.
+                  1. Otherwise, the registry tries to find a secret `s-E` with the same identifier as `s-U`
+                     among the secrets of `c-E`.
+                     1. If no matching secret exists, updating the credentials has failed and the registry
+                        returns a response with status 400 (Bad Request).
+                     1. Otherwise the confidential properties of `s-E` are merged into `s-U`
+                        with the property values of `s-U` taking precedence.
+               1. `c-U` is added to `N`.
+            1. The registry replaces the device's existing set of credentials with `N` and returns an
+               empty response with status code 204 (No Content) to indicate the successful outcome of the
+               operation.
+
+               Note that `N` does not contain any of the existing credentials objects `c-E` for which
+               no corresponding credentials object `c-U` with the same device ID, type and authentication
+               identifier exists. This way, existing credentials can be deleted.
          operationId: setAllCredentials
          parameters:
             - $ref: '#/components/parameters/resourceVersion'
@@ -415,10 +579,10 @@
                   schema:
                      $ref: '#/components/schemas/CredentialsSet'
                   examples:
-                     Hashed Password:
-                        $ref: '#/components/examples/HashedPasswordExample'
-                     Plain Password:
-                        $ref: '#/components/examples/PlainPasswordExample'
+                     set-password:
+                        $ref: '#/components/examples/CredentialsSetPasswordExample'
+                     change-password:
+                        $ref: '#/components/examples/CredentialsChangePasswordExample'
             required: true
          responses:
             204:
@@ -513,7 +677,7 @@
                description: |
                   The subject DN of the trusted root certificate in
                   the format defined by RFC 2253.
-                  CAs of the *same* tenant may share the same subject DN, e.g.
+                  CAs of the *same* tenant may share the same subject DN, for example
                   allowing for the definition of overlapping validity periods.
                   However, CAs of *different* tenants must not share the same
                   subject DN in order to allow for the unique look up of a tenant by
@@ -521,7 +685,7 @@
                   If the `cert` property is used to provide an X.509 certificate
                   then the subject DN is determined from the certificate and this
                   property is ignored.
-                  Otherwise, i.e. if the `public-key` property is
+                  Otherwise, if the `public-key` property is
                   used, this property is mandatory.
             "public-key":
                type: string
@@ -540,7 +704,7 @@
                   If the `cert` property is used to provide an
                   X.509 certificate then the algorithm is determined
                   from the certificate and this property is ignored.
-                  Otherwise, i.e. if the `public-key` property is
+                  Otherwise, if the `public-key` property is
                   used, this property must be set to the algorithm
                   used, if other than the default.
                default: RSA
@@ -554,7 +718,7 @@
                   If the `cert` property is used to provide an
                   X.509 certificate then the point in time is
                   determined from the certificate and this property is ignored.
-                  Otherwise, i.e. if the `public-key` property is
+                  Otherwise, if the `public-key` property is
                   used, this property is mandatory.
             "not-after":
                type: string
@@ -565,7 +729,7 @@
                   If the `cert` property is used to provide an
                   X.509 certificate then the point in time is
                   determined from the certificate and this property is ignored.
-                  Otherwise, i.e. if the `public-key` property is
+                  Otherwise, if the `public-key` property is
                   used, this property is mandatory.
             "cert":
                type: string
@@ -586,7 +750,7 @@
                   Indicates whether this trusted certificate may be used for automatically provisioning devices.
                   If it is *true* and the feature is supported by the device registry, the device registry
                   automatically provisions unregistered devices that authenticate with a client certificate
-                  issued by this CA (i.e. creates registration and credentials).
+                  issued by this CA (that is, creates registration and credentials).
 
          example:
             subject-dn: "CN=devices,OU=iot,O=ACME"
@@ -765,19 +929,56 @@
                type: array
                items:
                   type: string
-               description: The device IDs of the gateways that are registered to act on behalf of this device. Note that "via" and "memberOf" must not be set at the same time.
+               description: |
+                  The device IDs of the gateways that are registered to act on behalf of this device.
+                  Note that "via" and "memberOf" must not be set at the same time.
             "viaGroups":
                type: array
                items:
                   type: string
-               description: The IDs of the gateway groups that are registered to act on behalf of this device. Note that "viaGroups" and "memberOf" must not be set at the same time.
+               description: |
+                  The IDs of the gateway groups that are registered to act on behalf of this device.
+                  Note that "viaGroups" and "memberOf" must not be set at the same time.
             "memberOf":
                type: array
                items:
                   type: string
-               description: The IDs of the gateway groups that this device is a member of. Note that "via" and "memberOf" must not be set at the same time. The same applies for "viaGroups" and "memberOf" which must be set at the same time too. The reason is that Eclipse Hono does not support groups of gateway groups.
+               description: |
+                  The IDs of the gateway groups that this device is a member of.
+                  Note that neither "via" nor "viaGroups" must be set if "memberOf" is set.
+            "mapper":
+               type: string
+               description: |
+                  The name of a service that can be used by protocol adapters to transform messages
+                  uploaded by devices before sending them to downstream consumers.
+                  The protocol adapter needs to map this name to the particular service to invoke.
+                  NB: This is an experimental feature and thus this property is subject to change without
+                  notice.
             "ext":
                $ref: '#/components/schemas/Extensions'
+            "status":
+               $ref: '#/components/schemas/Status'
+
+      Status:
+         type: object
+         additionalProperties: false
+         description: Optional and written only by the device registry implementation.
+            It can not be updated by the user.
+            Any data inserted in the status section by the user in a PUT request will be ignored.
+         properties:
+            "created":
+               type: string
+               format: date-time
+               description: The date and time when the device was created.
+                  The format must comply with RFC 3339, section 5.6. The representation must be UTC (no timezone offset).
+            "updated":
+               type: string
+               format: date-time
+               description: The date and time when the device was last updated.
+                  The format must comply with RFC 3339, section 5.6. The representation must be UTC (no timezone offset).
+            "last-user":
+               type: string
+               description: The user who made the last edit on this device.
 
 # Credentials
 
@@ -810,8 +1011,10 @@
          properties:
             "type":
                type: string
+               pattern: "[a-z0-9-]"
             "auth-id":
                type: string
+               pattern: "[a-zA-Z0-9-_=.]"
             "enabled":
                type: boolean
                default: true
@@ -880,10 +1083,6 @@
             - $ref: '#/components/schemas/CommonSecret'
 
       PasswordSecret:
-         description: |
-                      Password based secret definition <br>
-                      __NOTE__: Defining password secrets with user provided password hash, function and salt is deprecated and will be removed
-                      in the upcoming versions. You should use `pwd-plain` property only going forward.
          additionalProperties: false
          allOf:
             - $ref: '#/components/schemas/CommonSecret'
@@ -949,6 +1148,7 @@
          required: true
          schema:
             type: string
+            pattern: "[a-zA-Z0-9-_\\.]"
          example: DEFAULT_TENANT
 
       deviceId:
@@ -958,6 +1158,7 @@
          required: true
          schema:
             type: string
+            pattern: "[a-zA-Z0-9-_\\.]"
          example: 4711
 
       authId:
@@ -967,6 +1168,7 @@
          required: true
          schema:
             type: string
+            pattern: "[a-zA-Z0-9-_=.]"
          example: sensor1
 
       type:
@@ -976,6 +1178,7 @@
          required: true
          schema:
             type: string
+            pattern: "[a-z0-9-]"
          example: sha-256
 
    responses:
@@ -1025,7 +1228,7 @@
       NotFound:
          description: |
             Object not found. This may also be returned for some operations
-            if the user misses read access for the object.
+            if the user lacks authorization to read the subject of the operation.
          content:
             application/json:
                schema:
@@ -1077,35 +1280,94 @@
          scheme: basic
 
    examples:
-      HashedPasswordExample:
+
+      TenantAllAdaptersExample:
+         summary: All adapters
+         description: |
+            An empty request body can be used to create a tenant
+            using default values. This means that the tenant will be
+            enabled and devices of the tenant may connect to all
+            protocol adapters.
+         value:
+
+      TenantMqttAdapterOnlyExample:
+         summary: MQTT adapter only
+         description: |
+            Creates a tenant with only the MQTT adapter enabled.
+            Devices of the tenant will thus not be able to connect
+            to any adapter other than the MQTT adapter.
+         value: |
+            {
+               "adapters": [{
+                  "type": "hono-mqtt",
+                  "enabled": true
+               }]
+            }
+
+      DeviceDefaultExample:
+         summary: Default properties
+         description: |
+            An empty request body can be used to create an enabled device
+            with no additional configuration.
+
+      DeviceExtExample:
+         summary: Extension properties
+         description: |
+            Creates a device with some (application specific) extension properties.
+         value: |
+            {
+                "ext": {
+                   "ep": "IMEI4711"
+                }
+            }
+
+      CredentialsSetPasswordExample:
+         summary: Set pre-hashed password
+         description: |
+            The secret does not refer to an existing secret (no *id* property). Thus, the
+            existing secrets (if any) will be replaced with the hashed password secret.
          value:
             [{
-                auth-id: sensor1,
-                type: hashed-password,
-                secrets: [{
-                             "not-after": "2027-12-24T19:00:00Z",
-                             "pwd-hash": "AQIDBAUGBwg=",
-                             "salt": "Mq7wFw==",
-                             "hash-function": "sha-512"
-                          }]
+                "auth-id": "sensor1",
+                "type": "hashed-password",
+                "secrets": [{
+                   "pwd-hash": "AQIDBAUGBwg=",
+                   "salt": "Mq7wFw==",
+                   "hash-function": "sha-512",
+                   "not-after": "2027-12-24T19:00:00Z"
+                }]
              }]
 
-      PlainPasswordExample:
+      CredentialsChangePasswordExample:
+         summary: Change password
+         description: |
+            The secret refers to an existing hashed password which will be updated
+            with the included values. The plaintext password will be hashed using
+            the registry's default hash algorithm.
          value:
            [{
                auth-id: sensor1,
                type: hashed-password,
                secrets: [{
                   "id": "349556ea-4902-47c7-beb0-1009ab693fb4",
-                  "not-after": "2027-12-24T19:00:00Z",
-                  "pwd-plain": "hono-secret"
+                  "pwd-plain": "newpassword",
+                  "not-after": "2027-12-24T19:00:00Z"
                }]
             }]
-      MetaPasswordExample:
+
+      CredentialsMetaDataExample:
+         summary: Meta data only
+         description: |
+            The secrets do not contain the confidential information like password hash
+            or salt. Instead, the secrets contain an identifier which can be
+            used to refer to the secret in a subsequent update operation.
          value:
-            auth-id: sensor1
-            type: hashed-password
-            secrets: [{
-               "id": "349556ea-4902-47c7-beb0-1009ab693fb4",
-               "not-after": "2027-12-24T19:00:00Z",
+           [{
+               "enabled": true,
+               "auth-id": "sensor1",
+               "type": "hashed-password",
+               "secrets": [{
+                  "id": "349556ea-4902-47c7-beb0-1009ab693fb4",
+                  "not-after": "2027-12-24T19:00:00Z",
+               }]
             }]
diff --git a/docs/api/management/index.html b/docs/api/management/index.html
index 2f8761d..c6d652f 100644
--- a/docs/api/management/index.html
+++ b/docs/api/management/index.html
@@ -21,19 +21,19 @@
     <title>Device Registry Management API Specification :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -86,14 +86,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -318,9 +318,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -540,9 +559,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -597,6 +635,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -616,9 +673,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1280,7 +1337,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/management/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/management/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/management/">1.2</option>
                     
                   
               
@@ -1296,6 +1373,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/management/">1.1</option>
@@ -1314,6 +1393,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/management/">1.0</option>
@@ -1332,6 +1413,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/management/">dev</option>
@@ -1811,6 +1894,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2019,6 +2118,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2429,20 +2560,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/api/metrics/index.html b/docs/api/metrics/index.html
index b88b490..8d91c3c 100644
--- a/docs/api/metrics/index.html
+++ b/docs/api/metrics/index.html
@@ -21,19 +21,19 @@
     <title>Metrics :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/metrics/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/metrics/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/metrics/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/metrics/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/metrics/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/metrics/">dev</option>
@@ -1692,6 +1775,13 @@
 </tr>
 
 <tr>
+<td><em>hono.connections.attempts</em></td>
+<td>Counter</td>
+<td><em>host</em>, <em>component-type</em>, <em>component-name</em>, <em>outcome</em></td>
+<td>The number of connection attempts to protocol adapters. The outcome can be observed by looking the tag <em>outcome</em> which contains the result and the reason. At the moment there&rsquo;s only one possible value: <code>adapter-connection-limit-exceeded</code><br/> <strong>NB</strong> This metric is only supported by protocol adapters that maintain <em>connection state</em> with authenticated devices. In particular, the HTTP adapter does not support this metric.</td>
+</tr>
+
+<tr>
 <td><em>hono.messages.received</em></td>
 <td>Timer</td>
 <td><em>host</em>, <em>component-type</em>, <em>component-name</em>, <em>tenant</em>, <em>type</em>, <em>status</em>, <em>qos</em>, <em>ttd</em></td>
@@ -2041,6 +2131,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2249,6 +2355,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2659,20 +2797,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/api/telemetry/index.html b/docs/api/telemetry/index.html
index a8d7c79..c2f4e54 100644
--- a/docs/api/telemetry/index.html
+++ b/docs/api/telemetry/index.html
@@ -21,19 +21,19 @@
     <title>Telemetry API Specification :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/telemetry/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/telemetry/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/telemetry/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/telemetry/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/telemetry/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/telemetry/">dev</option>
@@ -1997,6 +2080,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2205,6 +2304,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2612,20 +2743,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/api/tenant/index.html b/docs/api/tenant/index.html
index 47d9eeb..7c0dea8 100644
--- a/docs/api/tenant/index.html
+++ b/docs/api/tenant/index.html
@@ -21,19 +21,19 @@
     <title>Tenant API Specification :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/tenant/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/tenant/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/tenant/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/tenant/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/tenant/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/tenant/">dev</option>
@@ -2518,6 +2601,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2726,6 +2825,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -3136,20 +3267,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/architecture/auth/index.html b/docs/architecture/auth/index.html
index 3e76b47..ef5d497 100644
--- a/docs/architecture/auth/index.html
+++ b/docs/architecture/auth/index.html
@@ -21,19 +21,19 @@
     <title>Authentication/Authorization :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/architecture/auth/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/architecture/auth/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/architecture/auth/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/architecture/auth/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/architecture/auth/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/architecture/auth/">dev</option>
@@ -1848,6 +1931,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2056,6 +2155,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2463,20 +2594,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/architecture/component-view/index.html b/docs/architecture/component-view/index.html
index 1fc0561..0db24f5 100644
--- a/docs/architecture/component-view/index.html
+++ b/docs/architecture/component-view/index.html
@@ -21,19 +21,19 @@
     <title>Component View :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/architecture/component-view/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/architecture/component-view/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/architecture/component-view/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/architecture/component-view/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/architecture/component-view/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/architecture/component-view/">dev</option>
@@ -1847,6 +1930,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2055,6 +2154,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2462,20 +2593,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/architecture/index.html b/docs/architecture/index.html
index 9c3630a..603a699 100644
--- a/docs/architecture/index.html
+++ b/docs/architecture/index.html
@@ -21,19 +21,19 @@
     <title>Architecture :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/architecture/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/architecture/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/architecture/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/architecture/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/architecture/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/architecture/">dev</option>
@@ -1771,6 +1854,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -1979,6 +2078,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2385,20 +2516,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/categories/index.html b/docs/categories/index.html
index dc4fab9..3c9cbbb 100644
--- a/docs/categories/index.html
+++ b/docs/categories/index.html
@@ -21,19 +21,19 @@
     <title>Categories :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/categories/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/categories/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/categories/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/categories/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/categories/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/categories/">dev</option>
@@ -1756,6 +1839,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -1964,6 +2063,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2366,20 +2497,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/concepts/command-and-control/command_control_concept.svg b/docs/concepts/command-and-control/command_control_concept.svg
new file mode 100644
index 0000000..6c4041d
--- /dev/null
+++ b/docs/concepts/command-and-control/command_control_concept.svg
@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="669.6px" preserveAspectRatio="none" style="width:1050px;height:669px;" version="1.1" viewBox="0 0 1050 669" width="1050px" zoomAndPan="magnify"><defs><filter height="300%" id="fngzrirs0jsbq" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="414.7125" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="472.2" y="177.3937"/><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="332.7938" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="912.6" y="259.3125"/><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="137.4375" style="stroke: #000000; stroke-width: 2.4;" width="888" x="98.4" y="131.475"/><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="208.7156" style="stroke: #000000; stroke-width: 2.4;" width="938.4" x="98.4" y="285.7125"/><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="90.4781" style="stroke: #000000; stroke-width: 2.4;" width="888" x="98.4" y="511.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="148.8" x2="148.8" y1="45.9563" y2="622.1062"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="478.2" x2="478.2" y1="45.9563" y2="622.1062"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="918" x2="918" y1="45.9563" y2="622.1062"/><rect fill="#FEFECE" filter="url(#fngzrirs0jsbq)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#fngzrirs0jsbq)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="620.9063"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="644.9004">Device</text><rect fill="#FEFECE" filter="url(#fngzrirs0jsbq)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="373.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="382.2" y="27.5941">Hono Protocol Adapter</text><rect fill="#FEFECE" filter="url(#fngzrirs0jsbq)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="373.8" y="620.9063"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="382.2" y="644.9004">Hono Protocol Adapter</text><rect fill="#FEFECE" filter="url(#fngzrirs0jsbq)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="862.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="871.2" y="27.5941">Application</text><rect fill="#FEFECE" filter="url(#fngzrirs0jsbq)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="862.8" y="620.9063"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="871.2" y="644.9004">Application</text><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="414.7125" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="472.2" y="177.3937"/><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="332.7938" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="912.6" y="259.3125"/><path d="M9.6,63.9563 L9.6,111.9563 L285.6,111.9563 L285.6,75.9563 L273.6,63.9563 L9.6,63.9563 " fill="#FBFB77" filter="url(#fngzrirs0jsbq)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M273.6,63.9563 L273.6,75.9563 L285.6,75.9563 L273.6,63.9563 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="217.2" x="16.8" y="84.4365">The device is connected and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="250.8" x="16.8" y="102.5959">authenticated with TENANT/4711</text><path d="M98.4,131.475 L357.6,131.475 L357.6,139.875 L345.6,151.875 L98.4,151.875 L98.4,131.475 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="137.4375" style="stroke: #000000; stroke-width: 2.4;" width="888" x="98.4" y="131.475"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="116.4" y="147.1553">Command subscription</text><polygon fill="#A80036" points="457.8,172.5938,469.8,177.3937,457.8,182.1938,462.6,177.3937" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="465" y1="177.3937" y2="177.3937"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="157.8" y="171.3146">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="284.4" x="173.4" y="171.3146">Command subscription / TTD request</text><path d="M273.6,192.9938 L273.6,222.9938 L678,222.9938 L678,204.9938 L666,192.9938 L273.6,192.9938 " fill="#FBFB77" filter="url(#fngzrirs0jsbq)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M666,192.9938 L666,204.9938 L678,204.9938 L666,192.9938 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="379.2" x="280.8" y="213.474">Ensure Command consumer link for tenant exists</text><polygon fill="#A80036" points="898.2,254.5125,910.2,259.3125,898.2,264.1125,903,259.3125" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="484.2" x2="905.4" y1="259.3125" y2="259.3125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="492.6" y="253.2334">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="350.4" x="508.2" y="253.2334">transfer("event/TENANT","4711","ttd=${ttd}")</text><path d="M98.4,285.7125 L325.2,285.7125 L325.2,294.1125 L313.2,306.1125 L98.4,306.1125 L98.4,285.7125 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="208.7156" style="stroke: #000000; stroke-width: 2.4;" width="938.4" x="98.4" y="285.7125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="116.4" y="301.3928">Command handling</text><path d="M812.4,312.2719 L812.4,360.2719 L1020,360.2719 L1020,324.2719 L1008,312.2719 L812.4,312.2719 " fill="#FBFB77" filter="url(#fngzrirs0jsbq)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M1008,312.2719 L1008,324.2719 L1020,324.2719 L1008,312.2719 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="819.6" y="332.7521">Create sender link and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="182.4" x="819.6" y="350.9115">response consumer link</text><polygon fill="#A80036" points="497.4,410.1094,485.4,414.9094,497.4,419.7094,492.6,414.9094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="490.2" x2="911.4" y1="414.9094" y2="414.9094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="504.6" y="399.7506">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="226.8" x="520.2" y="390.6709">transfer("command/TENANT",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="525" y="408.8303">"command/TENANT/4711","${payload}")</text><polygon fill="#A80036" points="162.6,445.0687,150.6,449.8688,162.6,454.6688,157.8,449.8688" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="155.4" x2="471" y1="449.8688" y2="449.8688"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="169.8" y="443.7896">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="249.6" x="185.4" y="443.7896">Command is published to device</text><polygon fill="#A80036" points="898.2,480.0281,910.2,484.8281,898.2,489.6281,903,484.8281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="484.2" x2="905.4" y1="484.8281" y2="484.8281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="492.6" y="478.749">5</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="508.2" y="478.749">disposition("accepted")</text><path d="M98.4,511.2281 L412.8,511.2281 L412.8,519.6281 L400.8,531.6281 L98.4,531.6281 L98.4,511.2281 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="90.4781" style="stroke: #000000; stroke-width: 2.4;" width="888" x="98.4" y="511.2281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="260.4" x="116.4" y="526.9084">Command response handling</text><polygon fill="#A80036" points="457.8,552.3469,469.8,557.1469,457.8,561.9469,462.6,557.1469" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="465" y1="557.1469" y2="557.1469"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="157.8" y="551.0678">6</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="260.4" x="173.4" y="551.0678">Device sends command response</text><polygon fill="#A80036" points="904.2,587.3063,916.2,592.1062,904.2,596.9063,909,592.1062" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="478.2" x2="911.4" y1="592.1062" y2="592.1062"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="486.6" y="586.0271">7</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="384" x="502.2" y="586.0271">transfer("${reply-to}","status=200","${payload}")</text><!--MD5=[e0e07f50b6ca463e3c049d624b0d9900]
+@startuml
+scale 1.2
+
+participant Device order 10
+participant "Hono Protocol Adapter" order 20
+participant Application order 40
+
+autonumber
+
+note over Device
+The device is connected and
+authenticated with TENANT/4711
+end note
+group Command subscription
+    Device -> "Hono Protocol Adapter": Command subscription / TTD request
+    activate "Hono Protocol Adapter"
+    note over "Hono Protocol Adapter"
+    Ensure Command consumer link for tenant exists
+    end note
+    "Hono Protocol Adapter" -> Application: transfer("event/TENANT","4711","ttd=${ttd}")
+    activate Application
+end
+group Command handling
+    note over Application
+    Create sender link and
+    response consumer link
+    end note
+    Application -> "Hono Protocol Adapter": transfer("command/TENANT",\n "command/TENANT/4711","${payload}")
+    "Hono Protocol Adapter" -> Device: Command is published to device
+    "Hono Protocol Adapter" -> Application: disposition("accepted")
+end
+group Command response handling
+    Device -> "Hono Protocol Adapter": Device sends command response
+    "Hono Protocol Adapter" -> Application: transfer("${reply-to}","status=200","${payload}")
+    deactivate "Hono Protocol Adapter"
+    deactivate Application
+end
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.4+11-post-Ubuntu-1ubuntu218.04.3
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/concepts/command-and-control/command_control_concept_amqp.svg b/docs/concepts/command-and-control/command_control_concept_amqp.svg
new file mode 100644
index 0000000..0fb1ce7
--- /dev/null
+++ b/docs/concepts/command-and-control/command_control_concept_amqp.svg
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="663.6px" preserveAspectRatio="none" style="width:1086px;height:663px;" version="1.1" viewBox="0 0 1086 663" width="1086px" zoomAndPan="magnify"><defs><filter height="300%" id="f1dgeg840p9dw" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f1dgeg840p9dw)" height="376.3125" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1015.8" y="218.3531"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="148.8" x2="148.8" y1="45.9563" y2="616.2656"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="582" x2="582" y1="45.9563" y2="616.2656"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1021.2" x2="1021.2" y1="45.9563" y2="616.2656"/><rect fill="#FEFECE" filter="url(#f1dgeg840p9dw)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#f1dgeg840p9dw)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="615.0656"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="639.0598">Device</text><rect fill="#FEFECE" filter="url(#f1dgeg840p9dw)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="135.6" x="512.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="520.8" y="27.5941">AMQP Adapter</text><rect fill="#FEFECE" filter="url(#f1dgeg840p9dw)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="135.6" x="512.4" y="615.0656"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="520.8" y="639.0598">AMQP Adapter</text><rect fill="#FEFECE" filter="url(#f1dgeg840p9dw)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="966" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="974.4" y="27.5941">Application</text><rect fill="#FEFECE" filter="url(#f1dgeg840p9dw)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="966" y="615.0656"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="974.4" y="639.0598">Application</text><rect fill="#FFFFFF" filter="url(#f1dgeg840p9dw)" height="376.3125" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1015.8" y="218.3531"/><path d="M9.6,63.9563 L9.6,111.9563 L285.6,111.9563 L285.6,75.9563 L273.6,63.9563 L9.6,63.9563 " fill="#FBFB77" filter="url(#f1dgeg840p9dw)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M273.6,63.9563 L273.6,75.9563 L285.6,75.9563 L273.6,63.9563 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="217.2" x="16.8" y="84.4365">The device is connected and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="250.8" x="16.8" y="102.5959">authenticated with TENANT/4711</text><polygon fill="#A80036" points="568.2,143.6344,580.2,148.4344,568.2,153.2344,573,148.4344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="575.4" y1="148.4344" y2="148.4344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="253.2" x="157.8" y="142.3553">1. attach("receiver", "command")</text><polygon fill="#A80036" points="162.6,178.5938,150.6,183.3937,162.6,188.1938,157.8,183.3937" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="155.4" x2="581.4" y1="183.3937" y2="183.3937"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="244.8" x="169.8" y="177.3146">2. attach("sender", "command")</text><polygon fill="#A80036" points="1001.4,213.5531,1013.4,218.3531,1001.4,223.1531,1006.2,218.3531" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="582.6" x2="1008.6" y1="218.3531" y2="218.3531"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="334.8" x="591" y="212.274">3. transfer("event/TENANT","4711","ttd=-1")</text><polygon fill="#A80036" points="595.8,248.5125,583.8,253.3125,595.8,258.1125,591,253.3125" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="588.6" x2="1014.6" y1="253.3125" y2="253.3125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="380.4" x="603" y="247.2334">4. transfer("command/TENANT/4711","light","ON")</text><path d="M386.4,268.9125 L386.4,334.9125 L774,334.9125 L774,280.9125 L762,268.9125 L386.4,268.9125 " fill="#FBFB77" filter="url(#f1dgeg840p9dw)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M762,268.9125 L762,280.9125 L774,280.9125 L762,268.9125 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="291.6" x="393.6" y="289.3928">The command message is sent to the</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="303.6" x="393.6" y="307.5521">device with the 'reply-to' property set to</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="362.4" x="393.6" y="325.7115">"command_response/TENANT/4711/${replyId}"</text><polygon fill="#A80036" points="162.6,366.75,150.6,371.55,162.6,376.35,157.8,371.55" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="155.4" x2="581.4" y1="371.55" y2="371.55"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="380.4" x="169.8" y="365.4709">5. transfer("command/TENANT/4711","light","ON")</text><path d="M28.8,387.15 L28.8,453.15 L265.2,453.15 L265.2,399.15 L253.2,387.15 L28.8,387.15 " fill="#FBFB77" filter="url(#f1dgeg840p9dw)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M253.2,387.15 L253.2,399.15 L265.2,399.15 L253.2,387.15 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="192" x="36" y="407.6303">In order to send back the</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="211.2" x="36" y="425.7896">response, the device opens</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="201.6" x="36" y="443.949">an anonymous sender link</text><polygon fill="#A80036" points="568.2,484.9875,580.2,489.7875,568.2,494.5875,573,489.7875" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="575.4" y1="489.7875" y2="489.7875"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="181.2" x="157.8" y="483.7084">6. attach("sender", null)</text><polygon fill="#A80036" points="162.6,519.9469,150.6,524.7469,162.6,529.5469,157.8,524.7469" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="155.4" x2="581.4" y1="524.7469" y2="524.7469"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="189.6" x="169.8" y="518.6678">7. attach("receiver", null)</text><polygon fill="#A80036" points="568.2,554.9063,580.2,559.7063,568.2,564.5063,573,559.7063" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="575.4" y1="559.7063" y2="559.7063"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="404.4" x="157.8" y="553.6271">8. transfer("${reply-to}","status=200","lumen=100")</text><polygon fill="#A80036" points="1007.4,589.8656,1019.4,594.6656,1007.4,599.4656,1012.2,594.6656" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="582.6" x2="1014.6" y1="594.6656" y2="594.6656"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="404.4" x="591" y="588.5865">9. transfer("${reply-to}","status=200","lumen=100")</text><!--
+@startuml
+scale 1.2
+
+participant Device
+participant "AMQP Adapter"
+participant Application
+
+note over Device
+The device is connected and
+authenticated with TENANT/4711
+end note
+Device -> "AMQP Adapter": 1. attach("receiver", "command")
+"AMQP Adapter" -> Device: 2. attach("sender", "command")
+"AMQP Adapter" -> Application: 3. transfer("event/TENANT","4711","ttd=-1")
+activate Application
+Application -> "AMQP Adapter": 4. transfer("command/TENANT/4711","light","ON")
+note over "AMQP Adapter"
+The command message is sent to the
+device with the 'reply-to' property set to
+"command_response/TENANT/4711/${replyId}"
+end note
+"AMQP Adapter" -> Device: 5. transfer("command/TENANT/4711","light","ON")
+note over Device
+In order to send back the
+response, the device opens
+an anonymous sender link
+end note
+Device -> "AMQP Adapter": 6. attach("sender", null)
+"AMQP Adapter" -> Device: 7. attach("receiver", null)
+Device -> "AMQP Adapter": 8. transfer("${reply-to}","status=200","lumen=100")
+"AMQP Adapter" -> Application: 9. transfer("${reply-to}","status=200","lumen=100")
+deactivate Application
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/concepts/command-and-control/command_control_concept_delegate_1.svg b/docs/concepts/command-and-control/command_control_concept_delegate_1.svg
new file mode 100644
index 0000000..a191e61
--- /dev/null
+++ b/docs/concepts/command-and-control/command_control_concept_delegate_1.svg
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="495.6px" preserveAspectRatio="none" style="width:1159px;height:495px;" version="1.1" viewBox="0 0 1159 495" width="1159.2px" zoomAndPan="magnify"><defs><filter height="300%" id="f14y3nnq0zl06i" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="469.7438" style="stroke: #A80036; stroke-width: 1.2;" width="544.8" x="286.8" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="536.4" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="142.2375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="365.4" y="328.7063"/><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1072.2" y="451.7438"/><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="196.7156" style="stroke: #000000; stroke-width: 2.4;" width="1047.6" x="98.4" y="264.6281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="148.8" x2="148.8" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="370.8" x2="370.8" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="542.4" x2="542.4" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="736.8" x2="736.8" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="924" x2="924" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1077.6" x2="1077.6" y1="89.6719" y2="481.7438"/><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="71.3098">Device</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="291.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="300" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="318.6" y="71.3098">instance #1</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="463.2" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="471.6" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="490.2" y="71.3098">instance #2</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="648" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="656.4" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="672" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="838.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="847.2" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="888.6" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1022.4" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1030.8" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="142.2375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="365.4" y="328.7063"/><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1072.2" y="451.7438"/><polygon fill="#A80036" points="910.2,176.7094,922.2,181.5094,910.2,186.3094,915,181.5094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="543" x2="917.4" y1="181.5094" y2="181.5094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="551.4" y="148.1912">0</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="567" y="120.9521">Consumer link on</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="156" x="567" y="139.1115">"command/TENANT"</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="148.8" x="567" y="157.2709">created for another</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="92.4" x="567" y="175.4303">subscription</text><path d="M9.6,197.1094 L9.6,245.1094 L285.6,245.1094 L285.6,209.1094 L273.6,197.1094 L9.6,197.1094 " fill="#FBFB77" filter="url(#f14y3nnq0zl06i)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M273.6,197.1094 L273.6,209.1094 L285.6,209.1094 L273.6,197.1094 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="217.2" x="16.8" y="217.5896">The device is connected and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="250.8" x="16.8" y="235.749">authenticated with TENANT/4711</text><path d="M98.4,264.6281 L357.6,264.6281 L357.6,273.0281 L345.6,285.0281 L98.4,285.0281 L98.4,264.6281 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="196.7156" style="stroke: #000000; stroke-width: 2.4;" width="1047.6" x="98.4" y="264.6281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="116.4" y="280.3084">Command subscription</text><polygon fill="#A80036" points="351,323.9063,363,328.7063,351,333.5062,355.8,328.7063" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="358.2" y1="328.7063" y2="328.7063"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="157.8" y="313.5475">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="173.4" y="304.4678">Command subscription</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="102" x="178.2" y="322.6271">/ TTD request</text><polygon fill="#A80036" points="910.2,358.8656,922.2,363.6656,910.2,368.4656,915,363.6656" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="377.4" x2="917.4" y1="363.6656" y2="363.6656"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="385.8" y="357.5865">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="300" x="401.4" y="357.5865">attach("receiver", "command/TENANT")</text><polygon fill="#A80036" points="723,411.9844,735,416.7844,723,421.5844,727.8,416.7844" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="377.4" x2="730.2" y1="416.7844" y2="416.7844"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="385.8" y="401.6256">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="401.4" y="392.5459">set command handling adapter instance</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="300" x="401.4" y="410.7053">for device 4711 to adapter instance #1</text><polygon fill="#A80036" points="1057.8,446.9437,1069.8,451.7438,1057.8,456.5438,1062.6,451.7438" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="377.4" x2="1065" y1="451.7438" y2="451.7438"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="385.8" y="445.6646">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="585.6" x="401.4" y="445.6646">transfer("event/TENANT","4711","ttd=${ttd}")  via AMQP messaging network</text><!--MD5=[c8b432715fa26176d4dfd933528d308b]
+@startuml
+scale 1.2
+hide footbox
+
+participant Device order 10
+box "Hono"
+    participant "Protocol Adapter\ninstance #1" order 30
+    participant "Protocol Adapter\ninstance #2" order 40
+    participant "Device Connection\nAPI component" order 50
+end box
+participant "AMQP messaging \nnetwork" order 60
+participant Application order 70
+
+autonumber 0
+
+"Protocol Adapter\ninstance #2" -> "AMQP messaging \nnetwork": Consumer link on \n"command/TENANT"\ncreated for another \nsubscription
+
+note over Device
+The device is connected and
+authenticated with TENANT/4711
+end note
+
+group Command subscription
+
+    Device -> "Protocol Adapter\ninstance #1": Command subscription\n / TTD request
+    activate "Protocol Adapter\ninstance #1"
+
+    "Protocol Adapter\ninstance #1" -> "AMQP messaging \nnetwork": attach("receiver", "command/TENANT")
+    "Protocol Adapter\ninstance #1" -> "Device Connection\nAPI component": set command handling adapter instance \nfor device 4711 to adapter instance #1
+
+    "Protocol Adapter\ninstance #1" -> Application: transfer("event/TENANT","4711","ttd=${ttd}")  via AMQP messaging network
+    activate Application
+end
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.4+11-post-Ubuntu-1ubuntu218.04.3
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/concepts/command-and-control/command_control_concept_delegate_2.svg b/docs/concepts/command-and-control/command_control_concept_delegate_2.svg
new file mode 100644
index 0000000..ac27c16
--- /dev/null
+++ b/docs/concepts/command-and-control/command_control_concept_delegate_2.svg
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="643.2px" preserveAspectRatio="none" style="width:1296px;height:643px;" version="1.1" viewBox="0 0 1296 643" width="1296px" zoomAndPan="magnify"><defs><filter height="300%" id="ffihz7kya2wlh" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="617.1" style="stroke: #A80036; stroke-width: 1.2;" width="708" x="201.6" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="532.8" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="159.3563" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="451.8" y="316.7063"/><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="809.4" y="369.825"/><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="996.6" y="476.0625"/><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="498.6281" style="stroke: #000000; stroke-width: 2.4;" width="1267.2" x="15.6" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="66" x2="66" y1="89.6719" y2="629.1"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="285.6" x2="285.6" y1="89.6719" y2="629.1"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="457.2" x2="457.2" y1="89.6719" y2="629.1"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="814.8" x2="814.8" y1="89.6719" y2="629.1"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1002" x2="1002" y1="89.6719" y2="629.1"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1214.4" x2="1214.4" y1="89.6719" y2="629.1"/><rect fill="#FEFECE" filter="url(#ffihz7kya2wlh)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="27.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="36" y="71.3098">Device</text><rect fill="#FEFECE" filter="url(#ffihz7kya2wlh)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="206.4" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="214.8" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="233.4" y="71.3098">instance #1</text><rect fill="#FEFECE" filter="url(#ffihz7kya2wlh)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="378" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="386.4" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="405" y="71.3098">instance #2</text><rect fill="#FEFECE" filter="url(#ffihz7kya2wlh)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="726" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="734.4" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="750" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#ffihz7kya2wlh)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="916.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="925.2" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="966.6" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#ffihz7kya2wlh)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1159.2" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1167.6" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="159.3563" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="451.8" y="316.7063"/><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="809.4" y="369.825"/><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="996.6" y="476.0625"/><path d="M15.6,110.0719 L242.4,110.0719 L242.4,118.4719 L230.4,130.4719 L15.6,130.4719 L15.6,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="498.6281" style="stroke: #000000; stroke-width: 2.4;" width="1267.2" x="15.6" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="33.6" y="125.7521">Command handling</text><polygon fill="#A80036" points="1015.8,187.5094,1003.8,192.3094,1015.8,197.1094,1011,192.3094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1008.6" x2="1213.8" y1="192.3094" y2="192.3094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="1023" y="168.0709">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="1038.6" y="149.9115">attach("receiver",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="168" x="1038.6" y="168.0709">"command_response/</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="1043.4" y="186.2303">TENANT/${replyId}")</text><polygon fill="#A80036" points="1015.8,240.6281,1003.8,245.4281,1015.8,250.2281,1011,245.4281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1008.6" x2="1213.8" y1="245.4281" y2="245.4281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="1023" y="230.2693">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="124.8" x="1038.6" y="221.1896">attach("sender",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="162" x="1038.6" y="239.349">"command/TENANT")</text><polygon fill="#A80036" points="477,311.9063,465,316.7063,477,321.5062,472.2,316.7063" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="469.8" x2="1213.8" y1="316.7063" y2="316.7063"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="484.2" y="292.4678">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="226.8" x="499.8" y="274.3084">transfer("command/TENANT",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="504.6" y="292.4678">"command/TENANT/4711","${payload}")</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="514.2" y="310.6271">via AMQP messaging network</text><polygon fill="#A80036" points="795,365.025,807,369.825,795,374.625,799.8,369.825" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="463.8" x2="802.2" y1="369.825" y2="369.825"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="472.2" y="354.6662">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="242.4" x="487.8" y="345.5865">get command handling adapter</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="195.6" x="487.8" y="363.7459">instances for device 4711</text><polygon fill="#A80036" points="477,418.1438,465,422.9437,477,427.7438,472.2,422.9437" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 2.0,2.0;" x1="469.8" x2="814.2" y1="422.9437" y2="422.9437"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="484.2" y="407.785">5</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="296.4" x="499.8" y="398.7053">JSON containing adapter instance "#1"</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="236.4" x="499.8" y="416.8646">handling commands for "4711"</text><polygon fill="#A80036" points="982.2,471.2625,994.2,476.0625,982.2,480.8625,987,476.0625" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="457.8" x2="989.4" y1="476.0625" y2="476.0625"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="466.2" y="460.9037">6</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="254.4" x="481.8" y="451.824">transfer("command_internal/#1",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="486.6" y="469.9834">"command/TENANT/4711","${payload}")</text><polygon fill="#A80036" points="299.4,524.3813,287.4,529.1813,299.4,533.9812,294.6,529.1813" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="292.2" x2="1001.4" y1="529.1813" y2="529.1813"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="306.6" y="514.0225">7</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="254.4" x="322.2" y="504.9428">transfer("command_internal/#1",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="327" y="523.1021">"command/TENANT/4711","${payload}")</text><polygon fill="#A80036" points="79.8,559.3406,67.8,564.1406,79.8,568.9406,75,564.1406" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="72.6" x2="285" y1="564.1406" y2="564.1406"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="87" y="558.0615">8</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="175.2" x="102.6" y="558.0615">Command is published</text><polygon fill="#A80036" points="1200.6,594.3,1212.6,599.1,1200.6,603.9,1205.4,599.1" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="286.2" x2="1207.8" y1="599.1" y2="599.1"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="294.6" y="593.0209">9</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="411.6" x="310.2" y="593.0209">disposition("accepted")  via AMQP messaging network</text><!--MD5=[3bd9add0052cc62a66bf16f931f011f7]
+@startuml
+scale 1.2
+hide footbox
+
+participant Device order 10
+box "Hono"
+    participant "Protocol Adapter\ninstance #1" order 30
+    participant "Protocol Adapter\ninstance #2" order 40
+    participant "Device Connection\nAPI component" order 50
+end box
+participant "AMQP messaging \nnetwork" order 60
+participant Application order 70
+
+autonumber
+
+group Command handling
+
+    Application -> "AMQP messaging \nnetwork": attach("receiver", \n"command_response/\n TENANT/${replyId}")
+    Application -> "AMQP messaging \nnetwork": attach("sender", \n"command/TENANT")
+
+    Application -> "Protocol Adapter\ninstance #2": transfer("command/TENANT",\n "command/TENANT/4711","${payload}")\n   via AMQP messaging network
+    activate "Protocol Adapter\ninstance #2"
+
+    "Protocol Adapter\ninstance #2" -> "Device Connection\nAPI component": get command handling adapter \ninstances for device 4711
+    activate "Device Connection\nAPI component"
+    return JSON containing adapter instance "#1" \nhandling commands for "4711"
+
+    "Protocol Adapter\ninstance #2" -> "AMQP messaging \nnetwork": transfer("command_internal/#1",\n "command/TENANT/4711","${payload}")
+    deactivate "Protocol Adapter\ninstance #2"
+    activate "AMQP messaging \nnetwork"
+    "AMQP messaging \nnetwork" -> "Protocol Adapter\ninstance #1": transfer("command_internal/#1",\n "command/TENANT/4711","${payload}")
+    deactivate "AMQP messaging \nnetwork"
+
+    "Protocol Adapter\ninstance #1" -> Device: Command is published
+    "Protocol Adapter\ninstance #1" -> Application: disposition("accepted")  via AMQP messaging network
+end
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.4+11-post-Ubuntu-1ubuntu218.04.3
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/concepts/command-and-control/command_control_concept_delegate_3.svg b/docs/concepts/command-and-control/command_control_concept_delegate_3.svg
new file mode 100644
index 0000000..c6d3f17
--- /dev/null
+++ b/docs/concepts/command-and-control/command_control_concept_delegate_3.svg
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="316.8px" preserveAspectRatio="none" style="width:1051px;height:316px;" version="1.1" viewBox="0 0 1051 316" width="1051.2px" zoomAndPan="magnify"><defs><filter height="300%" id="f5wjt7gogzi89" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="299.8219" style="stroke: #A80036; stroke-width: 1.2;" width="340.8" x="237.6" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="385.2" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f5wjt7gogzi89)" height="108.6375" style="stroke: #000000; stroke-width: 2.4;" width="1022.4" x="15.6" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="66" x2="66" y1="89.6719" y2="239.1094"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="321.6" x2="321.6" y1="89.6719" y2="239.1094"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="493.2" x2="493.2" y1="89.6719" y2="239.1094"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="670.8" x2="670.8" y1="89.6719" y2="239.1094"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="969.6" x2="969.6" y1="89.6719" y2="239.1094"/><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="27.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="36" y="71.3098">Device</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="27.6" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="36" y="261.9035">Device</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="242.4" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="250.8" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="276.6" y="71.3098">instance 1</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="242.4" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="250.8" y="261.9035">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="276.6" y="281.4598">instance 1</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="414" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="422.4" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="448.2" y="71.3098">instance 2</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="414" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="422.4" y="261.9035">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="448.2" y="281.4598">instance 2</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="585.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="594" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="635.4" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="585.6" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="594" y="261.9035">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="635.4" y="281.4598">network</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="914.4" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="922.8" y="71.3098">Application</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="914.4" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="922.8" y="261.9035">Application</text><path d="M15.6,110.0719 L330,110.0719 L330,118.4719 L318,130.4719 L15.6,130.4719 L15.6,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="108.6375" style="stroke: #000000; stroke-width: 2.4;" width="1022.4" x="15.6" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="260.4" x="33.6" y="125.7521">Command response handling</text><polygon fill="#A80036" points="307.8,151.1906,319.8,155.9906,307.8,160.7906,312.6,155.9906" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="66.6" x2="315" y1="155.9906" y2="155.9906"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="75" y="149.9115">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="211.2" x="90.6" y="149.9115">Command response is sent</text><polygon fill="#A80036" points="955.8,204.3094,967.8,209.1094,955.8,213.9094,960.6,209.1094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="322.2" x2="963" y1="209.1094" y2="209.1094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="330.6" y="193.9506">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="603.6" x="346.2" y="184.8709">transfer("command_response/TENANT/${replyId}","status=200","${payload}")</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="355.8" y="203.0303">via AMQP messaging network</text><!--MD5=[5e5ec6ad238f39ba1a44ff34d08a44f9]
+@startuml
+scale 1.2
+
+participant Device order 10
+box "Hono"
+    participant "Protocol Adapter\ninstance 1" order 30
+    participant "Protocol Adapter\ninstance 2" order 40
+end box
+participant "AMQP messaging \nnetwork" order 60
+participant Application order 70
+
+autonumber
+
+group Command response handling
+
+    Device -> "Protocol Adapter\ninstance 1": Command response is sent
+    "Protocol Adapter\ninstance 1" -> Application: transfer("command_response/TENANT/${replyId}","status=200","${payload}")\n  via AMQP messaging network
+    deactivate "Protocol Adapter\ninstance 1"
+    deactivate Application
+end
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.4+11-post-Ubuntu-1ubuntu218.04.3
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/concepts/command-and-control/command_control_concept_gateway_1.svg b/docs/concepts/command-and-control/command_control_concept_gateway_1.svg
new file mode 100644
index 0000000..df1dad1
--- /dev/null
+++ b/docs/concepts/command-and-control/command_control_concept_gateway_1.svg
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="578.4px" preserveAspectRatio="none" style="width:1095px;height:578px;" version="1.1" viewBox="0 0 1095 578" width="1095.6px" zoomAndPan="magnify"><defs><filter height="300%" id="fxufgiin6qiiw" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="553.0219" style="stroke: #A80036; stroke-width: 1.2;" width="420" x="294" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="481.2" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#fxufgiin6qiiw)" height="231.675" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="372.6" y="322.5469"/><rect fill="#FFFFFF" filter="url(#fxufgiin6qiiw)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1008.6" y="535.0219"/><rect fill="#FFFFFF" filter="url(#fxufgiin6qiiw)" height="351.2719" style="stroke: #000000; stroke-width: 2.4;" width="1068" x="14.4" y="193.35"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="156" x2="156" y1="89.6719" y2="565.0219"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="378" x2="378" y1="89.6719" y2="565.0219"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="619.2" x2="619.2" y1="89.6719" y2="565.0219"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="806.4" x2="806.4" y1="89.6719" y2="565.0219"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1014" x2="1014" y1="89.6719" y2="565.0219"/><rect fill="#FEFECE" filter="url(#fxufgiin6qiiw)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="110.4" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="118.8" y="71.3098">Gateway</text><rect fill="#FEFECE" filter="url(#fxufgiin6qiiw)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="298.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="307.2" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="325.8" y="71.3098">instance #1</text><rect fill="#FEFECE" filter="url(#fxufgiin6qiiw)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="530.4" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="538.8" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="554.4" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#fxufgiin6qiiw)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="721.2" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="729.6" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="771" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#fxufgiin6qiiw)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="958.8" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="967.2" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#fxufgiin6qiiw)" height="231.675" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="372.6" y="322.5469"/><rect fill="#FFFFFF" filter="url(#fxufgiin6qiiw)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1008.6" y="535.0219"/><path d="M28.8,107.6719 L28.8,173.6719 L279.6,173.6719 L279.6,119.6719 L267.6,107.6719 L28.8,107.6719 " fill="#FBFB77" filter="url(#fxufgiin6qiiw)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M267.6,107.6719 L267.6,119.6719 L279.6,119.6719 L267.6,107.6719 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="160.8" x="36" y="128.1521">The gateway 'gw-1' is</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="36" y="146.3115">connected and authenticated</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="136.8" x="36" y="164.4709">with TENANT/gw-1</text><path d="M14.4,193.35 L273.6,193.35 L273.6,201.75 L261.6,213.75 L14.4,213.75 L14.4,193.35 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="351.2719" style="stroke: #000000; stroke-width: 2.4;" width="1068" x="14.4" y="193.35"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="32.4" y="209.0303">Command subscription</text><path d="M26.4,219.9094 L26.4,267.9094 L280.8,267.9094 L280.8,231.9094 L268.8,219.9094 L26.4,219.9094 " fill="#FBFB77" filter="url(#fxufgiin6qiiw)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M268.8,219.9094 L268.8,231.9094 L280.8,231.9094 L268.8,219.9094 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="182.4" x="33.6" y="240.3896">The gateway subscribes</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="229.2" x="33.6" y="258.549">to commands for device 4711</text><polygon fill="#A80036" points="358.2,317.7469,370.2,322.5469,358.2,327.3469,363,322.5469" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="156.6" x2="365.4" y1="322.5469" y2="322.5469"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="165" y="307.3881">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="180.6" y="298.3084">Command subscription</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="102" x="185.4" y="316.4678">/ TTD request</text><polygon fill="#A80036" points="792.6,352.7063,804.6,357.5062,792.6,362.3063,797.4,357.5062" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="384.6" x2="799.8" y1="357.5062" y2="357.5062"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="393" y="351.4271">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="300" x="408.6" y="351.4271">attach("receiver", "command/TENANT")</text><polygon fill="#A80036" points="605.4,442.1438,617.4,446.9437,605.4,451.7438,610.2,446.9437" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="384.6" x2="612.6" y1="446.9437" y2="446.9437"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="393" y="413.6256">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="408.6" y="386.3865">set command handling</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="129.6" x="408.6" y="404.5459">adapter instance</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="117.6" x="408.6" y="422.7053">for device 4711</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="408.6" y="440.8646">to adapter instance #1</text><polygon fill="#A80036" points="605.4,495.2625,617.4,500.0625,605.4,504.8625,610.2,500.0625" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="384.6" x2="612.6" y1="500.0625" y2="500.0625"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="393" y="484.9037">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="408.6" y="475.824">set last known gateway</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="190.8" x="408.6" y="493.9834">for device 4711 to "gw-1"</text><polygon fill="#A80036" points="994.2,530.2219,1006.2,535.0219,994.2,539.8219,999,535.0219" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="384.6" x2="1001.4" y1="535.0219" y2="535.0219"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="393" y="528.9428">5</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="585.6" x="408.6" y="528.9428">transfer("event/TENANT","4711","ttd=${ttd}")  via AMQP messaging network</text><!--MD5=[c8432a7ae55787c91cc1391650da3925]
+@startuml
+scale 1.2
+hide footbox
+
+participant Gateway order 20
+box "Hono"
+    participant "Protocol Adapter\ninstance #1" order 30
+    participant "Device Connection\nAPI component" order 50
+end box
+participant "AMQP messaging \nnetwork" order 60
+participant Application order 70
+
+autonumber
+
+note over Gateway
+The gateway 'gw-1' is
+connected and authenticated
+with TENANT/gw-1
+end note
+
+group Command subscription
+    note over Gateway
+    The gateway subscribes
+    to commands for device 4711
+    end note
+    Gateway -> "Protocol Adapter\ninstance #1": Command subscription\n / TTD request
+    activate "Protocol Adapter\ninstance #1"
+
+    "Protocol Adapter\ninstance #1" -> "AMQP messaging \nnetwork": attach("receiver", "command/TENANT")
+    "Protocol Adapter\ninstance #1" -> "Device Connection\nAPI component": set command handling \nadapter instance \nfor device 4711 \nto adapter instance #1
+
+    "Protocol Adapter\ninstance #1" -> "Device Connection\nAPI component": set last known gateway \nfor device 4711 to "gw-1"
+    "Protocol Adapter\ninstance #1" -> Application: transfer("event/TENANT","4711","ttd=${ttd}")  via AMQP messaging network
+    activate Application
+end
+
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.4+11-post-Ubuntu-1ubuntu218.04.3
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/concepts/command-and-control/command_control_concept_gateway_2.svg b/docs/concepts/command-and-control/command_control_concept_gateway_2.svg
new file mode 100644
index 0000000..04f0e4e
--- /dev/null
+++ b/docs/concepts/command-and-control/command_control_concept_gateway_2.svg
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="685.2px" preserveAspectRatio="none" style="width:1194px;height:685px;" version="1.1" viewBox="0 0 1194 685" width="1194px" zoomAndPan="magnify"><defs><filter height="300%" id="f160zighuzisgk" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="659.2594" style="stroke: #A80036; stroke-width: 1.2;" width="530.4" x="277.2" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="519.6" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f160zighuzisgk)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="707.4" y="351.6656"/><rect fill="#FFFFFF" filter="url(#f160zighuzisgk)" height="540.7875" style="stroke: #000000; stroke-width: 2.4;" width="1166.4" x="14.4" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="141.6" x2="141.6" y1="89.6719" y2="671.2594"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="361.2" x2="361.2" y1="89.6719" y2="671.2594"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="712.8" x2="712.8" y1="89.6719" y2="671.2594"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="900" x2="900" y1="89.6719" y2="671.2594"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1112.4" x2="1112.4" y1="89.6719" y2="671.2594"/><rect fill="#FEFECE" filter="url(#f160zighuzisgk)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="96" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="104.4" y="71.3098">Gateway</text><rect fill="#FEFECE" filter="url(#f160zighuzisgk)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="282" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="290.4" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="309" y="71.3098">instance #1</text><rect fill="#FEFECE" filter="url(#f160zighuzisgk)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="624" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="632.4" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="648" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f160zighuzisgk)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="814.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="823.2" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="864.6" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f160zighuzisgk)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1057.2" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1065.6" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#f160zighuzisgk)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="707.4" y="351.6656"/><path d="M14.4,110.0719 L241.2,110.0719 L241.2,118.4719 L229.2,130.4719 L14.4,130.4719 L14.4,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="540.7875" style="stroke: #000000; stroke-width: 2.4;" width="1166.4" x="14.4" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="32.4" y="125.7521">Command handling</text><polygon fill="#A80036" points="913.8,187.5094,901.8,192.3094,913.8,197.1094,909,192.3094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="906.6" x2="1111.8" y1="192.3094" y2="192.3094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="921" y="168.0709">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="936.6" y="149.9115">attach("receiver",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="168" x="936.6" y="168.0709">"command_response/</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="941.4" y="186.2303">TENANT/${replyId}")</text><polygon fill="#A80036" points="913.8,240.6281,901.8,245.4281,913.8,250.2281,909,245.4281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="906.6" x2="1111.8" y1="245.4281" y2="245.4281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="921" y="230.2693">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="124.8" x="936.6" y="221.1896">attach("sender",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="162" x="936.6" y="239.349">"command/TENANT")</text><polygon fill="#A80036" points="375,293.7469,363,298.5469,375,303.3469,370.2,298.5469" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="367.8" x2="1111.8" y1="298.5469" y2="298.5469"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="382.2" y="283.3881">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="542.4" x="397.8" y="274.3084">transfer("command/TENANT", "command/TENANT/4711","${payload}")</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="412.2" y="292.4678">via AMQP messaging network</text><polygon fill="#A80036" points="693,346.8656,705,351.6656,693,356.4656,697.8,351.6656" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="361.8" x2="700.2" y1="351.6656" y2="351.6656"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="370.2" y="336.5068">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="242.4" x="385.8" y="327.4271">get command handling adapter</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="195.6" x="385.8" y="345.5865">instances for device 4711</text><polygon fill="#A80036" points="375,399.9844,363,404.7844,375,409.5844,370.2,404.7844" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 2.0,2.0;" x1="367.8" x2="712.2" y1="404.7844" y2="404.7844"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="382.2" y="389.6256">5</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="296.4" x="397.8" y="380.5459">JSON containing adapter instance "#1"</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="236.4" x="397.8" y="398.7053">handling commands for "4711"</text><path d="M220.8,420.3844 L220.8,504.3844 L496.8,504.3844 L496.8,432.3844 L484.8,420.3844 L220.8,420.3844 " fill="#FBFB77" filter="url(#f160zighuzisgk)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M484.8,420.3844 L484.8,432.3844 L496.8,432.3844 L484.8,420.3844 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="248.4" x="228" y="440.8646">Command is already at the right</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="238.8" x="228" y="459.024">adapter instance, gets handled</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="250.8" x="228" y="477.1834">by command handler associated</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="87.6" x="228" y="495.3428">with "gw-1".</text><polygon fill="#A80036" points="155.4,536.3813,143.4,541.1813,155.4,545.9812,150.6,541.1813" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="148.2" x2="360.6" y1="541.1813" y2="541.1813"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="162.6" y="535.1021">6</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="175.2" x="178.2" y="535.1021">Command is published</text><path d="M26.4,556.7813 L26.4,604.7813 L252,604.7813 L252,568.7813 L240,556.7813 L26.4,556.7813 " fill="#FBFB77" filter="url(#f160zighuzisgk)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M240,556.7813 L240,568.7813 L252,568.7813 L240,556.7813 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="33.6" y="577.2615">The gateway sends the</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="200.4" x="33.6" y="595.4209">command to device 4711.</text><polygon fill="#A80036" points="1098.6,636.4594,1110.6,641.2594,1098.6,646.0594,1103.4,641.2594" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="361.8" x2="1105.8" y1="641.2594" y2="641.2594"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="370.2" y="635.1803">7</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="411.6" x="385.8" y="635.1803">disposition("accepted")  via AMQP messaging network</text><!--MD5=[40c7e1303a3221224bab616aecbb0475]
+@startuml
+scale 1.2
+hide footbox
+
+participant Gateway order 20
+box "Hono"
+    participant "Protocol Adapter\ninstance #1" order 30
+    participant "Device Connection\nAPI component" order 50
+end box
+participant "AMQP messaging \nnetwork" order 60
+participant Application order 70
+
+autonumber
+
+group Command handling
+
+    Application -> "AMQP messaging \nnetwork": attach("receiver", \n"command_response/\n TENANT/${replyId}")
+    Application -> "AMQP messaging \nnetwork": attach("sender", \n"command/TENANT")
+
+    Application -> "Protocol Adapter\ninstance #1": transfer("command/TENANT", "command/TENANT/4711","${payload}")\n   via AMQP messaging network
+
+    "Protocol Adapter\ninstance #1" -> "Device Connection\nAPI component": get command handling adapter \ninstances for device 4711
+    activate "Device Connection\nAPI component"
+    return JSON containing adapter instance "#1" \nhandling commands for "4711"
+
+    note over "Protocol Adapter\ninstance #1"
+    Command is already at the right
+    adapter instance, gets handled
+    by command handler associated
+    with "gw-1".
+    end note
+
+    "Protocol Adapter\ninstance #1" -> Gateway: Command is published
+    note over Gateway
+    The gateway sends the
+    command to device 4711.
+    end note
+    "Protocol Adapter\ninstance #1" -> Application: disposition("accepted")  via AMQP messaging network
+end
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.4+11-post-Ubuntu-1ubuntu218.04.3
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/concepts/command-and-control/command_control_concept_gateway_3.svg b/docs/concepts/command-and-control/command_control_concept_gateway_3.svg
new file mode 100644
index 0000000..2a5499e
--- /dev/null
+++ b/docs/concepts/command-and-control/command_control_concept_gateway_3.svg
@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="382.8px" preserveAspectRatio="none" style="width:1046px;height:382px;" version="1.1" viewBox="0 0 1046 382" width="1046.4px" zoomAndPan="magnify"><defs><filter height="300%" id="f1syi2mmgw2dx7" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="364.9406" style="stroke: #A80036; stroke-width: 1.2;" width="360" x="358.8" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="516" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f1syi2mmgw2dx7)" height="173.7563" style="stroke: #000000; stroke-width: 2.4;" width="1018.8" x="14.4" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="187.2" x2="187.2" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="442.8" x2="442.8" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="624" x2="624" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="811.2" x2="811.2" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="964.8" x2="964.8" y1="89.6719" y2="304.2281"/><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="141.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="150" y="71.3098">Gateway</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="141.6" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="150" y="327.0223">Gateway</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="363.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="372" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="397.8" y="71.3098">instance 1</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="363.6" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="372" y="327.0223">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="397.8" y="346.5785">instance 1</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="535.2" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="543.6" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="559.2" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="535.2" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="543.6" y="327.0223">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="559.2" y="346.5785">API component</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="726" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="734.4" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="775.8" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="726" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="734.4" y="327.0223">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="775.8" y="346.5785">network</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="909.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="918" y="71.3098">Application</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="909.6" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="918" y="327.0223">Application</text><path d="M14.4,110.0719 L328.8,110.0719 L328.8,118.4719 L316.8,130.4719 L14.4,130.4719 L14.4,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="173.7563" style="stroke: #000000; stroke-width: 2.4;" width="1018.8" x="14.4" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="260.4" x="32.4" y="125.7521">Command response handling</text><path d="M26.4,136.6313 L26.4,184.6313 L343.2,184.6313 L343.2,148.6313 L331.2,136.6313 L26.4,136.6313 " fill="#FBFB77" filter="url(#f1syi2mmgw2dx7)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M331.2,136.6313 L331.2,148.6313 L343.2,148.6313 L331.2,136.6313 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="194.4" x="33.6" y="157.1115">The gateway receives the</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="291.6" x="33.6" y="175.2709">command response from device 4711</text><polygon fill="#A80036" points="429,216.3094,441,221.1094,429,225.9094,433.8,221.1094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="187.8" x2="436.2" y1="221.1094" y2="221.1094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="196.2" y="215.0303">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="211.2" x="211.8" y="215.0303">Command response is sent</text><polygon fill="#A80036" points="951,269.4281,963,274.2281,951,279.0281,955.8,274.2281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="443.4" x2="958.2" y1="274.2281" y2="274.2281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="451.8" y="259.0693">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="390" x="467.4" y="249.9896">transfer("command_response/TENANT/${replyId}",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="453.6" x="472.2" y="268.149">"status=200","${payload}")   via AMQP messaging network</text><!--MD5=[314ae5857e0e2e146e21c67a08eb6e9b]
+@startuml
+scale 1.2
+
+participant Gateway order 20
+box "Hono"
+    participant "Protocol Adapter\ninstance 1" order 30
+    participant "Device Connection\nAPI component" order 50
+end box
+participant "AMQP messaging \nnetwork" order 60
+participant Application order 70
+
+autonumber
+
+group Command response handling
+    note over Gateway
+    The gateway receives the
+    command response from device 4711
+    end note
+    Gateway -> "Protocol Adapter\ninstance 1": Command response is sent
+    "Protocol Adapter\ninstance 1" -> Application: transfer("command_response/TENANT/${replyId}",\n "status=200","${payload}")   via AMQP messaging network
+    deactivate "Protocol Adapter\ninstance 1"
+    deactivate Application
+end
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.4+11-post-Ubuntu-1ubuntu218.04.3
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/concepts/command-and-control/command_control_concept_gateway_all_devices_1.svg b/docs/concepts/command-and-control/command_control_concept_gateway_all_devices_1.svg
new file mode 100644
index 0000000..d9a2b1a
--- /dev/null
+++ b/docs/concepts/command-and-control/command_control_concept_gateway_all_devices_1.svg
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="543.6px" preserveAspectRatio="none" style="width:1074px;height:543px;" version="1.1" viewBox="0 0 1074 543" width="1074px" zoomAndPan="magnify"><defs><filter height="300%" id="f1jklk7noazmnx" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="518.0625" style="stroke: #A80036; stroke-width: 1.2;" width="410.4" x="274.8" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="457.2" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f1jklk7noazmnx)" height="178.5563" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="353.4" y="340.7063"/><rect fill="#FFFFFF" filter="url(#f1jklk7noazmnx)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="987" y="500.0625"/><rect fill="#FFFFFF" filter="url(#f1jklk7noazmnx)" height="316.3125" style="stroke: #000000; stroke-width: 2.4;" width="1041.6" x="19.2" y="193.35"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="136.8" x2="136.8" y1="89.6719" y2="530.0625"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="358.8" x2="358.8" y1="89.6719" y2="530.0625"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="590.4" x2="590.4" y1="89.6719" y2="530.0625"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="777.6" x2="777.6" y1="89.6719" y2="530.0625"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="992.4" x2="992.4" y1="89.6719" y2="530.0625"/><rect fill="#FEFECE" filter="url(#f1jklk7noazmnx)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="91.2" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="99.6" y="71.3098">Gateway</text><rect fill="#FEFECE" filter="url(#f1jklk7noazmnx)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="279.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="288" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="306.6" y="71.3098">instance #1</text><rect fill="#FEFECE" filter="url(#f1jklk7noazmnx)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="501.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="510" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="525.6" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f1jklk7noazmnx)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="692.4" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="700.8" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="742.2" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f1jklk7noazmnx)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="937.2" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="945.6" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#f1jklk7noazmnx)" height="178.5563" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="353.4" y="340.7063"/><rect fill="#FFFFFF" filter="url(#f1jklk7noazmnx)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="987" y="500.0625"/><path d="M9.6,107.6719 L9.6,173.6719 L260.4,173.6719 L260.4,119.6719 L248.4,107.6719 L9.6,107.6719 " fill="#FBFB77" filter="url(#f1jklk7noazmnx)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M248.4,107.6719 L248.4,119.6719 L260.4,119.6719 L248.4,107.6719 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="160.8" x="16.8" y="128.1521">The gateway 'gw-1' is</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="16.8" y="146.3115">connected and authenticated</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="136.8" x="16.8" y="164.4709">with TENANT/gw-1</text><path d="M19.2,193.35 L278.4,193.35 L278.4,201.75 L266.4,213.75 L19.2,213.75 L19.2,193.35 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="316.3125" style="stroke: #000000; stroke-width: 2.4;" width="1041.6" x="19.2" y="193.35"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="37.2" y="209.0303">Command subscription</text><path d="M31.2,219.9094 L31.2,285.9094 L238.8,285.9094 L238.8,231.9094 L226.8,219.9094 L31.2,219.9094 " fill="#FBFB77" filter="url(#f1jklk7noazmnx)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M226.8,219.9094 L226.8,231.9094 L238.8,231.9094 L226.8,219.9094 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="182.4" x="38.4" y="240.3896">The gateway subscribes</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="38.4" y="258.549">to commands just as a</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="156" x="38.4" y="276.7084">normal device would</text><polygon fill="#A80036" points="339,335.9063,351,340.7063,339,345.5062,343.8,340.7063" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="137.4" x2="346.2" y1="340.7063" y2="340.7063"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="145.8" y="325.5475">0</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="161.4" y="316.4678">Command subscription</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="102" x="166.2" y="334.6271">/ TTD request</text><polygon fill="#A80036" points="763.8,370.8656,775.8,375.6656,763.8,380.4656,768.6,375.6656" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="365.4" x2="771" y1="375.6656" y2="375.6656"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="373.8" y="369.5865">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="300" x="389.4" y="369.5865">attach("receiver", "command/TENANT")</text><polygon fill="#A80036" points="576.6,460.3031,588.6,465.1031,576.6,469.9031,581.4,465.1031" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="365.4" x2="583.8" y1="465.1031" y2="465.1031"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="373.8" y="431.785">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="389.4" y="404.5459">set command handling</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="129.6" x="389.4" y="422.7053">adapter instance</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="122.4" x="389.4" y="440.8646">for device 'gw-1'</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="389.4" y="459.024">to adapter instance #1</text><polygon fill="#A80036" points="972.6,495.2625,984.6,500.0625,972.6,504.8625,977.4,500.0625" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="365.4" x2="979.8" y1="500.0625" y2="500.0625"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="373.8" y="493.9834">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="583.2" x="389.4" y="493.9834">transfer("event/TENANT","gw-1","ttd=${ttd}")  via AMQP messaging network</text><!--MD5=[93e2f9ddcc703299e7ec00e54289c11f]
+@startuml
+scale 1.2
+hide footbox
+
+participant Gateway order 20
+box "Hono"
+    participant "Protocol Adapter\ninstance #1" order 30
+    participant "Device Connection\nAPI component" order 50
+end box
+participant "AMQP messaging \nnetwork" order 60
+participant Application order 70
+
+autonumber 0
+
+note over Gateway
+The gateway 'gw-1' is
+connected and authenticated
+with TENANT/gw-1
+end note
+
+group Command subscription
+    note over Gateway
+    The gateway subscribes
+    to commands just as a
+    normal device would
+    end note
+    Gateway -> "Protocol Adapter\ninstance #1": Command subscription\n / TTD request
+    activate "Protocol Adapter\ninstance #1"
+
+    "Protocol Adapter\ninstance #1" -> "AMQP messaging \nnetwork": attach("receiver", "command/TENANT")
+    "Protocol Adapter\ninstance #1" -> "Device Connection\nAPI component": set command handling \nadapter instance \nfor device 'gw-1' \nto adapter instance #1
+
+    "Protocol Adapter\ninstance #1" -> Application: transfer("event/TENANT","gw-1","ttd=${ttd}")  via AMQP messaging network
+    activate Application
+end
+
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.4+11-post-Ubuntu-1ubuntu218.04.3
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/concepts/command-and-control/command_control_concept_gateway_all_devices_2.svg b/docs/concepts/command-and-control/command_control_concept_gateway_all_devices_2.svg
new file mode 100644
index 0000000..5995a16
--- /dev/null
+++ b/docs/concepts/command-and-control/command_control_concept_gateway_all_devices_2.svg
@@ -0,0 +1,56 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="750px" preserveAspectRatio="none" style="width:1194px;height:750px;" version="1.1" viewBox="0 0 1194 750" width="1194px" zoomAndPan="magnify"><defs><filter height="300%" id="f1h6xgtolsw5l8" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="724.3781" style="stroke: #A80036; stroke-width: 1.2;" width="530.4" x="277.2" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="519.6" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f1h6xgtolsw5l8)" height="136.3969" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="707.4" y="351.6656"/><rect fill="#FFFFFF" filter="url(#f1h6xgtolsw5l8)" height="605.9063" style="stroke: #000000; stroke-width: 2.4;" width="1166.4" x="14.4" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="141.6" x2="141.6" y1="89.6719" y2="736.3781"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="361.2" x2="361.2" y1="89.6719" y2="736.3781"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="712.8" x2="712.8" y1="89.6719" y2="736.3781"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="900" x2="900" y1="89.6719" y2="736.3781"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1112.4" x2="1112.4" y1="89.6719" y2="736.3781"/><rect fill="#FEFECE" filter="url(#f1h6xgtolsw5l8)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="96" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="104.4" y="71.3098">Gateway</text><rect fill="#FEFECE" filter="url(#f1h6xgtolsw5l8)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="282" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="290.4" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="309" y="71.3098">instance #1</text><rect fill="#FEFECE" filter="url(#f1h6xgtolsw5l8)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="624" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="632.4" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="648" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f1h6xgtolsw5l8)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="814.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="823.2" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="864.6" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f1h6xgtolsw5l8)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1057.2" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1065.6" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#f1h6xgtolsw5l8)" height="136.3969" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="707.4" y="351.6656"/><path d="M14.4,110.0719 L241.2,110.0719 L241.2,118.4719 L229.2,130.4719 L14.4,130.4719 L14.4,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="605.9063" style="stroke: #000000; stroke-width: 2.4;" width="1166.4" x="14.4" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="32.4" y="125.7521">Command handling</text><polygon fill="#A80036" points="913.8,187.5094,901.8,192.3094,913.8,197.1094,909,192.3094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="906.6" x2="1111.8" y1="192.3094" y2="192.3094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="921" y="168.0709">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="936.6" y="149.9115">attach("receiver",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="168" x="936.6" y="168.0709">"command_response/</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="941.4" y="186.2303">TENANT/${replyId}")</text><polygon fill="#A80036" points="913.8,240.6281,901.8,245.4281,913.8,250.2281,909,245.4281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="906.6" x2="1111.8" y1="245.4281" y2="245.4281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="921" y="230.2693">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="124.8" x="936.6" y="221.1896">attach("sender",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="162" x="936.6" y="239.349">"command/TENANT")</text><polygon fill="#A80036" points="375,293.7469,363,298.5469,375,303.3469,370.2,298.5469" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="367.8" x2="1111.8" y1="298.5469" y2="298.5469"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="382.2" y="283.3881">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="542.4" x="397.8" y="274.3084">transfer("command/TENANT", "command/TENANT/4711","${payload}")</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="412.2" y="292.4678">via AMQP messaging network</text><polygon fill="#A80036" points="693,346.8656,705,351.6656,693,356.4656,697.8,351.6656" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="361.8" x2="700.2" y1="351.6656" y2="351.6656"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="370.2" y="336.5068">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="242.4" x="385.8" y="327.4271">get command handling adapter</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="195.6" x="385.8" y="345.5865">instances for device 4711</text><path d="M507.6,367.2656 L507.6,433.2656 L913.2,433.2656 L913.2,379.2656 L901.2,367.2656 L507.6,367.2656 " fill="#FBFB77" filter="url(#f1h6xgtolsw5l8)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M901.2,367.2656 L901.2,379.2656 L913.2,379.2656 L901.2,367.2656 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="380.4" x="514.8" y="387.7459">No adapter instance associated with device 4711,</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="294" x="514.8" y="405.9053">therefore check the gateways of 4711,</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="265.2" x="514.8" y="424.0646">preferably the last known gateway.</text><polygon fill="#A80036" points="375,483.2625,363,488.0625,375,492.8625,370.2,488.0625" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 2.0,2.0;" x1="367.8" x2="712.2" y1="488.0625" y2="488.0625"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="382.2" y="472.9037">5</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="296.4" x="397.8" y="463.824">JSON containing adapter instance "#1"</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="234" x="397.8" y="481.9834">handling commands for "gw-1"</text><path d="M222,503.6625 L222,569.6625 L495.6,569.6625 L495.6,515.6625 L483.6,503.6625 L222,503.6625 " fill="#FBFB77" filter="url(#f1h6xgtolsw5l8)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M483.6,503.6625 L483.6,515.6625 L495.6,515.6625 L483.6,503.6625 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="248.4" x="229.2" y="524.1428">Command is already at the right</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="238.8" x="229.2" y="542.3021">adapter instance, gets handled</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="246" x="229.2" y="560.4615">by command handler for "gw-1".</text><polygon fill="#A80036" points="155.4,601.5,143.4,606.3,155.4,611.1,150.6,606.3" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="148.2" x2="360.6" y1="606.3" y2="606.3"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="162.6" y="600.2209">6</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="175.2" x="178.2" y="600.2209">Command is published</text><path d="M26.4,621.9 L26.4,669.9 L252,669.9 L252,633.9 L240,621.9 L26.4,621.9 " fill="#FBFB77" filter="url(#f1h6xgtolsw5l8)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M240,621.9 L240,633.9 L252,633.9 L240,621.9 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="33.6" y="642.3803">The gateway sends the</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="200.4" x="33.6" y="660.5396">command to device 4711.</text><polygon fill="#A80036" points="1098.6,701.5781,1110.6,706.3781,1098.6,711.1781,1103.4,706.3781" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="361.8" x2="1105.8" y1="706.3781" y2="706.3781"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="370.2" y="700.299">7</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="411.6" x="385.8" y="700.299">disposition("accepted")  via AMQP messaging network</text><!--MD5=[60c34d2770f1fbce83cf895feefca606]
+@startuml
+scale 1.2
+hide footbox
+
+participant Gateway order 20
+box "Hono"
+    participant "Protocol Adapter\ninstance #1" order 30
+    participant "Device Connection\nAPI component" order 50
+end box
+participant "AMQP messaging \nnetwork" order 60
+participant Application order 70
+
+autonumber
+
+group Command handling
+
+    Application -> "AMQP messaging \nnetwork": attach("receiver", \n"command_response/\n TENANT/${replyId}")
+    Application -> "AMQP messaging \nnetwork": attach("sender", \n"command/TENANT")
+
+    Application -> "Protocol Adapter\ninstance #1": transfer("command/TENANT", "command/TENANT/4711","${payload}")\n   via AMQP messaging network
+
+    "Protocol Adapter\ninstance #1" -> "Device Connection\nAPI component": get command handling adapter \ninstances for device 4711
+    activate "Device Connection\nAPI component"
+    note over "Device Connection\nAPI component"
+    No adapter instance associated with device 4711,
+    therefore check the gateways of 4711,
+    preferably the last known gateway.
+    end note
+    return JSON containing adapter instance "#1" \nhandling commands for "gw-1"
+
+    note over "Protocol Adapter\ninstance #1"
+    Command is already at the right
+    adapter instance, gets handled
+    by command handler for "gw-1".
+    end note
+
+    "Protocol Adapter\ninstance #1" -> Gateway: Command is published
+    note over Gateway
+    The gateway sends the
+    command to device 4711.
+    end note
+    "Protocol Adapter\ninstance #1" -> Application: disposition("accepted")  via AMQP messaging network
+end
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
+(GPL source distribution)
+Java Runtime: OpenJDK Runtime Environment
+JVM: OpenJDK 64-Bit Server VM
+Java Version: 11.0.4+11-post-Ubuntu-1ubuntu218.04.3
+Operating System: Linux
+Default Encoding: UTF-8
+Language: de
+Country: DE
+--></g></svg>
\ No newline at end of file
diff --git a/docs/concepts/command-and-control/command_control_concept_http.svg b/docs/concepts/command-and-control/command_control_concept_http.svg
new file mode 100644
index 0000000..4584ba5
--- /dev/null
+++ b/docs/concepts/command-and-control/command_control_concept_http.svg
@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="478.8px" preserveAspectRatio="none" style="width:1600px;height:478px;" version="1.1" viewBox="0 0 1600 478" width="1600.8px" zoomAndPan="magnify"><defs><filter height="300%" id="fo1zb0wqg7eoa" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#fo1zb0wqg7eoa)" height="139.8375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="822.6" y="83.3156"/><rect fill="#FFFFFF" filter="url(#fo1zb0wqg7eoa)" height="104.8781" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="822.6" y="305.0719"/><rect fill="#FFFFFF" filter="url(#fo1zb0wqg7eoa)" height="256.7156" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1530.6" y="118.275"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="169.2" x2="169.2" y1="45.9563" y2="431.55"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="828" x2="828" y1="45.9563" y2="431.55"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1536" x2="1536" y1="45.9563" y2="431.55"/><rect fill="#FEFECE" filter="url(#fo1zb0wqg7eoa)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="130.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="139.2" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#fo1zb0wqg7eoa)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="130.8" y="430.35"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="139.2" y="454.3441">Device</text><rect fill="#FEFECE" filter="url(#fo1zb0wqg7eoa)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="130.8" x="760.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="114" x="769.2" y="27.5941">HTTP Adapter</text><rect fill="#FEFECE" filter="url(#fo1zb0wqg7eoa)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="130.8" x="760.8" y="430.35"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="114" x="769.2" y="454.3441">HTTP Adapter</text><rect fill="#FEFECE" filter="url(#fo1zb0wqg7eoa)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1480.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1489.2" y="27.5941">Application</text><rect fill="#FEFECE" filter="url(#fo1zb0wqg7eoa)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1480.8" y="430.35"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1489.2" y="454.3441">Application</text><rect fill="#FFFFFF" filter="url(#fo1zb0wqg7eoa)" height="139.8375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="822.6" y="83.3156"/><rect fill="#FFFFFF" filter="url(#fo1zb0wqg7eoa)" height="104.8781" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="822.6" y="305.0719"/><rect fill="#FFFFFF" filter="url(#fo1zb0wqg7eoa)" height="256.7156" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1530.6" y="118.275"/><polygon fill="#A80036" points="808.2,78.5156,820.2,83.3156,808.2,88.1156,813,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="169.8" x2="815.4" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="380.4" x="178.2" y="77.2365">1. HTTP request ("POST", "/event", "hono-ttd=30")</text><polygon fill="#A80036" points="1516.2,113.475,1528.2,118.275,1516.2,123.075,1521,118.275" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="834.6" x2="1523.4" y1="118.275" y2="118.275"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="338.4" x="843" y="112.1959">2. transfer("event/TENANT","4711","ttd=30")</text><polygon fill="#A80036" points="847.8,148.4344,835.8,153.2344,847.8,158.0344,843,153.2344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="840.6" x2="1529.4" y1="153.2344" y2="153.2344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="380.4" x="855" y="147.1553">3. transfer("command/TENANT/4711","light","ON")</text><polygon fill="#A80036" points="183,183.3937,171,188.1938,183,192.9938,178.2,188.1938" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="175.8" x2="821.4" y1="188.1938" y2="188.1938"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="624" x="190.2" y="182.1146">4. HTTP response (("200", "hono-cmd=light", "hono-cmd-req-id=${reqId}"), "ON")</text><polygon fill="#A80036" points="1516.2,218.3531,1528.2,223.1531,1516.2,227.9531,1521,223.1531" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="828.6" x2="1523.4" y1="223.1531" y2="223.1531"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="837" y="217.074">disposition("accepted")</text><path d="M9.6,238.7531 L9.6,268.7531 L325.2,268.7531 L325.2,250.7531 L313.2,238.7531 L9.6,238.7531 " fill="#FBFB77" filter="url(#fo1zb0wqg7eoa)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M313.2,238.7531 L313.2,250.7531 L325.2,250.7531 L313.2,238.7531 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="290.4" x="16.8" y="259.2334">Command response in next operation</text><polygon fill="#A80036" points="808.2,300.2719,820.2,305.0719,808.2,309.8719,813,305.0719" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="169.8" x2="815.4" y1="305.0719" y2="305.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="536.4" x="178.2" y="298.9928">5. HTTP request("POST", "/command/res/${reqId}/200", "lumen=100")</text><polygon fill="#A80036" points="1516.2,335.2313,1528.2,340.0313,1516.2,344.8313,1521,340.0313" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="834.6" x2="1523.4" y1="340.0313" y2="340.0313"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="667.2" x="843" y="333.9521">6. transfer("command_response/TENANT/4711/${replyId}","status=200","lumen=100")</text><polygon fill="#A80036" points="847.8,370.1906,835.8,374.9906,847.8,379.7906,843,374.9906" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="840.6" x2="1535.4" y1="374.9906" y2="374.9906"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="855" y="368.9115">disposition("accepted")</text><polygon fill="#A80036" points="183,405.15,171,409.95,183,414.75,178.2,409.95" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="175.8" x2="827.4" y1="409.95" y2="409.95"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="190.8" x="190.2" y="403.8709">7. HTTP response ("202")</text><!--
+@startuml
+scale 1.2
+
+participant Device
+participant "HTTP Adapter"
+participant Application
+
+Device -> "HTTP Adapter": 1. HTTP request ("POST", "/event", "hono-ttd=30")
+activate "HTTP Adapter"
+"HTTP Adapter" -> Application: 2. transfer("event/TENANT","4711","ttd=30")
+activate Application
+Application -> "HTTP Adapter": 3. transfer("command/TENANT/4711","light","ON")
+"HTTP Adapter" -> Device: 4. HTTP response (("200", "hono-cmd=light", "hono-cmd-req-id=${reqId}"), "ON")
+"HTTP Adapter" -> Application: disposition("accepted")
+deactivate "HTTP Adapter"
+note over Device
+Command response in next operation
+end note
+Device -> "HTTP Adapter": 5. HTTP request("POST", "/command/res/${reqId}/200", "lumen=100")
+activate "HTTP Adapter"
+"HTTP Adapter" -> Application: 6. transfer("command_response/TENANT/4711/${replyId}","status=200","lumen=100")
+Application -> "HTTP Adapter": disposition("accepted")
+deactivate Application
+"HTTP Adapter" -> Device: 7. HTTP response ("202")
+deactivate "HTTP Adapter"
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/concepts/command-and-control/command_control_concept_mqtt.svg b/docs/concepts/command-and-control/command_control_concept_mqtt.svg
new file mode 100644
index 0000000..f8540e6
--- /dev/null
+++ b/docs/concepts/command-and-control/command_control_concept_mqtt.svg
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="427.2px" preserveAspectRatio="none" style="width:1400px;height:427px;" version="1.1" viewBox="0 0 1400 427" width="1400.4px" zoomAndPan="magnify"><defs><filter height="300%" id="fv63cmfv2nt78" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#fv63cmfv2nt78)" height="209.7563" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="622.2" y="148.4344"/><rect fill="#FFFFFF" filter="url(#fv63cmfv2nt78)" height="174.7969" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1330.2" y="183.3937"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="148.8" x2="148.8" y1="45.9563" y2="379.7906"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="627.6" x2="627.6" y1="45.9563" y2="379.7906"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1335.6" x2="1335.6" y1="45.9563" y2="379.7906"/><rect fill="#FEFECE" filter="url(#fv63cmfv2nt78)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#fv63cmfv2nt78)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="378.5906"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="402.5848">Device</text><rect fill="#FEFECE" filter="url(#fv63cmfv2nt78)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="135.6" x="558" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="566.4" y="27.5941">MQTT Adapter</text><rect fill="#FEFECE" filter="url(#fv63cmfv2nt78)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="135.6" x="558" y="378.5906"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="566.4" y="402.5848">MQTT Adapter</text><rect fill="#FEFECE" filter="url(#fv63cmfv2nt78)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1280.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1288.8" y="27.5941">Application</text><rect fill="#FEFECE" filter="url(#fv63cmfv2nt78)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1280.4" y="378.5906"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1288.8" y="402.5848">Application</text><rect fill="#FFFFFF" filter="url(#fv63cmfv2nt78)" height="209.7563" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="622.2" y="148.4344"/><rect fill="#FFFFFF" filter="url(#fv63cmfv2nt78)" height="174.7969" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1330.2" y="183.3937"/><path d="M9.6,63.9563 L9.6,111.9563 L285.6,111.9563 L285.6,75.9563 L273.6,63.9563 L9.6,63.9563 " fill="#FBFB77" filter="url(#fv63cmfv2nt78)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M273.6,63.9563 L273.6,75.9563 L285.6,75.9563 L273.6,63.9563 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="217.2" x="16.8" y="84.4365">The device is connected and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="250.8" x="16.8" y="102.5959">authenticated with TENANT/4711</text><polygon fill="#A80036" points="607.8,143.6344,619.8,148.4344,607.8,153.2344,612.6,148.4344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="615" y1="148.4344" y2="148.4344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="267.6" x="157.8" y="142.3553">1. SUBSCRIBE("command///req/#")</text><polygon fill="#A80036" points="1315.8,178.5938,1327.8,183.3937,1315.8,188.1938,1320.6,183.3937" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="634.2" x2="1323" y1="183.3937" y2="183.3937"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="334.8" x="642.6" y="177.3146">2. transfer("event/TENANT","4711","ttd=-1")</text><polygon fill="#A80036" points="647.4,213.5531,635.4,218.3531,647.4,223.1531,642.6,218.3531" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="640.2" x2="1329" y1="218.3531" y2="218.3531"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="380.4" x="654.6" y="212.274">3. transfer("command/TENANT/4711","light","ON")</text><polygon fill="#A80036" points="162.6,248.5125,150.6,253.3125,162.6,258.1125,157.8,253.3125" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="155.4" x2="621" y1="253.3125" y2="253.3125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="382.8" x="169.8" y="247.2334">4. PUBLISH("command///req/${reqId}/light", "ON")</text><polygon fill="#A80036" points="1315.8,283.4719,1327.8,288.2719,1315.8,293.0719,1320.6,288.2719" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="634.2" x2="1323" y1="288.2719" y2="288.2719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="642.6" y="282.1928">disposition("accepted")</text><polygon fill="#A80036" points="607.8,318.4313,619.8,323.2313,607.8,328.0313,612.6,323.2313" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="615" y1="323.2313" y2="323.2313"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="444" x="157.8" y="317.1521">5. PUBLISH("command///res/${reqId}/200", "lumen=100")</text><polygon fill="#A80036" points="1321.8,353.3906,1333.8,358.1906,1321.8,362.9906,1326.6,358.1906" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="628.2" x2="1329" y1="358.1906" y2="358.1906"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="667.2" x="636.6" y="352.1115">6. transfer("command_response/TENANT/4711/${replyId}","status=200","lumen=100")</text><!--MD5=[130e2d2ad51dc80d7f83df15b0506eb0]
+@startuml
+scale 1.2
+
+participant Device
+participant "MQTT Adapter"
+participant Application
+
+note over Device
+The device is connected and
+authenticated with TENANT/4711
+end note
+Device -> "MQTT Adapter": 1. SUBSCRIBE("command///req/#")
+activate "MQTT Adapter"
+"MQTT Adapter" -> Application: 2. transfer("event/TENANT","4711","ttd=-1")
+activate Application
+Application -> "MQTT Adapter": 3. transfer("command/TENANT/4711","light","ON")
+"MQTT Adapter" -> Device: 4. PUBLISH("command///req/${reqId}/light", "ON")
+"MQTT Adapter" -> Application: disposition("accepted")
+Device -> "MQTT Adapter": 5. PUBLISH("command///res/${reqId}/200", "lumen=100")
+"MQTT Adapter" -> Application: 6. transfer("command_response/TENANT/4711/${replyId}","status=200","lumen=100")
+deactivate "MQTT Adapter"
+deactivate Application
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 10:02:15 UTC 2019)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
diff --git a/docs/concepts/command-and-control/command_control_concept_one_way_http.svg b/docs/concepts/command-and-control/command_control_concept_one_way_http.svg
new file mode 100644
index 0000000..89f36d9
--- /dev/null
+++ b/docs/concepts/command-and-control/command_control_concept_one_way_http.svg
@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="339.6px" preserveAspectRatio="none" style="width:1089px;height:339px;" version="1.1" viewBox="0 0 1089 339" width="1089.6px" zoomAndPan="magnify"><defs><filter height="300%" id="f19vdhjwihf8vo" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f19vdhjwihf8vo)" height="139.8375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="598.2" y="83.3156"/><rect fill="#FFFFFF" filter="url(#f19vdhjwihf8vo)" height="162.6375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1019.4" y="118.275"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="175.2" x2="175.2" y1="45.9563" y2="291.7125"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="603.6" x2="603.6" y1="45.9563" y2="291.7125"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1024.8" x2="1024.8" y1="45.9563" y2="291.7125"/><rect fill="#FEFECE" filter="url(#f19vdhjwihf8vo)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="136.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="145.2" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#f19vdhjwihf8vo)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="136.8" y="290.5125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="145.2" y="314.5066">Device</text><rect fill="#FEFECE" filter="url(#f19vdhjwihf8vo)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="130.8" x="536.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="114" x="544.8" y="27.5941">HTTP Adapter</text><rect fill="#FEFECE" filter="url(#f19vdhjwihf8vo)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="130.8" x="536.4" y="290.5125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="114" x="544.8" y="314.5066">HTTP Adapter</text><rect fill="#FEFECE" filter="url(#f19vdhjwihf8vo)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="969.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="978" y="27.5941">Application</text><rect fill="#FEFECE" filter="url(#f19vdhjwihf8vo)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="969.6" y="290.5125"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="978" y="314.5066">Application</text><rect fill="#FFFFFF" filter="url(#f19vdhjwihf8vo)" height="139.8375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="598.2" y="83.3156"/><rect fill="#FFFFFF" filter="url(#f19vdhjwihf8vo)" height="162.6375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1019.4" y="118.275"/><polygon fill="#A80036" points="583.8,78.5156,595.8,83.3156,583.8,88.1156,588.6,83.3156" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="175.8" x2="591" y1="83.3156" y2="83.3156"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="380.4" x="184.2" y="77.2365">1. HTTP request ("POST", "/event", "hono-ttd=30")</text><polygon fill="#A80036" points="1005,113.475,1017,118.275,1005,123.075,1009.8,118.275" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="610.2" x2="1012.2" y1="118.275" y2="118.275"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="338.4" x="618.6" y="112.1959">2. transfer("event/TENANT","4711","ttd=30")</text><polygon fill="#A80036" points="623.4,148.4344,611.4,153.2344,623.4,158.0344,618.6,153.2344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="616.2" x2="1018.2" y1="153.2344" y2="153.2344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="380.4" x="630.6" y="147.1553">3. transfer("command/TENANT/4711","light","ON")</text><polygon fill="#A80036" points="189,183.3937,177,188.1938,189,192.9938,184.2,188.1938" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="181.8" x2="597" y1="188.1938" y2="188.1938"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="393.6" x="196.2" y="182.1146">4. HTTP response (("200", "hono-cmd=light"), "ON")</text><polygon fill="#A80036" points="1005,218.3531,1017,223.1531,1005,227.9531,1009.8,223.1531" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="604.2" x2="1012.2" y1="223.1531" y2="223.1531"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="612.6" y="217.074">disposition("accepted")</text><path d="M9.6,238.7531 L9.6,268.7531 L337.2,268.7531 L337.2,250.7531 L325.2,238.7531 L9.6,238.7531 " fill="#FBFB77" filter="url(#f19vdhjwihf8vo)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M325.2,238.7531 L325.2,250.7531 L337.2,250.7531 L325.2,238.7531 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="302.4" x="16.8" y="259.2334">No response expected from the device.</text><!--
+@startuml
+scale 1.2
+
+participant Device
+participant "HTTP Adapter"
+participant Application
+
+Device -> "HTTP Adapter": 1. HTTP request ("POST", "/event", "hono-ttd=30")
+activate "HTTP Adapter"
+"HTTP Adapter" -> Application: 2. transfer("event/TENANT","4711","ttd=30")
+activate Application
+Application -> "HTTP Adapter": 3. transfer("command/TENANT/4711","light","ON")
+"HTTP Adapter" -> Device: 4. HTTP response (("200", "hono-cmd=light"), "ON")
+"HTTP Adapter" -> Application: disposition("accepted")
+deactivate "HTTP Adapter"
+note over Device
+No response expected from the device.
+end note
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/concepts/command-and-control/command_control_concept_one_way_mqtt.svg b/docs/concepts/command-and-control/command_control_concept_one_way_mqtt.svg
new file mode 100644
index 0000000..a53ea56
--- /dev/null
+++ b/docs/concepts/command-and-control/command_control_concept_one_way_mqtt.svg
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="357.6px" preserveAspectRatio="none" style="width:966px;height:357px;" version="1.1" viewBox="0 0 966 357" width="966px" zoomAndPan="magnify"><defs><filter height="300%" id="f19t5uq8ddfn8" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f19t5uq8ddfn8)" height="139.8375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="474.6" y="148.4344"/><rect fill="#FFFFFF" filter="url(#f19t5uq8ddfn8)" height="104.8781" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="895.8" y="183.3937"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="148.8" x2="148.8" y1="45.9563" y2="309.8719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="480" x2="480" y1="45.9563" y2="309.8719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="901.2" x2="901.2" y1="45.9563" y2="309.8719"/><rect fill="#FEFECE" filter="url(#f19t5uq8ddfn8)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#f19t5uq8ddfn8)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="308.6719"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="332.666">Device</text><rect fill="#FEFECE" filter="url(#f19t5uq8ddfn8)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="135.6" x="410.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="418.8" y="27.5941">MQTT Adapter</text><rect fill="#FEFECE" filter="url(#f19t5uq8ddfn8)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="135.6" x="410.4" y="308.6719"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="118.8" x="418.8" y="332.666">MQTT Adapter</text><rect fill="#FEFECE" filter="url(#f19t5uq8ddfn8)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="846" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="854.4" y="27.5941">Application</text><rect fill="#FEFECE" filter="url(#f19t5uq8ddfn8)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="846" y="308.6719"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="854.4" y="332.666">Application</text><rect fill="#FFFFFF" filter="url(#f19t5uq8ddfn8)" height="139.8375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="474.6" y="148.4344"/><rect fill="#FFFFFF" filter="url(#f19t5uq8ddfn8)" height="104.8781" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="895.8" y="183.3937"/><path d="M9.6,63.9563 L9.6,111.9563 L285.6,111.9563 L285.6,75.9563 L273.6,63.9563 L9.6,63.9563 " fill="#FBFB77" filter="url(#f19t5uq8ddfn8)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M273.6,63.9563 L273.6,75.9563 L285.6,75.9563 L273.6,63.9563 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="217.2" x="16.8" y="84.4365">The device is connected and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="250.8" x="16.8" y="102.5959">authenticated with TENANT/4711</text><polygon fill="#A80036" points="460.2,143.6344,472.2,148.4344,460.2,153.2344,465,148.4344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="467.4" y1="148.4344" y2="148.4344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="267.6" x="157.8" y="142.3553">1. SUBSCRIBE("command///req/#")</text><polygon fill="#A80036" points="881.4,178.5938,893.4,183.3937,881.4,188.1938,886.2,183.3937" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="486.6" x2="888.6" y1="183.3937" y2="183.3937"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="334.8" x="495" y="177.3146">2. transfer("event/TENANT","4711","ttd=-1")</text><polygon fill="#A80036" points="499.8,213.5531,487.8,218.3531,499.8,223.1531,495,218.3531" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="492.6" x2="894.6" y1="218.3531" y2="218.3531"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="380.4" x="507" y="212.274">3. transfer("command/TENANT/4711","light","ON")</text><polygon fill="#A80036" points="162.6,248.5125,150.6,253.3125,162.6,258.1125,157.8,253.3125" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="155.4" x2="473.4" y1="253.3125" y2="253.3125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="169.8" y="247.2334">4. PUBLISH("command</text><text fill="#000000" font-family="sans-serif" font-size="15.6" font-style="italic" lengthAdjust="spacingAndGlyphs" textLength="30" x="346.2" y="247.2334">/req</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="90" x="376.2" y="247.2334">light", "ON")</text><polygon fill="#A80036" points="887.4,283.4719,899.4,288.2719,887.4,293.0719,892.2,288.2719" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="480.6" x2="894.6" y1="288.2719" y2="288.2719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="489" y="282.1928">disposition("accepted")</text><!--MD5=[7651b2573c32d1b0c97f09ff206baf24]
+@startuml
+scale 1.2
+
+participant Device
+participant "MQTT Adapter"
+participant Application
+
+note over Device
+The device is connected and
+authenticated with TENANT/4711
+end note
+Device -> "MQTT Adapter": 1. SUBSCRIBE("command///req/#")
+activate "MQTT Adapter"
+"MQTT Adapter" -> Application: 2. transfer("event/TENANT","4711","ttd=-1")
+activate Application
+Application -> "MQTT Adapter": 3. transfer("command/TENANT/4711","light","ON")
+"MQTT Adapter" -> Device: 4. PUBLISH("command///req//light", "ON")
+"MQTT Adapter" -> Application: disposition("accepted")
+deactivate "MQTT Adapter"
+deactivate Application
+@enduml
+
+PlantUML version 1.2019.11(Sun Sep 22 10:02:15 UTC 2019)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
diff --git a/docs/concepts/command-and-control/index.html b/docs/concepts/command-and-control/index.html
index 4ca5dcb..d1d98fc 100644
--- a/docs/concepts/command-and-control/index.html
+++ b/docs/concepts/command-and-control/index.html
@@ -21,19 +21,19 @@
     <title>Command & Control :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,7 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/command-and-control/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/command-and-control/" selected>stable (1.3)</option>
                     
                   
               
@@ -1287,24 +1344,14 @@
               
                   
               
+                  
+              
           
               
               
                   
               
                   
-                    
-                    
-                      <option id="1.1" value="/hono/docs/1.1/concepts/command-and-control/">1.1</option>
-                    
-                  
-              
-                  
-              
-                  
-              
-          
-              
               
                   
               
@@ -1313,12 +1360,10 @@
                   
                     
                     
-                      <option id="1.0" value="/hono/docs/1.0/concepts/command-and-control/">1.0</option>
+                      <option id="dev" value="/hono/docs/dev/concepts/command-and-control/">dev</option>
                     
                   
               
-                  
-              
           
         </select>
         <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
@@ -1381,7 +1426,7 @@
                   
                   
                   <div id="top-github-link">
-                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/concepts/command-and-control.md" target="blank">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/concepts/command-and-control/index.md" target="blank">
                       <i class="fas fa-code-branch"></i>
                       <span id="top-github-link-text">Edit this page</span>
                     </a>
@@ -1474,7 +1519,7 @@
 <p>The application and the adapter connect to the AMQP Network, which forwards the transfer - for clarity this is not shown in the diagram below.</p>
 
 <figure>
-    <img src="../command_control_concept.svg"/> <figcaption>
+    <img src="command_control_concept.svg"/> <figcaption>
             <h4>Request/Response Command overview</h4>
         </figcaption>
 </figure>
@@ -1517,7 +1562,7 @@
 <p>The following diagrams show the message flow if the command message is first received on a protocol adapter instance that the target device is <em>not</em> connected to.</p>
 
 <figure>
-    <img src="../command_control_concept_delegate_1.svg"/> <figcaption>
+    <img src="command_control_concept_delegate_1.svg"/> <figcaption>
             <h4>Command subscription</h4>
         </figcaption>
 </figure>
@@ -1528,7 +1573,7 @@
 <p>The device subscribes for commands (1) and the protocol adapter creates the receiver link (2) on the tenant-scoped link. The protocol adapter then updates the <a href="/hono/docs/api/device-connection/#set-command-handling-protocol-adapter-instance-for-device">command-handling protocol adapter instance for device</a> information (3), assigning the device 4711 to adapter instance id #1. Following that, the notification about the device subscription is sent to the application via the AMQP messaging network (4).</p>
 
 <figure>
-    <img src="../command_control_concept_delegate_2.svg"/> <figcaption>
+    <img src="command_control_concept_delegate_2.svg"/> <figcaption>
             <h4>Command handling</h4>
         </figcaption>
 </figure>
@@ -1537,7 +1582,7 @@
 <p>Upon receiving the notification, the application prepares sender and command response receiver links (1,2) and sends the command message to the AMQP messaging network. Here it is received by protocol adapter instance #2. The protocol adapter then queries the <a href="/hono/docs/api/device-connection/#get-command-handling-protocol-adapter-instances-for-device">command-handling protocol adapter instances</a> information for the device id of the command message (4). In this case here, the protocol adapter instance #1 is returned (5). The command then gets forwarded to the AMQP messaging network on the address for adapter instance #1 (6). The protocol adapter instance #1 will receive the message (7) and forward it to the device (8). As the last step, an &ldquo;accepted&rdquo; disposition will be sent back to the application (9).</p>
 
 <figure>
-    <img src="../command_control_concept_delegate_3.svg"/> <figcaption>
+    <img src="command_control_concept_delegate_3.svg"/> <figcaption>
             <h4>Command response handling</h4>
         </figcaption>
 </figure>
@@ -1552,20 +1597,20 @@
 <p>The following sequence diagrams show the different steps involved in having a gateway subscribe for commands of a particular device.</p>
 
 <figure>
-    <img src="../command_control_concept_gateway_1.svg"/> <figcaption>
+    <img src="command_control_concept_gateway_1.svg"/> <figcaption>
             <h4>Command subscription</h4>
         </figcaption>
 </figure>
 
 
-<p>The gateway &ldquo;gw-1&rdquo; is connected to a protocol adapter and subscribes to commands for a device 4711 (1). This device has to be configured so that the gateway may act on its behalf (see <a href="/hono/docs/admin-guide/device-registry-config/#configuring-gateway-devices">Configuring Gateway Devices</a> for details).</p>
+<p>The gateway &ldquo;gw-1&rdquo; is connected to a protocol adapter and subscribes to commands for a device 4711 (1). This device has to be configured so that the gateway may act on its behalf (see <a href="/hono/docs/admin-guide/file-based-device-registry-config/#configuring-gateway-devices">Configuring Gateway Devices</a> for details).</p>
 
 <p>The protocol adapter creates the tenant-scoped consumer link on the <code>command/TENANT</code> address (if it doesn&rsquo;t already exist) (2) and then updates the <a href="/hono/docs/api/device-connection/#set-command-handling-protocol-adapter-instance-for-device">command-handling protocol adapter instance for device</a> information (3), assigning the device 4711 to adapter instance id #1.</p>
 
 <p>Just like it is done when a protocol adapter handles any kind of message from a gateway acting on behalf of a device, the protocol adapter updates the <a href="/hono/docs/api/device-connection/#set-last-known-gateway-for-device">last-known gateway</a> information here, sending a request to the device connection service (4). The notification event is then sent containing the device id 4711 (5)</p>
 
 <figure>
-    <img src="../command_control_concept_gateway_2.svg"/> <figcaption>
+    <img src="command_control_concept_gateway_2.svg"/> <figcaption>
             <h4>Command handling</h4>
         </figcaption>
 </figure>
@@ -1574,7 +1619,7 @@
 <p>After the application has prepared the sender and consumer links (1,2), it sends the command message on the <code>command/TENANT</code> link with the AMQP message <code>to</code> property set to <code>command/TENANT/4711</code> and <code>reply-to</code> set to the address of the command response consumer link (<code>command_response/TENANT/${replyId}</code> with <code>replyId</code> being an arbitrary identifier chosen by the application) (3). After receiving the command message, the protocol adapter determines the <a href="/hono/docs/api/device-connection/#get-command-handling-protocol-adapter-instances-for-device">command-handling protocol adapter instances</a> information for the device id of the command message (4). In this case here, the protocol adapter instance #1 is returned (5), meaning that the command is already at the right adapter instance. As the subscription for commands to device 4711 was done by gateway &ldquo;gw-1&rdquo;, the command gets forwarded to that gateway (6). It is then the responsibility of the gateway to forward the command to the device <code>4711</code>. After the gateway has acknowledged the command message, an &ldquo;accepted&rdquo; disposition will be sent back to the application (7).</p>
 
 <figure>
-    <img src="../command_control_concept_gateway_3.svg"/> <figcaption>
+    <img src="command_control_concept_gateway_3.svg"/> <figcaption>
             <h4>Command response handling</h4>
         </figcaption>
 </figure>
@@ -1587,7 +1632,7 @@
 <p>A gateway may also subscribe for commands sent to all the different devices that the gateway acts on behalf of. Such a scenario is shown in the following sequence diagram.</p>
 
 <figure>
-    <img src="../command_control_concept_gateway_all_devices_1.svg"/> <figcaption>
+    <img src="command_control_concept_gateway_all_devices_1.svg"/> <figcaption>
             <h4>Command subscription</h4>
         </figcaption>
 </figure>
@@ -1597,7 +1642,7 @@
 The subscription notification sent to the application contains the gateway id <code>gw-1</code>. That means that either the application has to know about the gateway, or that it just assumes that the devices it sends commands to (and that are connected to the gateway) are always available for receiving commands. This may especially be the case for long-lasting command subscriptions (with the MQTT or AMQP adapter).</p>
 
 <figure>
-    <img src="../command_control_concept_gateway_all_devices_2.svg"/> <figcaption>
+    <img src="command_control_concept_gateway_all_devices_2.svg"/> <figcaption>
             <h4>Command handling</h4>
         </figcaption>
 </figure>
@@ -1939,6 +1984,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2147,6 +2208,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2549,20 +2642,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/concepts/command_control_concept_delegate_1.svg b/docs/concepts/command_control_concept_delegate_1.svg
index a191e61..dfc24a9 100644
--- a/docs/concepts/command_control_concept_delegate_1.svg
+++ b/docs/concepts/command_control_concept_delegate_1.svg
@@ -1,20 +1,19 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="495.6px" preserveAspectRatio="none" style="width:1159px;height:495px;" version="1.1" viewBox="0 0 1159 495" width="1159.2px" zoomAndPan="magnify"><defs><filter height="300%" id="f14y3nnq0zl06i" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="469.7438" style="stroke: #A80036; stroke-width: 1.2;" width="544.8" x="286.8" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="536.4" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="142.2375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="365.4" y="328.7063"/><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1072.2" y="451.7438"/><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="196.7156" style="stroke: #000000; stroke-width: 2.4;" width="1047.6" x="98.4" y="264.6281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="148.8" x2="148.8" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="370.8" x2="370.8" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="542.4" x2="542.4" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="736.8" x2="736.8" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="924" x2="924" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1077.6" x2="1077.6" y1="89.6719" y2="481.7438"/><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="71.3098">Device</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="291.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="300" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="318.6" y="71.3098">instance #1</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="463.2" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="471.6" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="490.2" y="71.3098">instance #2</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="648" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="656.4" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="672" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="838.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="847.2" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="888.6" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1022.4" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1030.8" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="142.2375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="365.4" y="328.7063"/><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1072.2" y="451.7438"/><polygon fill="#A80036" points="910.2,176.7094,922.2,181.5094,910.2,186.3094,915,181.5094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="543" x2="917.4" y1="181.5094" y2="181.5094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="551.4" y="148.1912">0</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="567" y="120.9521">Consumer link on</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="156" x="567" y="139.1115">"command/TENANT"</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="148.8" x="567" y="157.2709">created for another</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="92.4" x="567" y="175.4303">subscription</text><path d="M9.6,197.1094 L9.6,245.1094 L285.6,245.1094 L285.6,209.1094 L273.6,197.1094 L9.6,197.1094 " fill="#FBFB77" filter="url(#f14y3nnq0zl06i)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M273.6,197.1094 L273.6,209.1094 L285.6,209.1094 L273.6,197.1094 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="217.2" x="16.8" y="217.5896">The device is connected and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="250.8" x="16.8" y="235.749">authenticated with TENANT/4711</text><path d="M98.4,264.6281 L357.6,264.6281 L357.6,273.0281 L345.6,285.0281 L98.4,285.0281 L98.4,264.6281 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="196.7156" style="stroke: #000000; stroke-width: 2.4;" width="1047.6" x="98.4" y="264.6281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="116.4" y="280.3084">Command subscription</text><polygon fill="#A80036" points="351,323.9063,363,328.7063,351,333.5062,355.8,328.7063" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="358.2" y1="328.7063" y2="328.7063"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="157.8" y="313.5475">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="173.4" y="304.4678">Command subscription</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="102" x="178.2" y="322.6271">/ TTD request</text><polygon fill="#A80036" points="910.2,358.8656,922.2,363.6656,910.2,368.4656,915,363.6656" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="377.4" x2="917.4" y1="363.6656" y2="363.6656"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="385.8" y="357.5865">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="300" x="401.4" y="357.5865">attach("receiver", "command/TENANT")</text><polygon fill="#A80036" points="723,411.9844,735,416.7844,723,421.5844,727.8,416.7844" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="377.4" x2="730.2" y1="416.7844" y2="416.7844"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="385.8" y="401.6256">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="401.4" y="392.5459">set command handling adapter instance</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="300" x="401.4" y="410.7053">for device 4711 to adapter instance #1</text><polygon fill="#A80036" points="1057.8,446.9437,1069.8,451.7438,1057.8,456.5438,1062.6,451.7438" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="377.4" x2="1065" y1="451.7438" y2="451.7438"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="385.8" y="445.6646">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="585.6" x="401.4" y="445.6646">transfer("event/TENANT","4711","ttd=${ttd}")  via AMQP messaging network</text><!--MD5=[c8b432715fa26176d4dfd933528d308b]
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="477.6px" preserveAspectRatio="none" style="width:1088px;height:477px;" version="1.1" viewBox="0 0 1088 477" width="1088.4px" zoomAndPan="magnify"><defs><filter height="300%" id="f1hmhg3jewutza" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="451.5844" style="stroke: #A80036; stroke-width: 1.2;" width="439.2" x="262.2" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="459" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f1hmhg3jewutza)" height="124.0781" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="365.4" y="328.7063"/><rect fill="#FFFFFF" filter="url(#f1hmhg3jewutza)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1001.4" y="433.5844"/><rect fill="#FFFFFF" filter="url(#f1hmhg3jewutza)" height="178.5563" style="stroke: #000000; stroke-width: 2.4;" width="976.8" x="98.4" y="264.6281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="148.8" x2="148.8" y1="89.6719" y2="463.5844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="371.4" x2="371.4" y1="89.6719" y2="463.5844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="592.2" x2="592.2" y1="89.6719" y2="463.5844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="793.8" x2="793.8" y1="89.6719" y2="463.5844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1006.8" x2="1006.8" y1="89.6719" y2="463.5844"/><rect fill="#FEFECE" filter="url(#f1hmhg3jewutza)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="71.3098">Device</text><rect fill="#FEFECE" filter="url(#f1hmhg3jewutza)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="267" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="275.4" y="51.7535">Hono Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="325.8" y="71.3098">instance 1</text><rect fill="#FEFECE" filter="url(#f1hmhg3jewutza)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="487.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="496.2" y="51.7535">Hono Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="546.6" y="71.3098">instance 2</text><rect fill="#FEFECE" filter="url(#f1hmhg3jewutza)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="708.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="717" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="758.4" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f1hmhg3jewutza)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="951.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="960" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#f1hmhg3jewutza)" height="124.0781" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="365.4" y="328.7063"/><rect fill="#FFFFFF" filter="url(#f1hmhg3jewutza)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1001.4" y="433.5844"/><polygon fill="#A80036" points="780,176.7094,792,181.5094,780,186.3094,784.8,181.5094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="592.2" x2="787.2" y1="181.5094" y2="181.5094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="600.6" y="148.1912">0</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="616.2" y="120.9521">Consumer link on</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="156" x="616.2" y="139.1115">"command/TENANT"</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="148.8" x="616.2" y="157.2709">created for another</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="92.4" x="616.2" y="175.4303">subscription</text><path d="M9.6,197.1094 L9.6,245.1094 L285.6,245.1094 L285.6,209.1094 L273.6,197.1094 L9.6,197.1094 " fill="#FBFB77" filter="url(#f1hmhg3jewutza)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M273.6,197.1094 L273.6,209.1094 L285.6,209.1094 L273.6,197.1094 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="217.2" x="16.8" y="217.5896">The device is connected and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="250.8" x="16.8" y="235.749">authenticated with TENANT/4711</text><path d="M98.4,264.6281 L357.6,264.6281 L357.6,273.0281 L345.6,285.0281 L98.4,285.0281 L98.4,264.6281 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="178.5563" style="stroke: #000000; stroke-width: 2.4;" width="976.8" x="98.4" y="264.6281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="116.4" y="280.3084">Command subscription</text><polygon fill="#A80036" points="351,323.9063,363,328.7063,351,333.5062,355.8,328.7063" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="358.2" y1="328.7063" y2="328.7063"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="157.8" y="313.5475">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="173.4" y="304.4678">Command subscription</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="102" x="178.2" y="322.6271">/ TTD request</text><polygon fill="#A80036" points="780,358.8656,792,363.6656,780,368.4656,784.8,363.6656" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="377.4" x2="787.2" y1="363.6656" y2="363.6656"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="385.8" y="357.5865">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="300" x="401.4" y="357.5865">attach("receiver", "command/TENANT")</text><polygon fill="#A80036" points="780,393.825,792,398.625,780,403.425,784.8,398.625" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="377.4" x2="787.2" y1="398.625" y2="398.625"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="385.8" y="392.5459">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="318" x="401.4" y="392.5459">attach("receiver", "control/TENANT/4711")</text><polygon fill="#A80036" points="987,428.7844,999,433.5844,987,438.3844,991.8,433.5844" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="377.4" x2="994.2" y1="433.5844" y2="433.5844"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="385.8" y="427.5053">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="585.6" x="401.4" y="427.5053">transfer("event/TENANT","4711","ttd=${ttd}")  via AMQP messaging network</text><!--MD5=[5ba83c9aca794515c9d86136c39b294c]
 @startuml
 scale 1.2
 hide footbox
 
 participant Device order 10
 box "Hono"
-    participant "Protocol Adapter\ninstance #1" order 30
-    participant "Protocol Adapter\ninstance #2" order 40
-    participant "Device Connection\nAPI component" order 50
+    participant "Hono Protocol Adapter\ninstance 1" order 30
+    participant "Hono Protocol Adapter\ninstance 2" order 40
 end box
 participant "AMQP messaging \nnetwork" order 60
 participant Application order 70
 
 autonumber 0
 
-"Protocol Adapter\ninstance #2" -> "AMQP messaging \nnetwork": Consumer link on \n"command/TENANT"\ncreated for another \nsubscription
+"Hono Protocol Adapter\ninstance 2" -> "AMQP messaging \nnetwork": Consumer link on \n"command/TENANT"\ncreated for another \nsubscription
 
 note over Device
 The device is connected and
@@ -23,13 +22,13 @@
 
 group Command subscription
 
-    Device -> "Protocol Adapter\ninstance #1": Command subscription\n / TTD request
-    activate "Protocol Adapter\ninstance #1"
+    Device -> "Hono Protocol Adapter\ninstance 1": Command subscription\n / TTD request
+    activate "Hono Protocol Adapter\ninstance 1"
 
-    "Protocol Adapter\ninstance #1" -> "AMQP messaging \nnetwork": attach("receiver", "command/TENANT")
-    "Protocol Adapter\ninstance #1" -> "Device Connection\nAPI component": set command handling adapter instance \nfor device 4711 to adapter instance #1
+    "Hono Protocol Adapter\ninstance 1" -> "AMQP messaging \nnetwork": attach("receiver", "command/TENANT")
+    "Hono Protocol Adapter\ninstance 1" -> "AMQP messaging \nnetwork": attach("receiver", "control/TENANT/4711")
 
-    "Protocol Adapter\ninstance #1" -> Application: transfer("event/TENANT","4711","ttd=${ttd}")  via AMQP messaging network
+    "Hono Protocol Adapter\ninstance 1" -> Application: transfer("event/TENANT","4711","ttd=${ttd}")  via AMQP messaging network
     activate Application
 end
 @enduml
diff --git a/docs/concepts/command_control_concept_delegate_3.svg b/docs/concepts/command_control_concept_delegate_3.svg
index c6d3f17..af78b6c 100644
--- a/docs/concepts/command_control_concept_delegate_3.svg
+++ b/docs/concepts/command_control_concept_delegate_3.svg
@@ -1,11 +1,11 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="316.8px" preserveAspectRatio="none" style="width:1051px;height:316px;" version="1.1" viewBox="0 0 1051 316" width="1051.2px" zoomAndPan="magnify"><defs><filter height="300%" id="f5wjt7gogzi89" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="299.8219" style="stroke: #A80036; stroke-width: 1.2;" width="340.8" x="237.6" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="385.2" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f5wjt7gogzi89)" height="108.6375" style="stroke: #000000; stroke-width: 2.4;" width="1022.4" x="15.6" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="66" x2="66" y1="89.6719" y2="239.1094"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="321.6" x2="321.6" y1="89.6719" y2="239.1094"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="493.2" x2="493.2" y1="89.6719" y2="239.1094"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="670.8" x2="670.8" y1="89.6719" y2="239.1094"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="969.6" x2="969.6" y1="89.6719" y2="239.1094"/><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="27.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="36" y="71.3098">Device</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="27.6" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="36" y="261.9035">Device</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="242.4" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="250.8" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="276.6" y="71.3098">instance 1</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="242.4" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="250.8" y="261.9035">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="276.6" y="281.4598">instance 1</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="414" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="422.4" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="448.2" y="71.3098">instance 2</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="414" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="422.4" y="261.9035">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="448.2" y="281.4598">instance 2</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="585.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="594" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="635.4" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="585.6" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="594" y="261.9035">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="635.4" y="281.4598">network</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="914.4" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="922.8" y="71.3098">Application</text><rect fill="#FEFECE" filter="url(#f5wjt7gogzi89)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="914.4" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="922.8" y="261.9035">Application</text><path d="M15.6,110.0719 L330,110.0719 L330,118.4719 L318,130.4719 L15.6,130.4719 L15.6,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="108.6375" style="stroke: #000000; stroke-width: 2.4;" width="1022.4" x="15.6" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="260.4" x="33.6" y="125.7521">Command response handling</text><polygon fill="#A80036" points="307.8,151.1906,319.8,155.9906,307.8,160.7906,312.6,155.9906" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="66.6" x2="315" y1="155.9906" y2="155.9906"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="75" y="149.9115">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="211.2" x="90.6" y="149.9115">Command response is sent</text><polygon fill="#A80036" points="955.8,204.3094,967.8,209.1094,955.8,213.9094,960.6,209.1094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="322.2" x2="963" y1="209.1094" y2="209.1094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="330.6" y="193.9506">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="603.6" x="346.2" y="184.8709">transfer("command_response/TENANT/${replyId}","status=200","${payload}")</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="355.8" y="203.0303">via AMQP messaging network</text><!--MD5=[5e5ec6ad238f39ba1a44ff34d08a44f9]
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="316.8px" preserveAspectRatio="none" style="width:1051px;height:316px;" version="1.1" viewBox="0 0 1051 316" width="1051.2px" zoomAndPan="magnify"><defs><filter height="300%" id="f5bfm9doy9361" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="299.8219" style="stroke: #A80036; stroke-width: 1.2;" width="439.2" x="213" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="409.8" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f5bfm9doy9361)" height="108.6375" style="stroke: #000000; stroke-width: 2.4;" width="1022.4" x="15.6" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="66" x2="66" y1="89.6719" y2="239.1094"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="322.2" x2="322.2" y1="89.6719" y2="239.1094"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="543" x2="543" y1="89.6719" y2="239.1094"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="744.6" x2="744.6" y1="89.6719" y2="239.1094"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="969.6" x2="969.6" y1="89.6719" y2="239.1094"/><rect fill="#FEFECE" filter="url(#f5bfm9doy9361)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="27.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="36" y="71.3098">Device</text><rect fill="#FEFECE" filter="url(#f5bfm9doy9361)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="27.6" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="36" y="261.9035">Device</text><rect fill="#FEFECE" filter="url(#f5bfm9doy9361)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="217.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="226.2" y="51.7535">Hono Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="276.6" y="71.3098">instance 1</text><rect fill="#FEFECE" filter="url(#f5bfm9doy9361)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="217.8" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="226.2" y="261.9035">Hono Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="276.6" y="281.4598">instance 1</text><rect fill="#FEFECE" filter="url(#f5bfm9doy9361)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="438.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="447" y="51.7535">Hono Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="497.4" y="71.3098">instance 2</text><rect fill="#FEFECE" filter="url(#f5bfm9doy9361)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="438.6" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="447" y="261.9035">Hono Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="497.4" y="281.4598">instance 2</text><rect fill="#FEFECE" filter="url(#f5bfm9doy9361)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="659.4" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="667.8" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="709.2" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f5bfm9doy9361)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="659.4" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="667.8" y="261.9035">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="709.2" y="281.4598">network</text><rect fill="#FEFECE" filter="url(#f5bfm9doy9361)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="914.4" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="922.8" y="71.3098">Application</text><rect fill="#FEFECE" filter="url(#f5bfm9doy9361)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="914.4" y="237.9094"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="922.8" y="261.9035">Application</text><path d="M15.6,110.0719 L330,110.0719 L330,118.4719 L318,130.4719 L15.6,130.4719 L15.6,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="108.6375" style="stroke: #000000; stroke-width: 2.4;" width="1022.4" x="15.6" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="260.4" x="33.6" y="125.7521">Command response handling</text><polygon fill="#A80036" points="307.8,151.1906,319.8,155.9906,307.8,160.7906,312.6,155.9906" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="66.6" x2="315" y1="155.9906" y2="155.9906"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="75" y="149.9115">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="211.2" x="90.6" y="149.9115">Command response is sent</text><polygon fill="#A80036" points="955.8,204.3094,967.8,209.1094,955.8,213.9094,960.6,209.1094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="322.2" x2="963" y1="209.1094" y2="209.1094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="330.6" y="193.9506">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="603.6" x="346.2" y="184.8709">transfer("command_response/TENANT/${replyId}","status=200","${payload}")</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="355.8" y="203.0303">via AMQP messaging network</text><!--MD5=[26ec35a98e624b51ef3efdb2aa409e68]
 @startuml
 scale 1.2
 
 participant Device order 10
 box "Hono"
-    participant "Protocol Adapter\ninstance 1" order 30
-    participant "Protocol Adapter\ninstance 2" order 40
+    participant "Hono Protocol Adapter\ninstance 1" order 30
+    participant "Hono Protocol Adapter\ninstance 2" order 40
 end box
 participant "AMQP messaging \nnetwork" order 60
 participant Application order 70
@@ -14,9 +14,9 @@
 
 group Command response handling
 
-    Device -> "Protocol Adapter\ninstance 1": Command response is sent
-    "Protocol Adapter\ninstance 1" -> Application: transfer("command_response/TENANT/${replyId}","status=200","${payload}")\n  via AMQP messaging network
-    deactivate "Protocol Adapter\ninstance 1"
+    Device -> "Hono Protocol Adapter\ninstance 1": Command response is sent
+    "Hono Protocol Adapter\ninstance 1" -> Application: transfer("command_response/TENANT/${replyId}","status=200","${payload}")\n  via AMQP messaging network
+    deactivate "Hono Protocol Adapter\ninstance 1"
     deactivate Application
 end
 @enduml
diff --git a/docs/concepts/command_control_concept_gateway_2.svg b/docs/concepts/command_control_concept_gateway_2.svg
index 04f0e4e..60eb306 100644
--- a/docs/concepts/command_control_concept_gateway_2.svg
+++ b/docs/concepts/command_control_concept_gateway_2.svg
@@ -1,11 +1,11 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="685.2px" preserveAspectRatio="none" style="width:1194px;height:685px;" version="1.1" viewBox="0 0 1194 685" width="1194px" zoomAndPan="magnify"><defs><filter height="300%" id="f160zighuzisgk" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="659.2594" style="stroke: #A80036; stroke-width: 1.2;" width="530.4" x="277.2" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="519.6" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f160zighuzisgk)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="707.4" y="351.6656"/><rect fill="#FFFFFF" filter="url(#f160zighuzisgk)" height="540.7875" style="stroke: #000000; stroke-width: 2.4;" width="1166.4" x="14.4" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="141.6" x2="141.6" y1="89.6719" y2="671.2594"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="361.2" x2="361.2" y1="89.6719" y2="671.2594"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="712.8" x2="712.8" y1="89.6719" y2="671.2594"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="900" x2="900" y1="89.6719" y2="671.2594"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1112.4" x2="1112.4" y1="89.6719" y2="671.2594"/><rect fill="#FEFECE" filter="url(#f160zighuzisgk)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="96" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="104.4" y="71.3098">Gateway</text><rect fill="#FEFECE" filter="url(#f160zighuzisgk)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="282" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="290.4" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="309" y="71.3098">instance #1</text><rect fill="#FEFECE" filter="url(#f160zighuzisgk)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="624" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="632.4" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="648" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f160zighuzisgk)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="814.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="823.2" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="864.6" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f160zighuzisgk)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1057.2" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1065.6" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#f160zighuzisgk)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="707.4" y="351.6656"/><path d="M14.4,110.0719 L241.2,110.0719 L241.2,118.4719 L229.2,130.4719 L14.4,130.4719 L14.4,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="540.7875" style="stroke: #000000; stroke-width: 2.4;" width="1166.4" x="14.4" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="32.4" y="125.7521">Command handling</text><polygon fill="#A80036" points="913.8,187.5094,901.8,192.3094,913.8,197.1094,909,192.3094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="906.6" x2="1111.8" y1="192.3094" y2="192.3094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="921" y="168.0709">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="936.6" y="149.9115">attach("receiver",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="168" x="936.6" y="168.0709">"command_response/</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="941.4" y="186.2303">TENANT/${replyId}")</text><polygon fill="#A80036" points="913.8,240.6281,901.8,245.4281,913.8,250.2281,909,245.4281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="906.6" x2="1111.8" y1="245.4281" y2="245.4281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="921" y="230.2693">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="124.8" x="936.6" y="221.1896">attach("sender",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="162" x="936.6" y="239.349">"command/TENANT")</text><polygon fill="#A80036" points="375,293.7469,363,298.5469,375,303.3469,370.2,298.5469" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="367.8" x2="1111.8" y1="298.5469" y2="298.5469"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="382.2" y="283.3881">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="542.4" x="397.8" y="274.3084">transfer("command/TENANT", "command/TENANT/4711","${payload}")</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="412.2" y="292.4678">via AMQP messaging network</text><polygon fill="#A80036" points="693,346.8656,705,351.6656,693,356.4656,697.8,351.6656" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="361.8" x2="700.2" y1="351.6656" y2="351.6656"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="370.2" y="336.5068">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="242.4" x="385.8" y="327.4271">get command handling adapter</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="195.6" x="385.8" y="345.5865">instances for device 4711</text><polygon fill="#A80036" points="375,399.9844,363,404.7844,375,409.5844,370.2,404.7844" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 2.0,2.0;" x1="367.8" x2="712.2" y1="404.7844" y2="404.7844"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="382.2" y="389.6256">5</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="296.4" x="397.8" y="380.5459">JSON containing adapter instance "#1"</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="236.4" x="397.8" y="398.7053">handling commands for "4711"</text><path d="M220.8,420.3844 L220.8,504.3844 L496.8,504.3844 L496.8,432.3844 L484.8,420.3844 L220.8,420.3844 " fill="#FBFB77" filter="url(#f160zighuzisgk)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M484.8,420.3844 L484.8,432.3844 L496.8,432.3844 L484.8,420.3844 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="248.4" x="228" y="440.8646">Command is already at the right</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="238.8" x="228" y="459.024">adapter instance, gets handled</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="250.8" x="228" y="477.1834">by command handler associated</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="87.6" x="228" y="495.3428">with "gw-1".</text><polygon fill="#A80036" points="155.4,536.3813,143.4,541.1813,155.4,545.9812,150.6,541.1813" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="148.2" x2="360.6" y1="541.1813" y2="541.1813"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="162.6" y="535.1021">6</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="175.2" x="178.2" y="535.1021">Command is published</text><path d="M26.4,556.7813 L26.4,604.7813 L252,604.7813 L252,568.7813 L240,556.7813 L26.4,556.7813 " fill="#FBFB77" filter="url(#f160zighuzisgk)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M240,556.7813 L240,568.7813 L252,568.7813 L240,556.7813 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="33.6" y="577.2615">The gateway sends the</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="200.4" x="33.6" y="595.4209">command to device 4711.</text><polygon fill="#A80036" points="1098.6,636.4594,1110.6,641.2594,1098.6,646.0594,1103.4,641.2594" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="361.8" x2="1105.8" y1="641.2594" y2="641.2594"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="370.2" y="635.1803">7</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="411.6" x="385.8" y="635.1803">disposition("accepted")  via AMQP messaging network</text><!--MD5=[40c7e1303a3221224bab616aecbb0475]
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="547.2px" preserveAspectRatio="none" style="width:1065px;height:547px;" version="1.1" viewBox="0 0 1065 547" width="1065.6px" zoomAndPan="magnify"><defs><filter height="300%" id="f3qmjd821yfe" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="521.5031" style="stroke: #A80036; stroke-width: 1.2;" width="429" x="250.2" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="441.9" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f3qmjd821yfe)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="579" y="333.5062"/><rect fill="#FFFFFF" filter="url(#f3qmjd821yfe)" height="403.0313" style="stroke: #000000; stroke-width: 2.4;" width="1038" x="14.4" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="139.2" x2="139.2" y1="89.6719" y2="533.5031"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="359.4" x2="359.4" y1="89.6719" y2="533.5031"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="584.4" x2="584.4" y1="89.6719" y2="533.5031"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="771.6" x2="771.6" y1="89.6719" y2="533.5031"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="984" x2="984" y1="89.6719" y2="533.5031"/><rect fill="#FEFECE" filter="url(#f3qmjd821yfe)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="93.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="102" y="71.3098">Gateway</text><rect fill="#FEFECE" filter="url(#f3qmjd821yfe)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="255" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="263.4" y="51.7535">Hono Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="313.8" y="71.3098">instance 1</text><rect fill="#FEFECE" filter="url(#f3qmjd821yfe)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="495.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="504" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="519.6" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f3qmjd821yfe)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="686.4" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="694.8" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="736.2" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f3qmjd821yfe)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="928.8" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="937.2" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#f3qmjd821yfe)" height="34.9594" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="579" y="333.5062"/><path d="M14.4,110.0719 L241.2,110.0719 L241.2,118.4719 L229.2,130.4719 L14.4,130.4719 L14.4,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="403.0313" style="stroke: #000000; stroke-width: 2.4;" width="1038" x="14.4" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="32.4" y="125.7521">Command handling</text><polygon fill="#A80036" points="785.4,187.5094,773.4,192.3094,785.4,197.1094,780.6,192.3094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="778.2" x2="983.4" y1="192.3094" y2="192.3094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="792.6" y="168.0709">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="808.2" y="149.9115">attach("receiver",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="168" x="808.2" y="168.0709">"command_response/</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="813" y="186.2303">TENANT/${replyId}")</text><polygon fill="#A80036" points="785.4,240.6281,773.4,245.4281,785.4,250.2281,780.6,245.4281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="778.2" x2="983.4" y1="245.4281" y2="245.4281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="792.6" y="230.2693">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="124.8" x="808.2" y="221.1896">attach("sender",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="162" x="808.2" y="239.349">"command/TENANT")</text><polygon fill="#A80036" points="372.6,293.7469,360.6,298.5469,372.6,303.3469,367.8,298.5469" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="365.4" x2="983.4" y1="298.5469" y2="298.5469"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="379.8" y="283.3881">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="542.4" x="395.4" y="274.3084">transfer("command/TENANT", "command/TENANT/4711","${payload}")</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="409.8" y="292.4678">via AMQP messaging network</text><polygon fill="#A80036" points="564.6,328.7063,576.6,333.5062,564.6,338.3063,569.4,333.5062" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="359.4" x2="571.8" y1="333.5062" y2="333.5062"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="367.8" y="327.4271">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="181.2" x="383.4" y="327.4271">Get last known gateway</text><polygon fill="#A80036" points="372.6,363.6656,360.6,368.4656,372.6,373.2656,367.8,368.4656" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 2.0,2.0;" x1="365.4" x2="583.8" y1="368.4656" y2="368.4656"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="379.8" y="362.3865">5</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="48" x="395.4" y="362.3865">"gw-1"</text><polygon fill="#A80036" points="153,398.625,141,403.425,153,408.225,148.2,403.425" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="145.8" x2="358.2" y1="403.425" y2="403.425"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="160.2" y="397.3459">6</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="175.2" x="175.8" y="397.3459">Command is published</text><path d="M26.4,419.025 L26.4,467.025 L247.2,467.025 L247.2,431.025 L235.2,419.025 L26.4,419.025 " fill="#FBFB77" filter="url(#f3qmjd821yfe)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M235.2,419.025 L235.2,431.025 L247.2,431.025 L235.2,419.025 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="33.6" y="439.5053">The gateway sends the</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="195.6" x="33.6" y="457.6646">command to device 4711</text><polygon fill="#A80036" points="970.2,498.7031,982.2,503.5031,970.2,508.3031,975,503.5031" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="359.4" x2="977.4" y1="503.5031" y2="503.5031"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="367.8" y="497.424">7</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="411.6" x="383.4" y="497.424">disposition("accepted")  via AMQP messaging network</text><!--MD5=[576c1c4d478207bfef6b7d9506476bb2]
 @startuml
 scale 1.2
 hide footbox
 
 participant Gateway order 20
 box "Hono"
-    participant "Protocol Adapter\ninstance #1" order 30
+    participant "Hono Protocol Adapter\ninstance 1" order 30
     participant "Device Connection\nAPI component" order 50
 end box
 participant "AMQP messaging \nnetwork" order 60
@@ -18,25 +18,18 @@
     Application -> "AMQP messaging \nnetwork": attach("receiver", \n"command_response/\n TENANT/${replyId}")
     Application -> "AMQP messaging \nnetwork": attach("sender", \n"command/TENANT")
 
-    Application -> "Protocol Adapter\ninstance #1": transfer("command/TENANT", "command/TENANT/4711","${payload}")\n   via AMQP messaging network
+    Application -> "Hono Protocol Adapter\ninstance 1": transfer("command/TENANT", "command/TENANT/4711","${payload}")\n   via AMQP messaging network
 
-    "Protocol Adapter\ninstance #1" -> "Device Connection\nAPI component": get command handling adapter \ninstances for device 4711
+    "Hono Protocol Adapter\ninstance 1" -> "Device Connection\nAPI component": Get last known gateway
     activate "Device Connection\nAPI component"
-    return JSON containing adapter instance "#1" \nhandling commands for "4711"
+    return "gw-1"
 
-    note over "Protocol Adapter\ninstance #1"
-    Command is already at the right
-    adapter instance, gets handled
-    by command handler associated
-    with "gw-1".
-    end note
-
-    "Protocol Adapter\ninstance #1" -> Gateway: Command is published
+    "Hono Protocol Adapter\ninstance 1" -> Gateway: Command is published
     note over Gateway
     The gateway sends the
-    command to device 4711.
+    command to device 4711
     end note
-    "Protocol Adapter\ninstance #1" -> Application: disposition("accepted")  via AMQP messaging network
+    "Hono Protocol Adapter\ninstance 1" -> Application: disposition("accepted")  via AMQP messaging network
 end
 @enduml
 
diff --git a/docs/concepts/command_control_concept_gateway_3.svg b/docs/concepts/command_control_concept_gateway_3.svg
index 2a5499e..a72f4c1 100644
--- a/docs/concepts/command_control_concept_gateway_3.svg
+++ b/docs/concepts/command_control_concept_gateway_3.svg
@@ -1,10 +1,10 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="382.8px" preserveAspectRatio="none" style="width:1046px;height:382px;" version="1.1" viewBox="0 0 1046 382" width="1046.4px" zoomAndPan="magnify"><defs><filter height="300%" id="f1syi2mmgw2dx7" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="364.9406" style="stroke: #A80036; stroke-width: 1.2;" width="360" x="358.8" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="516" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f1syi2mmgw2dx7)" height="173.7563" style="stroke: #000000; stroke-width: 2.4;" width="1018.8" x="14.4" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="187.2" x2="187.2" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="442.8" x2="442.8" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="624" x2="624" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="811.2" x2="811.2" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="964.8" x2="964.8" y1="89.6719" y2="304.2281"/><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="141.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="150" y="71.3098">Gateway</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="141.6" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="150" y="327.0223">Gateway</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="363.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="372" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="397.8" y="71.3098">instance 1</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="363.6" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="372" y="327.0223">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="397.8" y="346.5785">instance 1</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="535.2" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="543.6" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="559.2" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="535.2" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="543.6" y="327.0223">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="559.2" y="346.5785">API component</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="726" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="734.4" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="775.8" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="726" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="734.4" y="327.0223">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="775.8" y="346.5785">network</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="909.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="918" y="71.3098">Application</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="909.6" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="918" y="327.0223">Application</text><path d="M14.4,110.0719 L328.8,110.0719 L328.8,118.4719 L316.8,130.4719 L14.4,130.4719 L14.4,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="173.7563" style="stroke: #000000; stroke-width: 2.4;" width="1018.8" x="14.4" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="260.4" x="32.4" y="125.7521">Command response handling</text><path d="M26.4,136.6313 L26.4,184.6313 L343.2,184.6313 L343.2,148.6313 L331.2,136.6313 L26.4,136.6313 " fill="#FBFB77" filter="url(#f1syi2mmgw2dx7)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M331.2,136.6313 L331.2,148.6313 L343.2,148.6313 L331.2,136.6313 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="194.4" x="33.6" y="157.1115">The gateway receives the</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="291.6" x="33.6" y="175.2709">command response from device 4711</text><polygon fill="#A80036" points="429,216.3094,441,221.1094,429,225.9094,433.8,221.1094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="187.8" x2="436.2" y1="221.1094" y2="221.1094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="196.2" y="215.0303">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="211.2" x="211.8" y="215.0303">Command response is sent</text><polygon fill="#A80036" points="951,269.4281,963,274.2281,951,279.0281,955.8,274.2281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="443.4" x2="958.2" y1="274.2281" y2="274.2281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="451.8" y="259.0693">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="390" x="467.4" y="249.9896">transfer("command_response/TENANT/${replyId}",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="453.6" x="472.2" y="268.149">"status=200","${payload}")   via AMQP messaging network</text><!--MD5=[314ae5857e0e2e146e21c67a08eb6e9b]
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="382.8px" preserveAspectRatio="none" style="width:1070px;height:382px;" version="1.1" viewBox="0 0 1070 382" width="1070.4px" zoomAndPan="magnify"><defs><filter height="300%" id="f1du81qzywy1qb" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="364.9406" style="stroke: #A80036; stroke-width: 1.2;" width="409.2" x="334.2" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="516" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f1du81qzywy1qb)" height="173.7563" style="stroke: #000000; stroke-width: 2.4;" width="1043.4" x="14.4" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="187.2" x2="187.2" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="443.4" x2="443.4" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="648.6" x2="648.6" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="835.8" x2="835.8" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="989.4" x2="989.4" y1="89.6719" y2="304.2281"/><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="141.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="150" y="71.3098">Gateway</text><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="141.6" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="150" y="327.0223">Gateway</text><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="339" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="347.4" y="51.7535">Hono Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="397.8" y="71.3098">instance 1</text><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="339" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="347.4" y="327.0223">Hono Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="397.8" y="346.5785">instance 1</text><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="559.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="568.2" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="583.8" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="559.8" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="568.2" y="327.0223">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="583.8" y="346.5785">API component</text><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="750.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="759" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="800.4" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="750.6" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="759" y="327.0223">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="800.4" y="346.5785">network</text><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="934.2" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="942.6" y="71.3098">Application</text><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="934.2" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="942.6" y="327.0223">Application</text><path d="M14.4,110.0719 L328.8,110.0719 L328.8,118.4719 L316.8,130.4719 L14.4,130.4719 L14.4,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="173.7563" style="stroke: #000000; stroke-width: 2.4;" width="1043.4" x="14.4" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="260.4" x="32.4" y="125.7521">Command response handling</text><path d="M26.4,136.6313 L26.4,184.6313 L343.2,184.6313 L343.2,148.6313 L331.2,136.6313 L26.4,136.6313 " fill="#FBFB77" filter="url(#f1du81qzywy1qb)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M331.2,136.6313 L331.2,148.6313 L343.2,148.6313 L331.2,136.6313 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="194.4" x="33.6" y="157.1115">The gateway receives the</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="291.6" x="33.6" y="175.2709">command response from device 4711</text><polygon fill="#A80036" points="429,216.3094,441,221.1094,429,225.9094,433.8,221.1094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="187.8" x2="436.2" y1="221.1094" y2="221.1094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="196.2" y="215.0303">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="211.2" x="211.8" y="215.0303">Command response is sent</text><polygon fill="#A80036" points="975.6,269.4281,987.6,274.2281,975.6,279.0281,980.4,274.2281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="443.4" x2="982.8" y1="274.2281" y2="274.2281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="451.8" y="259.0693">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="390" x="467.4" y="249.9896">transfer("command_response/TENANT/${replyId}",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="453.6" x="472.2" y="268.149">"status=200","${payload}")   via AMQP messaging network</text><!--MD5=[303c83bfa669dba0d0715de29b2a056c]
 @startuml
 scale 1.2
 
 participant Gateway order 20
 box "Hono"
-    participant "Protocol Adapter\ninstance 1" order 30
+    participant "Hono Protocol Adapter\ninstance 1" order 30
     participant "Device Connection\nAPI component" order 50
 end box
 participant "AMQP messaging \nnetwork" order 60
@@ -17,9 +17,9 @@
     The gateway receives the
     command response from device 4711
     end note
-    Gateway -> "Protocol Adapter\ninstance 1": Command response is sent
-    "Protocol Adapter\ninstance 1" -> Application: transfer("command_response/TENANT/${replyId}",\n "status=200","${payload}")   via AMQP messaging network
-    deactivate "Protocol Adapter\ninstance 1"
+    Gateway -> "Hono Protocol Adapter\ninstance 1": Command response is sent
+    "Hono Protocol Adapter\ninstance 1" -> Application: transfer("command_response/TENANT/${replyId}",\n "status=200","${payload}")   via AMQP messaging network
+    deactivate "Hono Protocol Adapter\ninstance 1"
     deactivate Application
 end
 @enduml
diff --git a/docs/concepts/connecting-devices/index.html b/docs/concepts/connecting-devices/index.html
index a2be691..d35bd35 100644
--- a/docs/concepts/connecting-devices/index.html
+++ b/docs/concepts/connecting-devices/index.html
@@ -21,19 +21,19 @@
     <title>Connecting Devices :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/connecting-devices/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/connecting-devices/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/connecting-devices/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/connecting-devices/">1.1</option>
@@ -1313,6 +1392,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/connecting-devices/">dev</option>
@@ -1599,7 +1680,7 @@
 
 <h3 id="example-code">Example Code</h3>
 
-<p>Hono&rsquo;s <a href="https://github.com/eclipse/hono/tree/master/example/protocol-adapter-example"><em>examples</em> module</a> contains code for
+<p>Hono&rsquo;s <a href="https://github.com/eclipse/hono/tree/master/examples/protocol-adapter-example"><em>examples</em> module</a> contains code for
 a simple protocol gateway illustrating how devices using a binary TCP based protocol can be connected to Hono&rsquo;s AMQP adapter.</p>
 
 
@@ -1927,6 +2008,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2135,6 +2232,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2537,20 +2666,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/concepts/connection-events/index.html b/docs/concepts/connection-events/index.html
index 4b5ca61..2100d11 100644
--- a/docs/concepts/connection-events/index.html
+++ b/docs/concepts/connection-events/index.html
@@ -21,19 +21,19 @@
     <title>Connection Events :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/connection-events/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/connection-events/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/connection-events/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/connection-events/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/connection-events/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/connection-events/">dev</option>
@@ -1812,6 +1895,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2020,6 +2119,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2422,20 +2553,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/concepts/device-identity/index.html b/docs/concepts/device-identity/index.html
index c933d5b..083c723 100644
--- a/docs/concepts/device-identity/index.html
+++ b/docs/concepts/device-identity/index.html
@@ -21,19 +21,19 @@
     <title>Device Identity :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/device-identity/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/device-identity/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/device-identity/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/device-identity/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/device-identity/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/device-identity/">dev</option>
@@ -1490,7 +1573,7 @@
 
 <p>In addition to that, Hono defines a <a href="/hono/docs/api/management/">Device Registry Management API</a>, which can be implemented to take advantage of standardized  operations for managing devices and credentials. This API is optional because Hono components do not require it during runtime.</p>
 
-<p>For demonstration purposes, Hono comes with a <a href="/hono/docs/admin-guide/device-registry-config/">simple default implementation</a> of both APIs which keeps all data in memory only. Therefore it is not supposed to be used in production scenarios. For the future, it is planned that a production-ready Device Registry will be released as part of Hono that implements both APIs.</p>
+<p>Hono comes with a <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">MongoDB</a> and a <a href="/hono/docs/admin-guide/file-based-device-registry-config/">simple file</a> based implementations of both APIs. The file based implementation, which keeps all data in memory, is to be used only for demonstration purposes and is not supposed to be used in production scenarios.</p>
 
 <h2 id="device-authentication">Device Authentication</h2>
 
@@ -1832,6 +1915,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2040,6 +2139,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2442,20 +2573,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/concepts/device-notifications/device_commandReadinessExplicit.svg b/docs/concepts/device-notifications/device_commandReadinessExplicit.svg
new file mode 100644
index 0000000..f51d1e5
--- /dev/null
+++ b/docs/concepts/device-notifications/device_commandReadinessExplicit.svg
@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="711.6px" preserveAspectRatio="none" style="width:1803px;height:711px;" version="1.1" viewBox="0 0 1803 711" width="1803.6px" zoomAndPan="magnify"><defs><filter height="300%" id="f1r9pxs4xq39he" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="48" x2="48" y1="45.9563" y2="663.3844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="789" x2="789" y1="45.9563" y2="663.3844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1253.4" x2="1253.4" y1="45.9563" y2="663.3844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1527.6" x2="1527.6" y1="45.9563" y2="663.3844"/><rect fill="#FEFECE" filter="url(#f1r9pxs4xq39he)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="9.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="18" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#f1r9pxs4xq39he)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="9.6" y="662.1844"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="18" y="686.1785">Device</text><rect fill="#FEFECE" filter="url(#f1r9pxs4xq39he)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="684.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="693" y="27.5941">HTTP Protocol Adapter</text><rect fill="#FEFECE" filter="url(#f1r9pxs4xq39he)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="684.6" y="662.1844"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="693" y="686.1785">HTTP Protocol Adapter</text><rect fill="#FEFECE" filter="url(#f1r9pxs4xq39he)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="1165.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="1174.2" y="27.5941">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#f1r9pxs4xq39he)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="1165.8" y="662.1844"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="1174.2" y="686.1785">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#f1r9pxs4xq39he)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="198" x="1426.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="181.2" x="1435.2" y="27.5941">Consumer Application</text><rect fill="#FEFECE" filter="url(#f1r9pxs4xq39he)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="198" x="1426.8" y="662.1844"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="181.2" x="1435.2" y="686.1785">Consumer Application</text><path d="M54,63.9563 L54,111.9563 L476.4,111.9563 L476.4,75.9563 L464.4,63.9563 L54,63.9563 " fill="#FBFB77" filter="url(#f1r9pxs4xq39he)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M464.4,63.9563 L464.4,75.9563 L476.4,75.9563 L464.4,63.9563 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="397.2" x="61.2" y="84.4365">sending explicit event to signal command readiness</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="181.2" x="61.2" y="102.5959">for the next 60 seconds</text><path d="M54,129.075 L54,177.075 L493.2,177.075 L493.2,141.075 L481.2,129.075 L54,129.075 " fill="#FBFB77" filter="url(#f1r9pxs4xq39he)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M481.2,129.075 L481.2,141.075 L493.2,141.075 L481.2,129.075 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="414" x="61.2" y="149.5553">The HTTP specific header "hono-ttd" is used to provide</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="270" x="61.2" y="167.7146">the value for ttd by the device itself</text><polygon fill="#A80036" points="774.6,208.7531,786.6,213.5531,774.6,218.3531,779.4,213.5531" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="48.6" x2="781.8" y1="213.5531" y2="213.5531"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="711.6" x="57" y="207.474">POST event(hono-ttd="60", Content-Type="application/vnd.eclipse-hono-empty-notification")</text><path d="M608.4,229.1531 L608.4,331.1531 L963.6,331.1531 L963.6,241.1531 L951.6,229.1531 L608.4,229.1531 " fill="#FBFB77" filter="url(#f1r9pxs4xq39he)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M951.6,229.1531 L951.6,241.1531 L963.6,241.1531 L951.6,229.1531 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="193.2" x="615.6" y="249.6334">Set AMQP 1.0 properties:</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="615.6" y="267.7928">tenant-id: "TENANT",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="615.6" y="285.9521">device-id: "4711",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="330" x="615.6" y="304.1115">creation-time: NOW (in epoch milliseconds)</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="615.6" y="322.2709">ttd: value from http-ttd</text><polygon fill="#A80036" points="1239,363.3094,1251,368.1094,1239,372.9094,1243.8,368.1094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="789" x2="1246.2" y1="368.1094" y2="368.1094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="435.6" x="797.4" y="362.0303">1.0 transfer("event/TENANT", "4711", , creation-time, ttd)</text><polygon fill="#A80036" points="1513.8,398.2688,1525.8,403.0687,1513.8,407.8688,1518.6,403.0687" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1253.4" x2="1521" y1="403.0687" y2="403.0687"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="246" x="1261.8" y="396.9896">1.2 transfer("event/TENANT", ...)</text><polygon fill="#A80036" points="1266.6,433.2281,1254.6,438.0281,1266.6,442.8281,1261.8,438.0281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1259.4" x2="1527" y1="438.0281" y2="438.0281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="1273.8" y="431.949">2.0 disposition("accepted")</text><polygon fill="#A80036" points="802.2,468.1875,790.2,472.9875,802.2,477.7875,797.4,472.9875" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="795" x2="1252.2" y1="472.9875" y2="472.9875"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="809.4" y="466.9084">2.0 disposition("accepted")</text><polygon fill="#A80036" points="61.8,503.1469,49.8,507.9469,61.8,512.7469,57,507.9469" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="54.6" x2="787.8" y1="507.9469" y2="507.9469"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="69" y="501.8678">HTTP/1.1 202 Accepted</text><line style="stroke: #A80036; stroke-width: 1.2;" x1="1528.2" x2="1578.6" y1="542.9063" y2="542.9063"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1578.6" x2="1578.6" y1="542.9063" y2="558.5063"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1529.4" x2="1578.6" y1="558.5063" y2="558.5063"/><polygon fill="#A80036" points="1541.4,553.7063,1529.4,558.5063,1541.4,563.3063,1536.6,558.5063" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="253.2" x="1536.6" y="536.8271">callbackIfValid(creation-time, ttd)</text><path d="M1314,574.1062 L1314,640.1062 L1736.4,640.1062 L1736.4,586.1062 L1724.4,574.1062 L1314,574.1062 " fill="#FBFB77" filter="url(#f1r9pxs4xq39he)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M1724.4,574.1062 L1724.4,586.1062 L1736.4,586.1062 L1724.4,574.1062 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="397.2" x="1321.2" y="594.5865">React if message indicates that currently the device</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="237.6" x="1321.2" y="612.7459">is ready to receive a command</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="271.2" x="1321.2" y="630.9053">(e.g. by trying to send a command)</text><!--
+@startuml
+scale 1.2
+
+participant Device
+
+participant "HTTP Protocol Adapter"
+participant "AMQP 1.0 Network"
+participant "Consumer Application"
+
+note right of Device
+sending explicit event to signal command readiness
+for the next 60 seconds
+end note
+note right of Device
+The HTTP specific header "hono-ttd" is used to provide
+the value for ttd by the device itself
+end note
+
+Device -> "HTTP Protocol Adapter": POST event(hono-ttd="60", Content-Type="application/vnd.eclipse-hono-empty-notification")
+
+note over "HTTP Protocol Adapter"
+Set AMQP 1.0 properties:
+tenant-id: "TENANT",
+device-id: "4711",
+creation-time: NOW (in epoch milliseconds)
+ttd: value from http-ttd
+end note
+
+"HTTP Protocol Adapter" -> "AMQP 1.0 Network": 1.0 transfer("event/TENANT", "4711", , creation-time, ttd)
+"AMQP 1.0 Network" -> "Consumer Application": 1.2 transfer("event/TENANT", ...)
+"Consumer Application" -> "AMQP 1.0 Network": 2.0 disposition("accepted")
+"AMQP 1.0 Network" -> "HTTP Protocol Adapter": 2.0 disposition("accepted")
+
+
+"HTTP Protocol Adapter" -> Device: HTTP/1.1 202 Accepted
+
+"Consumer Application" -> "Consumer Application": callbackIfValid(creation-time, ttd)
+note over "Consumer Application"
+React if message indicates that currently the device
+is ready to receive a command
+(e.g. by trying to send a command)
+end note
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/concepts/device-notifications/device_commandReadinessImplicit.svg b/docs/concepts/device-notifications/device_commandReadinessImplicit.svg
new file mode 100644
index 0000000..836a06a
--- /dev/null
+++ b/docs/concepts/device-notifications/device_commandReadinessImplicit.svg
@@ -0,0 +1,61 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="740.4px" preserveAspectRatio="none" style="width:1734px;height:740px;" version="1.1" viewBox="0 0 1734 740" width="1734px" zoomAndPan="magnify"><defs><filter height="300%" id="fnzp9xyiux0bi" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="361.2" x2="361.2" y1="45.9563" y2="692.1844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="657" x2="657" y1="45.9563" y2="692.1844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1152.6" x2="1152.6" y1="45.9563" y2="692.1844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1458" x2="1458" y1="45.9563" y2="692.1844"/><rect fill="#FEFECE" filter="url(#fnzp9xyiux0bi)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="322.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="331.2" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#fnzp9xyiux0bi)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="322.8" y="690.9844"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="331.2" y="714.9785">Device</text><rect fill="#FEFECE" filter="url(#fnzp9xyiux0bi)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="552.6" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="561" y="27.5941">HTTP Protocol Adapter</text><rect fill="#FEFECE" filter="url(#fnzp9xyiux0bi)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="552.6" y="690.9844"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="561" y="714.9785">HTTP Protocol Adapter</text><rect fill="#FEFECE" filter="url(#fnzp9xyiux0bi)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="1065" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="1073.4" y="27.5941">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#fnzp9xyiux0bi)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="170.4" x="1065" y="690.9844"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="153.6" x="1073.4" y="714.9785">AMQP 1.0 Network</text><rect fill="#FEFECE" filter="url(#fnzp9xyiux0bi)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="198" x="1357.2" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="181.2" x="1365.6" y="27.5941">Consumer Application</text><rect fill="#FEFECE" filter="url(#fnzp9xyiux0bi)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="198" x="1357.2" y="690.9844"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="181.2" x="1365.6" y="714.9785">Consumer Application</text><path d="M9.6,63.9563 L9.6,111.9563 L351.6,111.9563 L351.6,75.9563 L339.6,63.9563 L9.6,63.9563 " fill="#FBFB77" filter="url(#fnzp9xyiux0bi)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M339.6,63.9563 L339.6,75.9563 L351.6,75.9563 L339.6,63.9563 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="316.8" x="16.8" y="84.4365">sending telemetry data with explicit value</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="188.4" x="16.8" y="102.5959">for ttd set to 60 seconds</text><polygon fill="#A80036" points="642.6,143.6344,654.6,148.4344,642.6,153.2344,647.4,148.4344" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="361.8" x2="649.8" y1="148.4344" y2="148.4344"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="266.4" x="370.2" y="142.3553">telemetry(hono-ttd="60", payload)</text><path d="M139.2,164.0344 L139.2,212.0344 L578.4,212.0344 L578.4,176.0344 L566.4,164.0344 L139.2,164.0344 " fill="#FBFB77" filter="url(#fnzp9xyiux0bi)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M566.4,164.0344 L566.4,176.0344 L578.4,176.0344 L566.4,164.0344 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="414" x="146.4" y="184.5146">The HTTP specific header "hono-ttd" is used to provide</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="270" x="146.4" y="202.674">the value for ttd by the device itself</text><path d="M476.4,229.1531 L476.4,313.1531 L831.6,313.1531 L831.6,241.1531 L819.6,229.1531 L476.4,229.1531 " fill="#FBFB77" filter="url(#fnzp9xyiux0bi)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M819.6,229.1531 L819.6,241.1531 L831.6,241.1531 L819.6,229.1531 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="193.2" x="483.6" y="249.6334">Set AMQP 1.0 properties:</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="483.6" y="267.7928">tenant-id: "TENANT",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="483.6" y="285.9521">device-id: "4711",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="330" x="483.6" y="304.1115">creation-time: NOW (in epoch milliseconds)</text><polygon fill="#A80036" points="1138.2,345.15,1150.2,349.95,1138.2,354.75,1143,349.95" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="657" x2="1145.4" y1="349.95" y2="349.95"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="466.8" x="665.4" y="343.8709">1.0 transfer("telemetry/TENANT", "4711", , creation-time, ttd)</text><polygon fill="#A80036" points="1444.2,380.1094,1456.2,384.9094,1444.2,389.7094,1449,384.9094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1152.6" x2="1451.4" y1="384.9094" y2="384.9094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="277.2" x="1161" y="378.8303">1.2 transfer("telemetry/TENANT", ...)</text><polygon fill="#A80036" points="1165.8,415.0687,1153.8,419.8688,1165.8,424.6688,1161,419.8688" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1158.6" x2="1457.4" y1="419.8688" y2="419.8688"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="1173" y="413.7896">2.0 disposition("accepted")</text><polygon fill="#A80036" points="670.2,450.0281,658.2,454.8281,670.2,459.6281,665.4,454.8281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="663" x2="1151.4" y1="454.8281" y2="454.8281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="677.4" y="448.749">2.0 disposition("accepted")</text><polygon fill="#A80036" points="375,484.9875,363,489.7875,375,494.5875,370.2,489.7875" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="367.8" x2="655.8" y1="489.7875" y2="489.7875"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="382.2" y="483.7084">HTTP/1.1 202 Accepted</text><path d="M1324.8,505.3875 L1324.8,535.3875 L1586.4,535.3875 L1586.4,517.3875 L1574.4,505.3875 L1324.8,505.3875 " fill="#FBFB77" filter="url(#fnzp9xyiux0bi)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M1574.4,505.3875 L1574.4,517.3875 L1586.4,517.3875 L1574.4,505.3875 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="236.4" x="1332" y="525.8678">Processing the telemetry data.</text><line style="stroke: #A80036; stroke-width: 1.2;" x1="1458.6" x2="1509" y1="571.7063" y2="571.7063"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1509" x2="1509" y1="571.7063" y2="587.3063"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1459.8" x2="1509" y1="587.3063" y2="587.3063"/><polygon fill="#A80036" points="1471.8,582.5063,1459.8,587.3063,1471.8,592.1062,1467,587.3063" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="253.2" x="1467" y="565.6271">callbackIfValid(creation-time, ttd)</text><path d="M1244.4,602.9063 L1244.4,668.9063 L1666.8,668.9063 L1666.8,614.9063 L1654.8,602.9063 L1244.4,602.9063 " fill="#FBFB77" filter="url(#fnzp9xyiux0bi)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M1654.8,602.9063 L1654.8,614.9063 L1666.8,614.9063 L1654.8,602.9063 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="397.2" x="1251.6" y="623.3865">React if message indicates that currently the device</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="237.6" x="1251.6" y="641.5459">is ready to receive a command</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="271.2" x="1251.6" y="659.7053">(e.g. by trying to send a command)</text><!--
+@startuml
+scale 1.2
+
+participant Device
+
+participant "HTTP Protocol Adapter"
+participant "AMQP 1.0 Network"
+participant "Consumer Application"
+
+note left of Device
+sending telemetry data with explicit value
+for ttd set to 60 seconds
+end note
+
+Device -> "HTTP Protocol Adapter": telemetry(hono-ttd="60", payload)
+note over Device
+The HTTP specific header "hono-ttd" is used to provide
+the value for ttd by the device itself
+end note
+
+
+
+note over "HTTP Protocol Adapter"
+Set AMQP 1.0 properties:
+tenant-id: "TENANT",
+device-id: "4711",
+creation-time: NOW (in epoch milliseconds)
+end note
+
+"HTTP Protocol Adapter" -> "AMQP 1.0 Network": 1.0 transfer("telemetry/TENANT", "4711", , creation-time, ttd)
+"AMQP 1.0 Network" -> "Consumer Application": 1.2 transfer("telemetry/TENANT", ...)
+"Consumer Application" -> "AMQP 1.0 Network": 2.0 disposition("accepted")
+"AMQP 1.0 Network" -> "HTTP Protocol Adapter": 2.0 disposition("accepted")
+
+"HTTP Protocol Adapter" -> Device: HTTP/1.1 202 Accepted
+
+note over "Consumer Application"
+Processing the telemetry data.
+end note
+
+
+
+"Consumer Application" -> "Consumer Application": callbackIfValid(creation-time, ttd)
+note over "Consumer Application"
+React if message indicates that currently the device
+is ready to receive a command
+(e.g. by trying to send a command)
+end note
+@enduml
+
+PlantUML version 1.2019.07beta1(Unknown compile time)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/concepts/device-notifications/index.html b/docs/concepts/device-notifications/index.html
index c321220..b747d4d 100644
--- a/docs/concepts/device-notifications/index.html
+++ b/docs/concepts/device-notifications/index.html
@@ -21,19 +21,19 @@
     <title>Device Notifications :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,7 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/device-notifications/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/device-notifications/" selected>stable (1.3)</option>
                     
                   
               
@@ -1287,24 +1344,14 @@
               
                   
               
+                  
+              
           
               
               
                   
               
                   
-                    
-                    
-                      <option id="1.1" value="/hono/docs/1.1/concepts/device-notifications/">1.1</option>
-                    
-                  
-              
-                  
-              
-                  
-              
-          
-              
               
                   
               
@@ -1313,12 +1360,10 @@
                   
                     
                     
-                      <option id="1.0" value="/hono/docs/1.0/concepts/device-notifications/">1.0</option>
+                      <option id="dev" value="/hono/docs/dev/concepts/device-notifications/">dev</option>
                     
                   
               
-                  
-              
           
         </select>
         <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
@@ -1381,7 +1426,7 @@
                   
                   
                   <div id="top-github-link">
-                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/concepts/device-notifications.md" target="blank">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/concepts/device-notifications/index.md" target="blank">
                       <i class="fas fa-code-branch"></i>
                       <span id="top-github-link-text">Edit this page</span>
                     </a>
@@ -1548,7 +1593,7 @@
 via the HTTP protocol adapter:</p>
 
 <figure>
-    <img src="../device_commandReadinessImplicit.svg"/> <figcaption>
+    <img src="device_commandReadinessImplicit.svg"/> <figcaption>
             <h4>Device command readiness with telemetry data</h4>
         </figcaption>
 </figure>
@@ -1558,7 +1603,7 @@
 via the HTTP protocol adapter:</p>
 
 <figure>
-    <img src="../device_commandReadinessExplicit.svg"/> <figcaption>
+    <img src="device_commandReadinessExplicit.svg"/> <figcaption>
             <h4>Device command readiness with explicit event</h4>
         </figcaption>
 </figure>
@@ -1887,6 +1932,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2095,6 +2156,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2497,20 +2590,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/concepts/device-provisioning/index.html b/docs/concepts/device-provisioning/index.html
index b4190e0..97f6d73 100644
--- a/docs/concepts/device-provisioning/index.html
+++ b/docs/concepts/device-provisioning/index.html
@@ -21,19 +21,19 @@
     <title>Device Provisioning :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/device-provisioning/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/device-provisioning/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/device-provisioning/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/device-provisioning/">1.1</option>
@@ -1313,6 +1392,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/device-provisioning/">dev</option>
@@ -1478,13 +1559,12 @@
 <p>Devices can be provisioned using Hono&rsquo;s <a href="/hono/docs/api/management/">Device Registry Management API</a> via HTTP.</p>
 
 <p>If the desired <em>tenant</em> does not yet exist, it must be created first.
-How to do this is described in the <a href="/hono/docs/user-guide/device-registry/#add-a-tenant">User Guide</a>
-of the Device Registry.</p>
+How to do this is described in the tenants section of the <a href="/hono/docs/api/management/">Device Registry Management API</a>.</p>
 
-<p>The actual Device Provisioning is then performed as described under
-<a href="/hono/docs/user-guide/device-registry/#register-device">Register Device</a>.
+<p>The actual Device Provisioning is then performed by adding devices as described under devices section of the
+<a href="/hono/docs/api/management/">Device Registry Management API</a>.
 This creates both a device identity and an (empty) credentials record. The last step is to add real credentials
-as described in <a href="/hono/docs/user-guide/device-registry/#update-credentials-for-a-device">Update Credentials for a Device</a>.</p>
+as described in the credentials section of the <a href="/hono/docs/api/management/">Device Registry Management API</a>.</p>
 
 <h2 id="automatic-device-provisioning">Automatic Device Provisioning</h2>
 
@@ -1873,6 +1953,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2081,6 +2177,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2483,20 +2611,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/concepts/index.html b/docs/concepts/index.html
index 152dba2..38c7a74 100644
--- a/docs/concepts/index.html
+++ b/docs/concepts/index.html
@@ -21,19 +21,19 @@
     <title>Concepts :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/">dev</option>
@@ -1772,6 +1855,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -1980,6 +2079,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2382,20 +2513,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/concepts/resource-limits/index.html b/docs/concepts/resource-limits/index.html
index fcdd2f2..d27dfd8 100644
--- a/docs/concepts/resource-limits/index.html
+++ b/docs/concepts/resource-limits/index.html
@@ -21,19 +21,19 @@
     <title>Resource limits :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/resource-limits/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/resource-limits/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/resource-limits/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/resource-limits/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/resource-limits/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/resource-limits/">dev</option>
@@ -1876,6 +1959,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2084,6 +2183,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2486,20 +2617,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/concepts/tenancy/index.html b/docs/concepts/tenancy/index.html
index fa3cd2e..5dcbd58 100644
--- a/docs/concepts/tenancy/index.html
+++ b/docs/concepts/tenancy/index.html
@@ -21,19 +21,19 @@
     <title>Multi-Tenancy :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,7 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/tenancy/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/tenancy/" selected>stable (1.3)</option>
                     
                   
               
@@ -1287,24 +1344,14 @@
               
                   
               
+                  
+              
           
               
               
                   
               
                   
-                    
-                    
-                      <option id="1.1" value="/hono/docs/1.1/concepts/tenancy/">1.1</option>
-                    
-                  
-              
-                  
-              
-                  
-              
-          
-              
               
                   
               
@@ -1313,12 +1360,10 @@
                   
                     
                     
-                      <option id="1.0" value="/hono/docs/1.0/concepts/tenancy/">1.0</option>
+                      <option id="dev" value="/hono/docs/dev/concepts/tenancy/">dev</option>
                     
                   
               
-                  
-              
           
         </select>
         <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
@@ -1381,7 +1426,7 @@
                   
                   
                   <div id="top-github-link">
-                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/concepts/tenancy.md" target="blank">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/concepts/tenancy/index.md" target="blank">
                       <i class="fas fa-code-branch"></i>
                       <span id="top-github-link-text">Edit this page</span>
                     </a>
@@ -1480,7 +1525,7 @@
 The API defines how to <em>retrieve</em> the details of a specific tenant. This offers the possibility to handle arbitrary
 properties on the level of a tenant (see e.g. <a href="#protocol-adapter-configuration">Protocol adapter configuration</a>).
 For convenience, there are CRUD operations for the handling of tenants, which can be found in the
-<a href="/hono/docs/user-guide/device-registry/#managing-tenants">Device Registry</a>.</p>
+<a href="/hono/docs/api/management/">Device Registry Management API</a>.</p>
 
 <h2 id="protocol-adapters-respect-the-tenant-api">Protocol Adapters respect the Tenant API</h2>
 
@@ -1514,14 +1559,13 @@
 
 <ul>
 <li><code>telemetry/TENANT</code></li>
+<li><code>event/TENANT</code></li>
 <li><code>registration/TENANT</code></li>
 </ul>
 
-<p>etc.</p>
-
 <p>This separates the AMQP endpoints from each other on a tenant level.</p>
 
-<p>The only exception to this is the <a href="/hono/docs/api/tenant/">Tenant API</a>, which does not follow this scheme since it
+<p>The only exception to this is the <a href="/hono/docs/api/tenant/">Tenant API</a> which does not follow this scheme since it
 is addressing the tenants themselves.</p>
 
 <h2 id="devices-and-tenants">Devices and Tenants</h2>
@@ -1533,7 +1577,7 @@
 <p>The following diagram shows the relation between tenants, devices and their credentials:</p>
 
 <figure>
-    <img src="../Tenants_Devices_Credentials.png"/> <figcaption>
+    <img src="tenants-devices-credentials.svg" width="60%"/> <figcaption>
             <h4>Tenants, Devices and Credentials</h4>
         </figcaption>
 </figure>
@@ -1925,6 +1969,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2133,6 +2193,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2535,20 +2627,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/concepts/tenancy/tenants-devices-credentials.svg b/docs/concepts/tenancy/tenants-devices-credentials.svg
new file mode 100644
index 0000000..267a65a
--- /dev/null
+++ b/docs/concepts/tenancy/tenants-devices-credentials.svg
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="74px" preserveAspectRatio="none" style="width:392px;height:74px;" version="1.1" viewBox="0 0 392 74" width="392px" zoomAndPan="magnify"><defs><filter height="300%" id="fdq52fhvxsihs" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.0"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.0" dy="4.0" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><!--MD5=[a8904d412b6bac905c960d0a15a57f60]
+class Tenant--><rect fill="#FEFECE" filter="url(#fdq52fhvxsihs)" height="48" id="Tenant" style="stroke: #A80036; stroke-width: 1.5;" width="72" x="7" y="7"/><ellipse cx="22" cy="23" fill="#ADD1B2" rx="11" ry="11" style="stroke: #A80036; stroke-width: 1.0;"/><path d="M24.3438,18.6719 C23.4063,18.2344 22.8125,18.0938 21.9375,18.0938 C19.3125,18.0938 17.3125,20.1719 17.3125,22.8906 L17.3125,24.0156 C17.3125,26.5938 19.4219,28.4844 22.3125,28.4844 C23.5313,28.4844 24.6875,28.1875 25.4375,27.6406 C26.0156,27.2344 26.3438,26.7813 26.3438,26.3906 C26.3438,25.9375 25.9531,25.5469 25.4844,25.5469 C25.2656,25.5469 25.0625,25.625 24.875,25.8125 C24.4219,26.2969 24.4219,26.2969 24.2344,26.3906 C23.8125,26.6563 23.125,26.7813 22.3594,26.7813 C20.3125,26.7813 19.0156,25.6875 19.0156,23.9844 L19.0156,22.8906 C19.0156,21.1094 20.2656,19.7969 22,19.7969 C22.5781,19.7969 23.1875,19.9531 23.6563,20.2031 C24.1406,20.4844 24.3125,20.7031 24.4063,21.1094 C24.4688,21.5156 24.5,21.6406 24.6406,21.7656 C24.7813,21.9063 25.0156,22.0156 25.2344,22.0156 C25.5,22.0156 25.7656,21.875 25.9375,21.6563 C26.0469,21.5 26.0781,21.3125 26.0781,20.8906 L26.0781,19.4688 C26.0781,19.0313 26.0625,18.9063 25.9688,18.75 C25.8125,18.4844 25.5313,18.3438 25.2344,18.3438 C24.9375,18.3438 24.7344,18.4375 24.5156,18.75 L24.3438,18.6719 Z "/><text fill="#000000" font-family="sans-serif" font-size="12" lengthAdjust="spacingAndGlyphs" textLength="40" x="36" y="27.1543">Tenant</text><line style="stroke: #A80036; stroke-width: 1.5;" x1="8" x2="78" y1="39" y2="39"/><line style="stroke: #A80036; stroke-width: 1.5;" x1="8" x2="78" y1="47" y2="47"/><!--MD5=[fc539fa3f3b7db9b31467e896d367b3b]
+class Device--><rect fill="#FEFECE" filter="url(#fdq52fhvxsihs)" height="48" id="Device" style="stroke: #A80036; stroke-width: 1.5;" width="74" x="139" y="7"/><ellipse cx="154" cy="23" fill="#ADD1B2" rx="11" ry="11" style="stroke: #A80036; stroke-width: 1.0;"/><path d="M156.3438,18.6719 C155.4063,18.2344 154.8125,18.0938 153.9375,18.0938 C151.3125,18.0938 149.3125,20.1719 149.3125,22.8906 L149.3125,24.0156 C149.3125,26.5938 151.4219,28.4844 154.3125,28.4844 C155.5313,28.4844 156.6875,28.1875 157.4375,27.6406 C158.0156,27.2344 158.3438,26.7813 158.3438,26.3906 C158.3438,25.9375 157.9531,25.5469 157.4844,25.5469 C157.2656,25.5469 157.0625,25.625 156.875,25.8125 C156.4219,26.2969 156.4219,26.2969 156.2344,26.3906 C155.8125,26.6563 155.125,26.7813 154.3594,26.7813 C152.3125,26.7813 151.0156,25.6875 151.0156,23.9844 L151.0156,22.8906 C151.0156,21.1094 152.2656,19.7969 154,19.7969 C154.5781,19.7969 155.1875,19.9531 155.6563,20.2031 C156.1406,20.4844 156.3125,20.7031 156.4063,21.1094 C156.4688,21.5156 156.5,21.6406 156.6406,21.7656 C156.7813,21.9063 157.0156,22.0156 157.2344,22.0156 C157.5,22.0156 157.7656,21.875 157.9375,21.6563 C158.0469,21.5 158.0781,21.3125 158.0781,20.8906 L158.0781,19.4688 C158.0781,19.0313 158.0625,18.9063 157.9688,18.75 C157.8125,18.4844 157.5313,18.3438 157.2344,18.3438 C156.9375,18.3438 156.7344,18.4375 156.5156,18.75 L156.3438,18.6719 Z "/><text fill="#000000" font-family="sans-serif" font-size="12" lengthAdjust="spacingAndGlyphs" textLength="42" x="168" y="27.1543">Device</text><line style="stroke: #A80036; stroke-width: 1.5;" x1="140" x2="212" y1="39" y2="39"/><line style="stroke: #A80036; stroke-width: 1.5;" x1="140" x2="212" y1="47" y2="47"/><!--MD5=[63e7a34560323ddebc94de26bb3dfe24]
+class Credentials--><rect fill="#FEFECE" filter="url(#fdq52fhvxsihs)" height="48" id="Credentials" style="stroke: #A80036; stroke-width: 1.5;" width="100" x="273" y="7"/><ellipse cx="288" cy="23" fill="#ADD1B2" rx="11" ry="11" style="stroke: #A80036; stroke-width: 1.0;"/><path d="M290.3438,18.6719 C289.4063,18.2344 288.8125,18.0938 287.9375,18.0938 C285.3125,18.0938 283.3125,20.1719 283.3125,22.8906 L283.3125,24.0156 C283.3125,26.5938 285.4219,28.4844 288.3125,28.4844 C289.5313,28.4844 290.6875,28.1875 291.4375,27.6406 C292.0156,27.2344 292.3438,26.7813 292.3438,26.3906 C292.3438,25.9375 291.9531,25.5469 291.4844,25.5469 C291.2656,25.5469 291.0625,25.625 290.875,25.8125 C290.4219,26.2969 290.4219,26.2969 290.2344,26.3906 C289.8125,26.6563 289.125,26.7813 288.3594,26.7813 C286.3125,26.7813 285.0156,25.6875 285.0156,23.9844 L285.0156,22.8906 C285.0156,21.1094 286.2656,19.7969 288,19.7969 C288.5781,19.7969 289.1875,19.9531 289.6563,20.2031 C290.1406,20.4844 290.3125,20.7031 290.4063,21.1094 C290.4688,21.5156 290.5,21.6406 290.6406,21.7656 C290.7813,21.9063 291.0156,22.0156 291.2344,22.0156 C291.5,22.0156 291.7656,21.875 291.9375,21.6563 C292.0469,21.5 292.0781,21.3125 292.0781,20.8906 L292.0781,19.4688 C292.0781,19.0313 292.0625,18.9063 291.9688,18.75 C291.8125,18.4844 291.5313,18.3438 291.2344,18.3438 C290.9375,18.3438 290.7344,18.4375 290.5156,18.75 L290.3438,18.6719 Z "/><text fill="#000000" font-family="sans-serif" font-size="12" lengthAdjust="spacingAndGlyphs" textLength="68" x="302" y="27.1543">Credentials</text><line style="stroke: #A80036; stroke-width: 1.5;" x1="274" x2="372" y1="39" y2="39"/><line style="stroke: #A80036; stroke-width: 1.5;" x1="274" x2="372" y1="47" y2="47"/><!--MD5=[59c30b2954e63bfb1dc3a20de84d1fda]
+reverse link Tenant to Device--><path d="M92.2193,31 C107.654,31 124.467,31 138.884,31 " fill="none" id="Tenant&lt;-Device" style="stroke: #A80036; stroke-width: 1.0;"/><polygon fill="#A80036" points="79.1056,31,85.1056,35,91.1056,31,85.1056,27,79.1056,31" style="stroke: #A80036; stroke-width: 1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="7" x="123.8877" y="44.5565">*</text><!--MD5=[af21fca250bb13019d9af04be242f9c9]
+reverse link Device to Credentials--><path d="M226.477,31 C241.457,31 257.9,31 272.858,31 " fill="none" id="Device&lt;-Credentials" style="stroke: #A80036; stroke-width: 1.0;"/><polygon fill="#A80036" points="213.216,31,219.216,35,225.216,31,219.216,27,213.216,31" style="stroke: #A80036; stroke-width: 1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="7" x="257.9793" y="44.1782">*</text><!--MD5=[98f50ff5198503f23c02de9c414a9e7d]
+@startuml
+left to right direction
+Tenant *- - "*" Device
+Device *- - "*" Credentials
+@enduml
+
+PlantUML version 1.2020.13(Sat Jun 13 12:26:38 UTC 2020)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file
diff --git a/docs/deployment/create-kubernetes-cluster/index.html b/docs/deployment/create-kubernetes-cluster/index.html
index 5252c8e..9a8a137 100644
--- a/docs/deployment/create-kubernetes-cluster/index.html
+++ b/docs/deployment/create-kubernetes-cluster/index.html
@@ -21,19 +21,19 @@
     <title>Setting up a Kubernetes Cluster :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/create-kubernetes-cluster/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/create-kubernetes-cluster/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/create-kubernetes-cluster/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/create-kubernetes-cluster/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/create-kubernetes-cluster/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/create-kubernetes-cluster/">dev</option>
@@ -1944,6 +2027,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2152,6 +2251,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2562,20 +2693,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/deployment/helm-based-deployment/index.html b/docs/deployment/helm-based-deployment/index.html
index 9a634e0..8cf24e2 100644
--- a/docs/deployment/helm-based-deployment/index.html
+++ b/docs/deployment/helm-based-deployment/index.html
@@ -21,19 +21,19 @@
     <title>Helm based Deployment :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/helm-based-deployment/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/helm-based-deployment/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/helm-based-deployment/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/helm-based-deployment/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/helm-based-deployment/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/helm-based-deployment/">dev</option>
@@ -1585,7 +1668,7 @@
 <p>The following command can then be used to return the IP address with which the Jaeger UI can be accessed in a
 browser (ensure <code>minikube tunnel</code> is running when using minikube):</p>
 
-<pre><code class="language-sh">kubectl get service hono-jaeger-query --output='jsonpath={.status.loadBalancer.ingress[0].ip}' -n hono
+<pre><code class="language-sh">kubectl get service eclipse-hono-jaeger-query --output=&quot;jsonpath={.status.loadBalancer.ingress[0]['hostname','ip']}&quot; -n hono
 </code></pre>
 
 <p>If no example Jaeger back end should be deployed but instead an existing Jaeger installation should be used,
@@ -2017,6 +2100,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2225,6 +2324,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2632,20 +2763,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/deployment/index.html b/docs/deployment/index.html
index b8f052d..b8dc361 100644
--- a/docs/deployment/index.html
+++ b/docs/deployment/index.html
@@ -21,19 +21,19 @@
     <title>Deployment :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/">dev</option>
@@ -1771,6 +1854,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -1979,6 +2078,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2385,20 +2516,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/deployment/openshift/index.html b/docs/deployment/openshift/index.html
index e8b58fc..f5ceeb2 100644
--- a/docs/deployment/openshift/index.html
+++ b/docs/deployment/openshift/index.html
@@ -21,19 +21,19 @@
     <title>OpenShift / OKD :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/openshift/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/openshift/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/openshift/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/openshift/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/openshift/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/openshift/">dev</option>
@@ -1788,6 +1871,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -1996,6 +2095,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2406,20 +2537,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/deployment/resource-limitation/index.html b/docs/deployment/resource-limitation/index.html
index fd5ad3e..6daa22c 100644
--- a/docs/deployment/resource-limitation/index.html
+++ b/docs/deployment/resource-limitation/index.html
@@ -21,19 +21,19 @@
     <title>Limiting Resource Usage :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/resource-limitation/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/resource-limitation/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/resource-limitation/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/resource-limitation/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/resource-limitation/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/resource-limitation/">dev</option>
@@ -1872,6 +1955,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2080,6 +2179,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2490,20 +2621,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev-guide/amqp_adapter_client/index.html b/docs/dev-guide/amqp_adapter_client/index.html
index d251cb7..aa740d4 100644
--- a/docs/dev-guide/amqp_adapter_client/index.html
+++ b/docs/dev-guide/amqp_adapter_client/index.html
@@ -21,19 +21,19 @@
     <title>AMQP Adapter Client for Java :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/dev-guide/amqp_adapter_client/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/dev-guide/amqp_adapter_client/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/amqp_adapter_client/">1.2</option>
                     
                   
               
@@ -1297,6 +1374,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/dev-guide/amqp_adapter_client/">dev</option>
@@ -1806,6 +1885,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2014,6 +2109,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2424,20 +2551,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev-guide/building_hono/index.html b/docs/dev-guide/building_hono/index.html
index 12cd267..42cb5b6 100644
--- a/docs/dev-guide/building_hono/index.html
+++ b/docs/dev-guide/building_hono/index.html
@@ -21,19 +21,19 @@
     <title>Building from Source :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/dev-guide/building_hono/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/dev-guide/building_hono/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/building_hono/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/dev-guide/building_hono/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/dev-guide/building_hono/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/dev-guide/building_hono/">dev</option>
@@ -1865,6 +1948,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2073,6 +2172,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2480,20 +2611,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev-guide/custom_http_adapter/index.html b/docs/dev-guide/custom_http_adapter/index.html
index 1805d1f..c4cfcf5 100644
--- a/docs/dev-guide/custom_http_adapter/index.html
+++ b/docs/dev-guide/custom_http_adapter/index.html
@@ -21,19 +21,19 @@
     <title>Implement a Custom Hono HTTP Protocol Adapter :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/dev-guide/custom_http_adapter/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/dev-guide/custom_http_adapter/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/custom_http_adapter/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/dev-guide/custom_http_adapter/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/dev-guide/custom_http_adapter/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/dev-guide/custom_http_adapter/">dev</option>
@@ -1899,6 +1982,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2107,6 +2206,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2517,20 +2648,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev-guide/index.html b/docs/dev-guide/index.html
index 1790082..d743b46 100644
--- a/docs/dev-guide/index.html
+++ b/docs/dev-guide/index.html
@@ -21,19 +21,19 @@
     <title>Developer Guide :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/dev-guide/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/dev-guide/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/dev-guide/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/dev-guide/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/dev-guide/">dev</option>
@@ -1771,6 +1854,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -1979,6 +2078,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2385,20 +2516,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev-guide/java_client_consumer/index.html b/docs/dev-guide/java_client_consumer/index.html
index 21601b7..d92dc67 100644
--- a/docs/dev-guide/java_client_consumer/index.html
+++ b/docs/dev-guide/java_client_consumer/index.html
@@ -21,19 +21,19 @@
     <title>Consuming Messages from Java :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/dev-guide/java_client_consumer/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/dev-guide/java_client_consumer/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/java_client_consumer/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/dev-guide/java_client_consumer/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/dev-guide/java_client_consumer/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/dev-guide/java_client_consumer/">dev</option>
@@ -1484,7 +1567,7 @@
 notified the device is disconnected again (<code>ttd == 0</code>).</p>
 
 <p>This application shall serve as a blueprint to integrate your existing java source code with Hono.
-Its code is found in the <a href="https://github.com/eclipse/hono/tree/master/example">example</a> module in the package <a href="https://github.com/eclipse/hono/tree/master/example/src/main/java/org/eclipse/hono/vertx/example">org.eclipse.hono.vertx.example</a>.</p>
+Its code is found in the <a href="https://github.com/eclipse/hono/tree/master/examples">example</a> module in the package <a href="https://github.com/eclipse/hono/tree/master/examples/hono-client-examples/src/main/java/org/eclipse/hono/vertx/example">org.eclipse.hono.vertx.example</a>.</p>
 
 <p>The provided classes are kept as simple as possible (in the tradition of a classical &ldquo;Hello World&rdquo; implementation) while still
 covering the most relevant messaging patterns (downstream and upstream messages).
@@ -1501,7 +1584,7 @@
 
 <h2 id="configure-the-example">Configure the example</h2>
 
-<p>For simplicity, all configurations are defined as Java constants inside the class <a href="https://github.com/eclipse/hono/blob/master/example/src/main/java/org/eclipse/hono/vertx/example/base/HonoExampleConstants.java">HonoExampleConstants</a>.</p>
+<p>For simplicity, all configurations are defined as Java constants inside the class <a href="https://github.com/eclipse/hono/blob/master/examples/hono-client-examples/src/main/java/org/eclipse/hono/vertx/example/base/HonoExampleConstants.java">HonoExampleConstants</a>.</p>
 
 <p>If you have Hono running in Docker under <code>localhost</code>, the example should work out of the box.</p>
 
@@ -1519,7 +1602,7 @@
 
 <p>It is started by</p>
 
-<pre><code class="language-sh"># in directory: hono/example/
+<pre><code class="language-sh"># in directory: hono/examples/
 mvn exec:java -Dexec.mainClass=org.eclipse.hono.vertx.example.HonoExampleApplication
 </code></pre>
 
@@ -1869,6 +1952,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2077,6 +2176,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2487,20 +2618,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/404.html b/docs/dev/404.html
index 91241a5..91bed97 100644
--- a/docs/dev/404.html
+++ b/docs/dev/404.html
@@ -18,16 +18,16 @@
   <title>404 Page not found</title>
   
    
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/horsey.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/horsey.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 <style type="text/css">
     :root #header + #content > #left > #rlblock_left {
diff --git a/docs/dev/admin-guide/amqp-adapter-config/index.html b/docs/dev/admin-guide/amqp-adapter-config/index.html
index dae9420..100c89a 100644
--- a/docs/dev/admin-guide/amqp-adapter-config/index.html
+++ b/docs/dev/admin-guide/amqp-adapter-config/index.html
@@ -21,19 +21,19 @@
     <title>AMQP Adapter Configuration :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/amqp-adapter-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/amqp-adapter-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/amqp-adapter-config/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/amqp-adapter-config/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/amqp-adapter-config/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/amqp-adapter-config/" selected>dev</option>
@@ -2758,20 +2784,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/admin-guide/amqp-network-config/index.html b/docs/dev/admin-guide/amqp-network-config/index.html
index b0016bb..8212d1c 100644
--- a/docs/dev/admin-guide/amqp-network-config/index.html
+++ b/docs/dev/admin-guide/amqp-network-config/index.html
@@ -21,19 +21,19 @@
     <title>AMQP 1.0 Messaging Network Configuration :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/amqp-network-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/amqp-network-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/amqp-network-config/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/amqp-network-config/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/amqp-network-config/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/amqp-network-config/" selected>dev</option>
@@ -2531,20 +2557,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/admin-guide/auth-server-config/index.html b/docs/dev/admin-guide/auth-server-config/index.html
index 11f318b..ad32af6 100644
--- a/docs/dev/admin-guide/auth-server-config/index.html
+++ b/docs/dev/admin-guide/auth-server-config/index.html
@@ -21,19 +21,19 @@
     <title>Auth Server Configuration :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/auth-server-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/auth-server-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/auth-server-config/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/auth-server-config/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/auth-server-config/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/auth-server-config/" selected>dev</option>
@@ -2744,20 +2770,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/admin-guide/coap-adapter-config/index.html b/docs/dev/admin-guide/coap-adapter-config/index.html
index 903e0ea..fca474c 100644
--- a/docs/dev/admin-guide/coap-adapter-config/index.html
+++ b/docs/dev/admin-guide/coap-adapter-config/index.html
@@ -21,19 +21,19 @@
     <title>CoAP Adapter Configuration :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1332,6 +1332,26 @@
               
               
                   
+                    
+                    
+                      <option id="stable" value="/hono/docs/admin-guide/coap-adapter-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
               
                   
               
@@ -2758,20 +2778,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/admin-guide/common-config/index.html b/docs/dev/admin-guide/common-config/index.html
index 0e344fa..088ead2 100644
--- a/docs/dev/admin-guide/common-config/index.html
+++ b/docs/dev/admin-guide/common-config/index.html
@@ -21,19 +21,19 @@
     <title>Common Configuration :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/common-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/common-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/common-config/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/common-config/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/common-config/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/common-config/" selected>dev</option>
@@ -2843,20 +2869,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/admin-guide/device-connection-config/index.html b/docs/dev/admin-guide/device-connection-config/index.html
index 4f471ed..77739ac 100644
--- a/docs/dev/admin-guide/device-connection-config/index.html
+++ b/docs/dev/admin-guide/device-connection-config/index.html
@@ -21,19 +21,19 @@
     <title>Configuring the Device Connection Service :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/device-connection-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/device-connection-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/device-connection-config/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/device-connection-config/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/device-connection-config/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/device-connection-config/" selected>dev</option>
@@ -2869,20 +2895,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/admin-guide/file-based-device-registry-config/index.html b/docs/dev/admin-guide/file-based-device-registry-config/index.html
index 96f9d42..607be52 100644
--- a/docs/dev/admin-guide/file-based-device-registry-config/index.html
+++ b/docs/dev/admin-guide/file-based-device-registry-config/index.html
@@ -21,19 +21,19 @@
     <title>File Based Device Registry Configuration :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1332,6 +1332,26 @@
               
               
                   
+                    
+                    
+                      <option id="stable" value="/hono/docs/admin-guide/file-based-device-registry-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
               
                   
               
@@ -2981,20 +3001,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/admin-guide/hono-client-configuration/index.html b/docs/dev/admin-guide/hono-client-configuration/index.html
index 90f359e..56e69d6 100644
--- a/docs/dev/admin-guide/hono-client-configuration/index.html
+++ b/docs/dev/admin-guide/hono-client-configuration/index.html
@@ -21,19 +21,19 @@
     <title>Hono Client Configuration :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/hono-client-configuration/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/hono-client-configuration/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/hono-client-configuration/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/hono-client-configuration/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/hono-client-configuration/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/hono-client-configuration/" selected>dev</option>
@@ -2832,20 +2858,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/admin-guide/http-adapter-config/index.html b/docs/dev/admin-guide/http-adapter-config/index.html
index 53181c0..8786951 100644
--- a/docs/dev/admin-guide/http-adapter-config/index.html
+++ b/docs/dev/admin-guide/http-adapter-config/index.html
@@ -21,19 +21,19 @@
     <title>HTTP Adapter Configuration :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/http-adapter-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/http-adapter-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/http-adapter-config/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/http-adapter-config/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/http-adapter-config/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/http-adapter-config/" selected>dev</option>
@@ -2730,20 +2756,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/admin-guide/index.html b/docs/dev/admin-guide/index.html
index 201325d..eefded7 100644
--- a/docs/dev/admin-guide/index.html
+++ b/docs/dev/admin-guide/index.html
@@ -21,19 +21,19 @@
     <title>Admin Guide :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/" selected>dev</option>
@@ -2496,20 +2522,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/admin-guide/kura-adapter-config/index.html b/docs/dev/admin-guide/kura-adapter-config/index.html
index e78761a..30a5d1b 100644
--- a/docs/dev/admin-guide/kura-adapter-config/index.html
+++ b/docs/dev/admin-guide/kura-adapter-config/index.html
@@ -21,19 +21,19 @@
     <title>Kura Adapter Configuration :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/kura-adapter-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/kura-adapter-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/kura-adapter-config/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/kura-adapter-config/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/kura-adapter-config/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/kura-adapter-config/" selected>dev</option>
@@ -2759,20 +2785,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/admin-guide/mongodb-device-registry-config/index.html b/docs/dev/admin-guide/mongodb-device-registry-config/index.html
index 0ef8ade..822e57f 100644
--- a/docs/dev/admin-guide/mongodb-device-registry-config/index.html
+++ b/docs/dev/admin-guide/mongodb-device-registry-config/index.html
@@ -21,19 +21,19 @@
     <title>MongoDB Based Device Registry Configuration :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1332,6 +1332,26 @@
               
               
                   
+                    
+                    
+                      <option id="stable" value="/hono/docs/admin-guide/mongodb-device-registry-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
               
                   
               
@@ -2844,20 +2864,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/admin-guide/monitoring-tracing-config/index.html b/docs/dev/admin-guide/monitoring-tracing-config/index.html
index 587f0b4..a0502de 100644
--- a/docs/dev/admin-guide/monitoring-tracing-config/index.html
+++ b/docs/dev/admin-guide/monitoring-tracing-config/index.html
@@ -21,19 +21,19 @@
     <title>Monitoring & Tracing :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/monitoring-tracing-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/monitoring-tracing-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/monitoring-tracing-config/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/monitoring-tracing-config/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/monitoring-tracing-config/" selected>dev</option>
@@ -2725,20 +2751,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/admin-guide/mqtt-adapter-config/index.html b/docs/dev/admin-guide/mqtt-adapter-config/index.html
index 87c6bc0..f7f1822 100644
--- a/docs/dev/admin-guide/mqtt-adapter-config/index.html
+++ b/docs/dev/admin-guide/mqtt-adapter-config/index.html
@@ -21,19 +21,19 @@
     <title>MQTT Adapter Configuration :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/mqtt-adapter-config/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/mqtt-adapter-config/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/mqtt-adapter-config/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/mqtt-adapter-config/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/mqtt-adapter-config/" selected>dev</option>
@@ -2793,20 +2819,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/admin-guide/secure_communication/index.html b/docs/dev/admin-guide/secure_communication/index.html
index 57da61a..5e76648 100644
--- a/docs/dev/admin-guide/secure_communication/index.html
+++ b/docs/dev/admin-guide/secure_communication/index.html
@@ -21,19 +21,19 @@
     <title>Secure Communication :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/admin-guide/secure_communication/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/admin-guide/secure_communication/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/admin-guide/secure_communication/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/admin-guide/secure_communication/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/admin-guide/secure_communication/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/admin-guide/secure_communication/" selected>dev</option>
@@ -2892,20 +2918,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/api/authentication/index.html b/docs/dev/api/authentication/index.html
index 03273e0..6aa53c2 100644
--- a/docs/dev/api/authentication/index.html
+++ b/docs/dev/api/authentication/index.html
@@ -21,19 +21,19 @@
     <title>Authentication API Specification :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/authentication/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/authentication/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/authentication/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/authentication/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/authentication/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/authentication/" selected>dev</option>
@@ -2679,20 +2705,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/api/command-and-control/index.html b/docs/dev/api/command-and-control/index.html
index 812a07a..6ba71d3 100644
--- a/docs/dev/api/command-and-control/index.html
+++ b/docs/dev/api/command-and-control/index.html
@@ -21,19 +21,19 @@
     <title>Command & Control API Specification :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/command-and-control/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/command-and-control/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/command-and-control/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/command-and-control/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/command-and-control/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/command-and-control/" selected>dev</option>
@@ -2900,20 +2926,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/api/credentials/index.html b/docs/dev/api/credentials/index.html
index c199fe8..f28c56d 100644
--- a/docs/dev/api/credentials/index.html
+++ b/docs/dev/api/credentials/index.html
@@ -21,19 +21,19 @@
     <title>Credentials API Specification :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/credentials/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/credentials/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/credentials/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/credentials/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/credentials/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/credentials/" selected>dev</option>
@@ -3172,20 +3198,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/api/device-connection/index.html b/docs/dev/api/device-connection/index.html
index 3b51d9f..2e47cf0 100644
--- a/docs/dev/api/device-connection/index.html
+++ b/docs/dev/api/device-connection/index.html
@@ -21,19 +21,19 @@
     <title>Device Connection API Specification :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/device-connection/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/device-connection/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/device-connection/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/device-connection/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/device-connection/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/device-connection/" selected>dev</option>
@@ -3301,20 +3327,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/api/device-registration/index.html b/docs/dev/api/device-registration/index.html
index dde983c..bdbb5bd 100644
--- a/docs/dev/api/device-registration/index.html
+++ b/docs/dev/api/device-registration/index.html
@@ -21,19 +21,19 @@
     <title>Device Registration API Specification :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/device-registration/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/device-registration/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/device-registration/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/device-registration/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/device-registration/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/device-registration/" selected>dev</option>
@@ -2787,20 +2813,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/api/event/index.html b/docs/dev/api/event/index.html
index 7d5a0b0..e3ba5a5 100644
--- a/docs/dev/api/event/index.html
+++ b/docs/dev/api/event/index.html
@@ -21,19 +21,19 @@
     <title>Event API Specification :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/event/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/event/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/event/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/event/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/event/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/event/" selected>dev</option>
@@ -2754,20 +2780,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/api/index.html b/docs/dev/api/index.html
index cd07bb3..d23f052 100644
--- a/docs/dev/api/index.html
+++ b/docs/dev/api/index.html
@@ -21,19 +21,19 @@
     <title>API :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/" selected>dev</option>
@@ -2498,20 +2524,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/api/management/index.html b/docs/dev/api/management/index.html
index 711a55c..466f997 100644
--- a/docs/dev/api/management/index.html
+++ b/docs/dev/api/management/index.html
@@ -21,19 +21,19 @@
     <title>Device Registry Management API Specification :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -86,14 +86,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1337,7 +1337,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/management/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/management/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/management/">1.2</option>
                     
                   
               
@@ -1353,6 +1373,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/management/">1.1</option>
@@ -1371,6 +1393,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/management/">1.0</option>
@@ -1389,6 +1413,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/management/" selected>dev</option>
@@ -2540,20 +2566,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/api/metrics/index.html b/docs/dev/api/metrics/index.html
index 5305f8f..6440046 100644
--- a/docs/dev/api/metrics/index.html
+++ b/docs/dev/api/metrics/index.html
@@ -21,19 +21,19 @@
     <title>Metrics :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/metrics/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/metrics/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/metrics/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/metrics/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/metrics/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/metrics/" selected>dev</option>
@@ -2777,20 +2803,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/api/telemetry/index.html b/docs/dev/api/telemetry/index.html
index 44d7e0d..9683d42 100644
--- a/docs/dev/api/telemetry/index.html
+++ b/docs/dev/api/telemetry/index.html
@@ -21,19 +21,19 @@
     <title>Telemetry API Specification :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/telemetry/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/telemetry/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/telemetry/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/telemetry/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/telemetry/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/telemetry/" selected>dev</option>
@@ -2723,20 +2749,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/api/tenant/index.html b/docs/dev/api/tenant/index.html
index 7f961f3..f957ece 100644
--- a/docs/dev/api/tenant/index.html
+++ b/docs/dev/api/tenant/index.html
@@ -21,19 +21,19 @@
     <title>Tenant API Specification :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/api/tenant/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/api/tenant/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/api/tenant/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/api/tenant/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/api/tenant/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/api/tenant/" selected>dev</option>
@@ -3247,20 +3273,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/architecture/auth/index.html b/docs/dev/architecture/auth/index.html
index 998e59a..5cf0ac4 100644
--- a/docs/dev/architecture/auth/index.html
+++ b/docs/dev/architecture/auth/index.html
@@ -21,19 +21,19 @@
     <title>Authentication/Authorization :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/architecture/auth/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/architecture/auth/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/architecture/auth/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/architecture/auth/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/architecture/auth/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/architecture/auth/" selected>dev</option>
@@ -2574,20 +2600,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/architecture/component-view/index.html b/docs/dev/architecture/component-view/index.html
index ca4db7b..9c8d627 100644
--- a/docs/dev/architecture/component-view/index.html
+++ b/docs/dev/architecture/component-view/index.html
@@ -21,19 +21,19 @@
     <title>Component View :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/architecture/component-view/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/architecture/component-view/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/architecture/component-view/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/architecture/component-view/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/architecture/component-view/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/architecture/component-view/" selected>dev</option>
@@ -2573,20 +2599,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/architecture/index.html b/docs/dev/architecture/index.html
index 662c615..daac2e4 100644
--- a/docs/dev/architecture/index.html
+++ b/docs/dev/architecture/index.html
@@ -21,19 +21,19 @@
     <title>Architecture :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/architecture/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/architecture/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/architecture/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/architecture/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/architecture/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/architecture/" selected>dev</option>
@@ -2496,20 +2522,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/categories/index.html b/docs/dev/categories/index.html
index 323ce11..b5de39f 100644
--- a/docs/dev/categories/index.html
+++ b/docs/dev/categories/index.html
@@ -21,19 +21,19 @@
     <title>Categories :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/categories/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/categories/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/categories/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/categories/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/categories/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/categories/" selected>dev</option>
@@ -2477,20 +2503,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/concepts/command-and-control/index.html b/docs/dev/concepts/command-and-control/index.html
index f161bb8..da76d9a 100644
--- a/docs/dev/concepts/command-and-control/index.html
+++ b/docs/dev/concepts/command-and-control/index.html
@@ -21,19 +21,19 @@
     <title>Command & Control :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1332,6 +1332,26 @@
               
               
                   
+                    
+                    
+                      <option id="stable" value="/hono/docs/concepts/command-and-control/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
               
                   
               
@@ -2628,20 +2648,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/concepts/command_control_concept.svg b/docs/dev/concepts/command_control_concept.svg
index 594d2cd..6c4041d 100644
--- a/docs/dev/concepts/command_control_concept.svg
+++ b/docs/dev/concepts/command_control_concept.svg
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="669.6px" preserveAspectRatio="none" style="width:1050px;height:669px;" version="1.1" viewBox="0 0 1050 669" width="1050px" zoomAndPan="magnify"><defs><filter height="300%" id="f1eh1at6g9lzf2" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#f1eh1at6g9lzf2)" height="414.7125" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="472.2" y="177.3937"/><rect fill="#FFFFFF" filter="url(#f1eh1at6g9lzf2)" height="332.7938" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="912.6" y="259.3125"/><rect fill="#FFFFFF" filter="url(#f1eh1at6g9lzf2)" height="137.4375" style="stroke: #000000; stroke-width: 2.4;" width="888" x="98.4" y="131.475"/><rect fill="#FFFFFF" filter="url(#f1eh1at6g9lzf2)" height="208.7156" style="stroke: #000000; stroke-width: 2.4;" width="938.4" x="98.4" y="285.7125"/><rect fill="#FFFFFF" filter="url(#f1eh1at6g9lzf2)" height="90.4781" style="stroke: #000000; stroke-width: 2.4;" width="888" x="98.4" y="511.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="148.8" x2="148.8" y1="45.9563" y2="622.1062"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="478.2" x2="478.2" y1="45.9563" y2="622.1062"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="918" x2="918" y1="45.9563" y2="622.1062"/><rect fill="#FEFECE" filter="url(#f1eh1at6g9lzf2)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#f1eh1at6g9lzf2)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="620.9063"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="644.9004">Device</text><rect fill="#FEFECE" filter="url(#f1eh1at6g9lzf2)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="373.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="382.2" y="27.5941">Hono Protocol Adapter</text><rect fill="#FEFECE" filter="url(#f1eh1at6g9lzf2)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="373.8" y="620.9063"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="382.2" y="644.9004">Hono Protocol Adapter</text><rect fill="#FEFECE" filter="url(#f1eh1at6g9lzf2)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="862.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="871.2" y="27.5941">Application</text><rect fill="#FEFECE" filter="url(#f1eh1at6g9lzf2)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="862.8" y="620.9063"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="871.2" y="644.9004">Application</text><rect fill="#FFFFFF" filter="url(#f1eh1at6g9lzf2)" height="414.7125" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="472.2" y="177.3937"/><rect fill="#FFFFFF" filter="url(#f1eh1at6g9lzf2)" height="332.7938" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="912.6" y="259.3125"/><path d="M9.6,63.9563 L9.6,111.9563 L285.6,111.9563 L285.6,75.9563 L273.6,63.9563 L9.6,63.9563 " fill="#FBFB77" filter="url(#f1eh1at6g9lzf2)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M273.6,63.9563 L273.6,75.9563 L285.6,75.9563 L273.6,63.9563 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="217.2" x="16.8" y="84.4365">The device is connected and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="250.8" x="16.8" y="102.5959">authenticated with TENANT/4711</text><path d="M98.4,131.475 L357.6,131.475 L357.6,139.875 L345.6,151.875 L98.4,151.875 L98.4,131.475 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="137.4375" style="stroke: #000000; stroke-width: 2.4;" width="888" x="98.4" y="131.475"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="116.4" y="147.1553">Command subscription</text><polygon fill="#A80036" points="457.8,172.5938,469.8,177.3937,457.8,182.1938,462.6,177.3937" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="465" y1="177.3937" y2="177.3937"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="157.8" y="171.3146">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="284.4" x="173.4" y="171.3146">Command subscription / TTD request</text><path d="M315.6,192.9938 L315.6,222.9938 L634.8,222.9938 L634.8,204.9938 L622.8,192.9938 L315.6,192.9938 " fill="#FBFB77" filter="url(#f1eh1at6g9lzf2)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M622.8,192.9938 L622.8,204.9938 L634.8,204.9938 L622.8,192.9938 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="294" x="322.8" y="213.474">Command consumer links are created</text><polygon fill="#A80036" points="898.2,254.5125,910.2,259.3125,898.2,264.1125,903,259.3125" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="484.2" x2="905.4" y1="259.3125" y2="259.3125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="492.6" y="253.2334">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="350.4" x="508.2" y="253.2334">transfer("event/TENANT","4711","ttd=${ttd}")</text><path d="M98.4,285.7125 L325.2,285.7125 L325.2,294.1125 L313.2,306.1125 L98.4,306.1125 L98.4,285.7125 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="208.7156" style="stroke: #000000; stroke-width: 2.4;" width="938.4" x="98.4" y="285.7125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="116.4" y="301.3928">Command handling</text><path d="M812.4,312.2719 L812.4,360.2719 L1020,360.2719 L1020,324.2719 L1008,312.2719 L812.4,312.2719 " fill="#FBFB77" filter="url(#f1eh1at6g9lzf2)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M1008,312.2719 L1008,324.2719 L1020,324.2719 L1008,312.2719 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="819.6" y="332.7521">Create sender link and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="182.4" x="819.6" y="350.9115">response consumer link</text><polygon fill="#A80036" points="497.4,410.1094,485.4,414.9094,497.4,419.7094,492.6,414.9094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="490.2" x2="911.4" y1="414.9094" y2="414.9094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="504.6" y="399.7506">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="226.8" x="520.2" y="390.6709">transfer("command/TENANT",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="525" y="408.8303">"command/TENANT/4711","${payload}")</text><polygon fill="#A80036" points="162.6,445.0687,150.6,449.8688,162.6,454.6688,157.8,449.8688" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="155.4" x2="471" y1="449.8688" y2="449.8688"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="169.8" y="443.7896">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="249.6" x="185.4" y="443.7896">Command is published to device</text><polygon fill="#A80036" points="898.2,480.0281,910.2,484.8281,898.2,489.6281,903,484.8281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="484.2" x2="905.4" y1="484.8281" y2="484.8281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="492.6" y="478.749">5</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="508.2" y="478.749">disposition("accepted")</text><path d="M98.4,511.2281 L412.8,511.2281 L412.8,519.6281 L400.8,531.6281 L98.4,531.6281 L98.4,511.2281 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="90.4781" style="stroke: #000000; stroke-width: 2.4;" width="888" x="98.4" y="511.2281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="260.4" x="116.4" y="526.9084">Command response handling</text><polygon fill="#A80036" points="457.8,552.3469,469.8,557.1469,457.8,561.9469,462.6,557.1469" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="465" y1="557.1469" y2="557.1469"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="157.8" y="551.0678">6</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="260.4" x="173.4" y="551.0678">Device sends command response</text><polygon fill="#A80036" points="904.2,587.3063,916.2,592.1062,904.2,596.9063,909,592.1062" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="478.2" x2="911.4" y1="592.1062" y2="592.1062"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="486.6" y="586.0271">7</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="384" x="502.2" y="586.0271">transfer("${reply-to}","status=200","${payload}")</text><!--MD5=[143d5ea5a7b99b91c1366dbbd0bf0fec]
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="669.6px" preserveAspectRatio="none" style="width:1050px;height:669px;" version="1.1" viewBox="0 0 1050 669" width="1050px" zoomAndPan="magnify"><defs><filter height="300%" id="fngzrirs0jsbq" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="414.7125" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="472.2" y="177.3937"/><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="332.7938" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="912.6" y="259.3125"/><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="137.4375" style="stroke: #000000; stroke-width: 2.4;" width="888" x="98.4" y="131.475"/><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="208.7156" style="stroke: #000000; stroke-width: 2.4;" width="938.4" x="98.4" y="285.7125"/><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="90.4781" style="stroke: #000000; stroke-width: 2.4;" width="888" x="98.4" y="511.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="148.8" x2="148.8" y1="45.9563" y2="622.1062"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="478.2" x2="478.2" y1="45.9563" y2="622.1062"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="918" x2="918" y1="45.9563" y2="622.1062"/><rect fill="#FEFECE" filter="url(#fngzrirs0jsbq)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="27.5941">Device</text><rect fill="#FEFECE" filter="url(#fngzrirs0jsbq)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="620.9063"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="644.9004">Device</text><rect fill="#FEFECE" filter="url(#fngzrirs0jsbq)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="373.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="382.2" y="27.5941">Hono Protocol Adapter</text><rect fill="#FEFECE" filter="url(#fngzrirs0jsbq)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="373.8" y="620.9063"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="382.2" y="644.9004">Hono Protocol Adapter</text><rect fill="#FEFECE" filter="url(#fngzrirs0jsbq)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="862.8" y="3.6"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="871.2" y="27.5941">Application</text><rect fill="#FEFECE" filter="url(#fngzrirs0jsbq)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="862.8" y="620.9063"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="871.2" y="644.9004">Application</text><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="414.7125" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="472.2" y="177.3937"/><rect fill="#FFFFFF" filter="url(#fngzrirs0jsbq)" height="332.7938" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="912.6" y="259.3125"/><path d="M9.6,63.9563 L9.6,111.9563 L285.6,111.9563 L285.6,75.9563 L273.6,63.9563 L9.6,63.9563 " fill="#FBFB77" filter="url(#fngzrirs0jsbq)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M273.6,63.9563 L273.6,75.9563 L285.6,75.9563 L273.6,63.9563 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="217.2" x="16.8" y="84.4365">The device is connected and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="250.8" x="16.8" y="102.5959">authenticated with TENANT/4711</text><path d="M98.4,131.475 L357.6,131.475 L357.6,139.875 L345.6,151.875 L98.4,151.875 L98.4,131.475 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="137.4375" style="stroke: #000000; stroke-width: 2.4;" width="888" x="98.4" y="131.475"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="116.4" y="147.1553">Command subscription</text><polygon fill="#A80036" points="457.8,172.5938,469.8,177.3937,457.8,182.1938,462.6,177.3937" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="465" y1="177.3937" y2="177.3937"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="157.8" y="171.3146">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="284.4" x="173.4" y="171.3146">Command subscription / TTD request</text><path d="M273.6,192.9938 L273.6,222.9938 L678,222.9938 L678,204.9938 L666,192.9938 L273.6,192.9938 " fill="#FBFB77" filter="url(#fngzrirs0jsbq)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M666,192.9938 L666,204.9938 L678,204.9938 L666,192.9938 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="379.2" x="280.8" y="213.474">Ensure Command consumer link for tenant exists</text><polygon fill="#A80036" points="898.2,254.5125,910.2,259.3125,898.2,264.1125,903,259.3125" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="484.2" x2="905.4" y1="259.3125" y2="259.3125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="492.6" y="253.2334">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="350.4" x="508.2" y="253.2334">transfer("event/TENANT","4711","ttd=${ttd}")</text><path d="M98.4,285.7125 L325.2,285.7125 L325.2,294.1125 L313.2,306.1125 L98.4,306.1125 L98.4,285.7125 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="208.7156" style="stroke: #000000; stroke-width: 2.4;" width="938.4" x="98.4" y="285.7125"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="116.4" y="301.3928">Command handling</text><path d="M812.4,312.2719 L812.4,360.2719 L1020,360.2719 L1020,324.2719 L1008,312.2719 L812.4,312.2719 " fill="#FBFB77" filter="url(#fngzrirs0jsbq)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M1008,312.2719 L1008,324.2719 L1020,324.2719 L1008,312.2719 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="819.6" y="332.7521">Create sender link and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="182.4" x="819.6" y="350.9115">response consumer link</text><polygon fill="#A80036" points="497.4,410.1094,485.4,414.9094,497.4,419.7094,492.6,414.9094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="490.2" x2="911.4" y1="414.9094" y2="414.9094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="504.6" y="399.7506">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="226.8" x="520.2" y="390.6709">transfer("command/TENANT",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="525" y="408.8303">"command/TENANT/4711","${payload}")</text><polygon fill="#A80036" points="162.6,445.0687,150.6,449.8688,162.6,454.6688,157.8,449.8688" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="155.4" x2="471" y1="449.8688" y2="449.8688"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="169.8" y="443.7896">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="249.6" x="185.4" y="443.7896">Command is published to device</text><polygon fill="#A80036" points="898.2,480.0281,910.2,484.8281,898.2,489.6281,903,484.8281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="484.2" x2="905.4" y1="484.8281" y2="484.8281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="492.6" y="478.749">5</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="508.2" y="478.749">disposition("accepted")</text><path d="M98.4,511.2281 L412.8,511.2281 L412.8,519.6281 L400.8,531.6281 L98.4,531.6281 L98.4,511.2281 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="90.4781" style="stroke: #000000; stroke-width: 2.4;" width="888" x="98.4" y="511.2281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="260.4" x="116.4" y="526.9084">Command response handling</text><polygon fill="#A80036" points="457.8,552.3469,469.8,557.1469,457.8,561.9469,462.6,557.1469" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="465" y1="557.1469" y2="557.1469"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="157.8" y="551.0678">6</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="260.4" x="173.4" y="551.0678">Device sends command response</text><polygon fill="#A80036" points="904.2,587.3063,916.2,592.1062,904.2,596.9063,909,592.1062" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="478.2" x2="911.4" y1="592.1062" y2="592.1062"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="486.6" y="586.0271">7</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="384" x="502.2" y="586.0271">transfer("${reply-to}","status=200","${payload}")</text><!--MD5=[e0e07f50b6ca463e3c049d624b0d9900]
 @startuml
 scale 1.2
 
@@ -16,7 +16,7 @@
     Device -> "Hono Protocol Adapter": Command subscription / TTD request
     activate "Hono Protocol Adapter"
     note over "Hono Protocol Adapter"
-    Command consumer links are created
+    Ensure Command consumer link for tenant exists
     end note
     "Hono Protocol Adapter" -> Application: transfer("event/TENANT","4711","ttd=${ttd}")
     activate Application
diff --git a/docs/dev/concepts/command_control_concept_delegate_1.svg b/docs/dev/concepts/command_control_concept_delegate_1.svg
index a191e61..dfc24a9 100644
--- a/docs/dev/concepts/command_control_concept_delegate_1.svg
+++ b/docs/dev/concepts/command_control_concept_delegate_1.svg
@@ -1,20 +1,19 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="495.6px" preserveAspectRatio="none" style="width:1159px;height:495px;" version="1.1" viewBox="0 0 1159 495" width="1159.2px" zoomAndPan="magnify"><defs><filter height="300%" id="f14y3nnq0zl06i" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="469.7438" style="stroke: #A80036; stroke-width: 1.2;" width="544.8" x="286.8" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="536.4" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="142.2375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="365.4" y="328.7063"/><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1072.2" y="451.7438"/><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="196.7156" style="stroke: #000000; stroke-width: 2.4;" width="1047.6" x="98.4" y="264.6281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="148.8" x2="148.8" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="370.8" x2="370.8" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="542.4" x2="542.4" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="736.8" x2="736.8" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="924" x2="924" y1="89.6719" y2="481.7438"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1077.6" x2="1077.6" y1="89.6719" y2="481.7438"/><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="71.3098">Device</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="291.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="300" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="318.6" y="71.3098">instance #1</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="463.2" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="471.6" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="490.2" y="71.3098">instance #2</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="648" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="656.4" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="672" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="838.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="847.2" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="888.6" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f14y3nnq0zl06i)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1022.4" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1030.8" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="142.2375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="365.4" y="328.7063"/><rect fill="#FFFFFF" filter="url(#f14y3nnq0zl06i)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1072.2" y="451.7438"/><polygon fill="#A80036" points="910.2,176.7094,922.2,181.5094,910.2,186.3094,915,181.5094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="543" x2="917.4" y1="181.5094" y2="181.5094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="551.4" y="148.1912">0</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="567" y="120.9521">Consumer link on</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="156" x="567" y="139.1115">"command/TENANT"</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="148.8" x="567" y="157.2709">created for another</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="92.4" x="567" y="175.4303">subscription</text><path d="M9.6,197.1094 L9.6,245.1094 L285.6,245.1094 L285.6,209.1094 L273.6,197.1094 L9.6,197.1094 " fill="#FBFB77" filter="url(#f14y3nnq0zl06i)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M273.6,197.1094 L273.6,209.1094 L285.6,209.1094 L273.6,197.1094 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="217.2" x="16.8" y="217.5896">The device is connected and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="250.8" x="16.8" y="235.749">authenticated with TENANT/4711</text><path d="M98.4,264.6281 L357.6,264.6281 L357.6,273.0281 L345.6,285.0281 L98.4,285.0281 L98.4,264.6281 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="196.7156" style="stroke: #000000; stroke-width: 2.4;" width="1047.6" x="98.4" y="264.6281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="116.4" y="280.3084">Command subscription</text><polygon fill="#A80036" points="351,323.9063,363,328.7063,351,333.5062,355.8,328.7063" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="358.2" y1="328.7063" y2="328.7063"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="157.8" y="313.5475">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="173.4" y="304.4678">Command subscription</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="102" x="178.2" y="322.6271">/ TTD request</text><polygon fill="#A80036" points="910.2,358.8656,922.2,363.6656,910.2,368.4656,915,363.6656" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="377.4" x2="917.4" y1="363.6656" y2="363.6656"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="385.8" y="357.5865">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="300" x="401.4" y="357.5865">attach("receiver", "command/TENANT")</text><polygon fill="#A80036" points="723,411.9844,735,416.7844,723,421.5844,727.8,416.7844" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="377.4" x2="730.2" y1="416.7844" y2="416.7844"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="385.8" y="401.6256">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="401.4" y="392.5459">set command handling adapter instance</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="300" x="401.4" y="410.7053">for device 4711 to adapter instance #1</text><polygon fill="#A80036" points="1057.8,446.9437,1069.8,451.7438,1057.8,456.5438,1062.6,451.7438" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="377.4" x2="1065" y1="451.7438" y2="451.7438"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="385.8" y="445.6646">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="585.6" x="401.4" y="445.6646">transfer("event/TENANT","4711","ttd=${ttd}")  via AMQP messaging network</text><!--MD5=[c8b432715fa26176d4dfd933528d308b]
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="477.6px" preserveAspectRatio="none" style="width:1088px;height:477px;" version="1.1" viewBox="0 0 1088 477" width="1088.4px" zoomAndPan="magnify"><defs><filter height="300%" id="f1hmhg3jewutza" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="451.5844" style="stroke: #A80036; stroke-width: 1.2;" width="439.2" x="262.2" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="459" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f1hmhg3jewutza)" height="124.0781" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="365.4" y="328.7063"/><rect fill="#FFFFFF" filter="url(#f1hmhg3jewutza)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1001.4" y="433.5844"/><rect fill="#FFFFFF" filter="url(#f1hmhg3jewutza)" height="178.5563" style="stroke: #000000; stroke-width: 2.4;" width="976.8" x="98.4" y="264.6281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="148.8" x2="148.8" y1="89.6719" y2="463.5844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="371.4" x2="371.4" y1="89.6719" y2="463.5844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="592.2" x2="592.2" y1="89.6719" y2="463.5844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="793.8" x2="793.8" y1="89.6719" y2="463.5844"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1006.8" x2="1006.8" y1="89.6719" y2="463.5844"/><rect fill="#FEFECE" filter="url(#f1hmhg3jewutza)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="110.4" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="118.8" y="71.3098">Device</text><rect fill="#FEFECE" filter="url(#f1hmhg3jewutza)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="267" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="275.4" y="51.7535">Hono Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="325.8" y="71.3098">instance 1</text><rect fill="#FEFECE" filter="url(#f1hmhg3jewutza)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="487.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="496.2" y="51.7535">Hono Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="546.6" y="71.3098">instance 2</text><rect fill="#FEFECE" filter="url(#f1hmhg3jewutza)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="708.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="717" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="758.4" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f1hmhg3jewutza)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="951.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="960" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#f1hmhg3jewutza)" height="124.0781" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="365.4" y="328.7063"/><rect fill="#FFFFFF" filter="url(#f1hmhg3jewutza)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="1001.4" y="433.5844"/><polygon fill="#A80036" points="780,176.7094,792,181.5094,780,186.3094,784.8,181.5094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="592.2" x2="787.2" y1="181.5094" y2="181.5094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="600.6" y="148.1912">0</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="616.2" y="120.9521">Consumer link on</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="156" x="616.2" y="139.1115">"command/TENANT"</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="148.8" x="616.2" y="157.2709">created for another</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="92.4" x="616.2" y="175.4303">subscription</text><path d="M9.6,197.1094 L9.6,245.1094 L285.6,245.1094 L285.6,209.1094 L273.6,197.1094 L9.6,197.1094 " fill="#FBFB77" filter="url(#f1hmhg3jewutza)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M273.6,197.1094 L273.6,209.1094 L285.6,209.1094 L273.6,197.1094 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="217.2" x="16.8" y="217.5896">The device is connected and</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="250.8" x="16.8" y="235.749">authenticated with TENANT/4711</text><path d="M98.4,264.6281 L357.6,264.6281 L357.6,273.0281 L345.6,285.0281 L98.4,285.0281 L98.4,264.6281 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="178.5563" style="stroke: #000000; stroke-width: 2.4;" width="976.8" x="98.4" y="264.6281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="116.4" y="280.3084">Command subscription</text><polygon fill="#A80036" points="351,323.9063,363,328.7063,351,333.5062,355.8,328.7063" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="149.4" x2="358.2" y1="328.7063" y2="328.7063"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="157.8" y="313.5475">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="173.4" y="304.4678">Command subscription</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="102" x="178.2" y="322.6271">/ TTD request</text><polygon fill="#A80036" points="780,358.8656,792,363.6656,780,368.4656,784.8,363.6656" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="377.4" x2="787.2" y1="363.6656" y2="363.6656"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="385.8" y="357.5865">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="300" x="401.4" y="357.5865">attach("receiver", "command/TENANT")</text><polygon fill="#A80036" points="780,393.825,792,398.625,780,403.425,784.8,398.625" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="377.4" x2="787.2" y1="398.625" y2="398.625"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="385.8" y="392.5459">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="318" x="401.4" y="392.5459">attach("receiver", "control/TENANT/4711")</text><polygon fill="#A80036" points="987,428.7844,999,433.5844,987,438.3844,991.8,433.5844" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="377.4" x2="994.2" y1="433.5844" y2="433.5844"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="385.8" y="427.5053">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="585.6" x="401.4" y="427.5053">transfer("event/TENANT","4711","ttd=${ttd}")  via AMQP messaging network</text><!--MD5=[5ba83c9aca794515c9d86136c39b294c]
 @startuml
 scale 1.2
 hide footbox
 
 participant Device order 10
 box "Hono"
-    participant "Protocol Adapter\ninstance #1" order 30
-    participant "Protocol Adapter\ninstance #2" order 40
-    participant "Device Connection\nAPI component" order 50
+    participant "Hono Protocol Adapter\ninstance 1" order 30
+    participant "Hono Protocol Adapter\ninstance 2" order 40
 end box
 participant "AMQP messaging \nnetwork" order 60
 participant Application order 70
 
 autonumber 0
 
-"Protocol Adapter\ninstance #2" -> "AMQP messaging \nnetwork": Consumer link on \n"command/TENANT"\ncreated for another \nsubscription
+"Hono Protocol Adapter\ninstance 2" -> "AMQP messaging \nnetwork": Consumer link on \n"command/TENANT"\ncreated for another \nsubscription
 
 note over Device
 The device is connected and
@@ -23,13 +22,13 @@
 
 group Command subscription
 
-    Device -> "Protocol Adapter\ninstance #1": Command subscription\n / TTD request
-    activate "Protocol Adapter\ninstance #1"
+    Device -> "Hono Protocol Adapter\ninstance 1": Command subscription\n / TTD request
+    activate "Hono Protocol Adapter\ninstance 1"
 
-    "Protocol Adapter\ninstance #1" -> "AMQP messaging \nnetwork": attach("receiver", "command/TENANT")
-    "Protocol Adapter\ninstance #1" -> "Device Connection\nAPI component": set command handling adapter instance \nfor device 4711 to adapter instance #1
+    "Hono Protocol Adapter\ninstance 1" -> "AMQP messaging \nnetwork": attach("receiver", "command/TENANT")
+    "Hono Protocol Adapter\ninstance 1" -> "AMQP messaging \nnetwork": attach("receiver", "control/TENANT/4711")
 
-    "Protocol Adapter\ninstance #1" -> Application: transfer("event/TENANT","4711","ttd=${ttd}")  via AMQP messaging network
+    "Hono Protocol Adapter\ninstance 1" -> Application: transfer("event/TENANT","4711","ttd=${ttd}")  via AMQP messaging network
     activate Application
 end
 @enduml
diff --git a/docs/dev/concepts/command_control_concept_delegate_2.svg b/docs/dev/concepts/command_control_concept_delegate_2.svg
index f0ec018..ac27c16 100644
--- a/docs/dev/concepts/command_control_concept_delegate_2.svg
+++ b/docs/dev/concepts/command_control_concept_delegate_2.svg
@@ -1,12 +1,13 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="620.4px" preserveAspectRatio="none" style="width:1166px;height:620px;" version="1.1" viewBox="0 0 1166 620" width="1166.4px" zoomAndPan="magnify"><defs><filter height="300%" id="fgdssr93bvf" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="594.1406" style="stroke: #A80036; stroke-width: 1.2;" width="439.2" x="177" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="373.8" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#fgdssr93bvf)" height="136.3969" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="501" y="316.7063"/><rect fill="#FFFFFF" filter="url(#fgdssr93bvf)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="867" y="453.1031"/><rect fill="#FFFFFF" filter="url(#fgdssr93bvf)" height="475.6688" style="stroke: #000000; stroke-width: 2.4;" width="1137.6" x="15.6" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="66" x2="66" y1="89.6719" y2="606.1406"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="286.2" x2="286.2" y1="89.6719" y2="606.1406"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="507" x2="507" y1="89.6719" y2="606.1406"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="872.4" x2="872.4" y1="89.6719" y2="606.1406"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1084.8" x2="1084.8" y1="89.6719" y2="606.1406"/><rect fill="#FEFECE" filter="url(#fgdssr93bvf)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="27.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="36" y="71.3098">Device</text><rect fill="#FEFECE" filter="url(#fgdssr93bvf)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="181.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="190.2" y="51.7535">Hono Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="240.6" y="71.3098">instance 1</text><rect fill="#FEFECE" filter="url(#fgdssr93bvf)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="402.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="411" y="51.7535">Hono Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="461.4" y="71.3098">instance 2</text><rect fill="#FEFECE" filter="url(#fgdssr93bvf)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="787.2" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="795.6" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="837" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#fgdssr93bvf)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1029.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1038" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#fgdssr93bvf)" height="136.3969" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="501" y="316.7063"/><rect fill="#FFFFFF" filter="url(#fgdssr93bvf)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="867" y="453.1031"/><path d="M15.6,110.0719 L242.4,110.0719 L242.4,118.4719 L230.4,130.4719 L15.6,130.4719 L15.6,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="475.6688" style="stroke: #000000; stroke-width: 2.4;" width="1137.6" x="15.6" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="33.6" y="125.7521">Command handling</text><polygon fill="#A80036" points="886.2,187.5094,874.2,192.3094,886.2,197.1094,881.4,192.3094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="879" x2="1084.2" y1="192.3094" y2="192.3094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="893.4" y="168.0709">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="909" y="149.9115">attach("receiver",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="168" x="909" y="168.0709">"command_response/</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="913.8" y="186.2303">TENANT/${replyId}")</text><polygon fill="#A80036" points="886.2,240.6281,874.2,245.4281,886.2,250.2281,881.4,245.4281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="879" x2="1084.2" y1="245.4281" y2="245.4281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="893.4" y="230.2693">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="124.8" x="909" y="221.1896">attach("sender",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="162" x="909" y="239.349">"command/TENANT")</text><polygon fill="#A80036" points="526.2,311.9063,514.2,316.7063,526.2,321.5062,521.4,316.7063" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="519" x2="1084.2" y1="316.7063" y2="316.7063"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="533.4" y="292.4678">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="226.8" x="549" y="274.3084">transfer("command/TENANT",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="553.8" y="292.4678">"command/TENANT/4711","${payload}")</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="563.4" y="310.6271">via AMQP messaging network</text><path d="M388.8,332.3063 L388.8,398.3063 L619.2,398.3063 L619.2,344.3063 L607.2,332.3063 L388.8,332.3063 " fill="#FBFB77" filter="url(#fgdssr93bvf)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M607.2,332.3063 L607.2,344.3063 L619.2,344.3063 L607.2,332.3063 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="194.4" x="396" y="352.7865">Check if command needs</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="196.8" x="396" y="370.9459">to be mapped to gateway</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="396" y="389.1053">(no mapping needed here)</text><polygon fill="#A80036" points="852.6,448.3031,864.6,453.1031,852.6,457.9031,857.4,453.1031" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="507" x2="859.8" y1="453.1031" y2="453.1031"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="515.4" y="437.9443">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="244.8" x="531" y="428.8646">transfer("control/TENANT/4711",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="535.8" y="447.024">"command/TENANT/4711","${payload}")</text><polygon fill="#A80036" points="299.4,501.4219,287.4,506.2219,299.4,511.0219,294.6,506.2219" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="292.2" x2="871.8" y1="506.2219" y2="506.2219"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="306.6" y="491.0631">5</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="244.8" x="322.2" y="481.9834">transfer("control/TENANT/4711",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="327" y="500.1428">"command/TENANT/4711","${payload}")</text><polygon fill="#A80036" points="79.8,536.3813,67.8,541.1813,79.8,545.9812,75,541.1813" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="72.6" x2="285" y1="541.1813" y2="541.1813"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="87" y="535.1021">6</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="175.2" x="102.6" y="535.1021">Command is published</text><polygon fill="#A80036" points="1071,571.3406,1083,576.1406,1071,580.9406,1075.8,576.1406" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="286.2" x2="1078.2" y1="576.1406" y2="576.1406"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="294.6" y="570.0615">7</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="411.6" x="310.2" y="570.0615">disposition("accepted")  via AMQP messaging network</text><!--MD5=[71ddd732be6e84b05c80e4cf67a00485]
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="643.2px" preserveAspectRatio="none" style="width:1296px;height:643px;" version="1.1" viewBox="0 0 1296 643" width="1296px" zoomAndPan="magnify"><defs><filter height="300%" id="ffihz7kya2wlh" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="617.1" style="stroke: #A80036; stroke-width: 1.2;" width="708" x="201.6" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="532.8" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="159.3563" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="451.8" y="316.7063"/><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="809.4" y="369.825"/><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="996.6" y="476.0625"/><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="498.6281" style="stroke: #000000; stroke-width: 2.4;" width="1267.2" x="15.6" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="66" x2="66" y1="89.6719" y2="629.1"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="285.6" x2="285.6" y1="89.6719" y2="629.1"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="457.2" x2="457.2" y1="89.6719" y2="629.1"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="814.8" x2="814.8" y1="89.6719" y2="629.1"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1002" x2="1002" y1="89.6719" y2="629.1"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="1214.4" x2="1214.4" y1="89.6719" y2="629.1"/><rect fill="#FEFECE" filter="url(#ffihz7kya2wlh)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="73.2" x="27.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="56.4" x="36" y="71.3098">Device</text><rect fill="#FEFECE" filter="url(#ffihz7kya2wlh)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="206.4" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="214.8" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="233.4" y="71.3098">instance #1</text><rect fill="#FEFECE" filter="url(#ffihz7kya2wlh)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="378" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="386.4" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="405" y="71.3098">instance #2</text><rect fill="#FEFECE" filter="url(#ffihz7kya2wlh)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="726" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="734.4" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="750" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#ffihz7kya2wlh)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="916.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="925.2" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="966.6" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#ffihz7kya2wlh)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="1159.2" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="1167.6" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="159.3563" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="451.8" y="316.7063"/><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="809.4" y="369.825"/><rect fill="#FFFFFF" filter="url(#ffihz7kya2wlh)" height="53.1188" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="996.6" y="476.0625"/><path d="M15.6,110.0719 L242.4,110.0719 L242.4,118.4719 L230.4,130.4719 L15.6,130.4719 L15.6,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="498.6281" style="stroke: #000000; stroke-width: 2.4;" width="1267.2" x="15.6" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="172.8" x="33.6" y="125.7521">Command handling</text><polygon fill="#A80036" points="1015.8,187.5094,1003.8,192.3094,1015.8,197.1094,1011,192.3094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1008.6" x2="1213.8" y1="192.3094" y2="192.3094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="1023" y="168.0709">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="133.2" x="1038.6" y="149.9115">attach("receiver",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="168" x="1038.6" y="168.0709">"command_response/</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="1043.4" y="186.2303">TENANT/${replyId}")</text><polygon fill="#A80036" points="1015.8,240.6281,1003.8,245.4281,1015.8,250.2281,1011,245.4281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="1008.6" x2="1213.8" y1="245.4281" y2="245.4281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="1023" y="230.2693">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="124.8" x="1038.6" y="221.1896">attach("sender",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="162" x="1038.6" y="239.349">"command/TENANT")</text><polygon fill="#A80036" points="477,311.9063,465,316.7063,477,321.5062,472.2,316.7063" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="469.8" x2="1213.8" y1="316.7063" y2="316.7063"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="484.2" y="292.4678">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="226.8" x="499.8" y="274.3084">transfer("command/TENANT",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="504.6" y="292.4678">"command/TENANT/4711","${payload}")</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="514.2" y="310.6271">via AMQP messaging network</text><polygon fill="#A80036" points="795,365.025,807,369.825,795,374.625,799.8,369.825" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="463.8" x2="802.2" y1="369.825" y2="369.825"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="472.2" y="354.6662">4</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="242.4" x="487.8" y="345.5865">get command handling adapter</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="195.6" x="487.8" y="363.7459">instances for device 4711</text><polygon fill="#A80036" points="477,418.1438,465,422.9437,477,427.7438,472.2,422.9437" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 2.0,2.0;" x1="469.8" x2="814.2" y1="422.9437" y2="422.9437"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="484.2" y="407.785">5</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="296.4" x="499.8" y="398.7053">JSON containing adapter instance "#1"</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="236.4" x="499.8" y="416.8646">handling commands for "4711"</text><polygon fill="#A80036" points="982.2,471.2625,994.2,476.0625,982.2,480.8625,987,476.0625" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="457.8" x2="989.4" y1="476.0625" y2="476.0625"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="466.2" y="460.9037">6</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="254.4" x="481.8" y="451.824">transfer("command_internal/#1",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="486.6" y="469.9834">"command/TENANT/4711","${payload}")</text><polygon fill="#A80036" points="299.4,524.3813,287.4,529.1813,299.4,533.9812,294.6,529.1813" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="292.2" x2="1001.4" y1="529.1813" y2="529.1813"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="306.6" y="514.0225">7</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="254.4" x="322.2" y="504.9428">transfer("command_internal/#1",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="310.8" x="327" y="523.1021">"command/TENANT/4711","${payload}")</text><polygon fill="#A80036" points="79.8,559.3406,67.8,564.1406,79.8,568.9406,75,564.1406" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="72.6" x2="285" y1="564.1406" y2="564.1406"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="87" y="558.0615">8</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="175.2" x="102.6" y="558.0615">Command is published</text><polygon fill="#A80036" points="1200.6,594.3,1212.6,599.1,1200.6,603.9,1205.4,599.1" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="286.2" x2="1207.8" y1="599.1" y2="599.1"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="294.6" y="593.0209">9</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="411.6" x="310.2" y="593.0209">disposition("accepted")  via AMQP messaging network</text><!--MD5=[3bd9add0052cc62a66bf16f931f011f7]
 @startuml
 scale 1.2
 hide footbox
 
 participant Device order 10
 box "Hono"
-    participant "Hono Protocol Adapter\ninstance 1" order 30
-    participant "Hono Protocol Adapter\ninstance 2" order 40
+    participant "Protocol Adapter\ninstance #1" order 30
+    participant "Protocol Adapter\ninstance #2" order 40
+    participant "Device Connection\nAPI component" order 50
 end box
 participant "AMQP messaging \nnetwork" order 60
 participant Application order 70
@@ -18,22 +19,21 @@
     Application -> "AMQP messaging \nnetwork": attach("receiver", \n"command_response/\n TENANT/${replyId}")
     Application -> "AMQP messaging \nnetwork": attach("sender", \n"command/TENANT")
 
-    Application -> "Hono Protocol Adapter\ninstance 2": transfer("command/TENANT",\n "command/TENANT/4711","${payload}")\n   via AMQP messaging network
-    activate "Hono Protocol Adapter\ninstance 2"
+    Application -> "Protocol Adapter\ninstance #2": transfer("command/TENANT",\n "command/TENANT/4711","${payload}")\n   via AMQP messaging network
+    activate "Protocol Adapter\ninstance #2"
 
-    note over "Hono Protocol Adapter\ninstance 2"
-    Check if command needs
-    to be mapped to gateway
-    (no mapping needed here)
-    end note
-    "Hono Protocol Adapter\ninstance 2" -> "AMQP messaging \nnetwork": transfer("control/TENANT/4711",\n "command/TENANT/4711","${payload}")
-    deactivate "Hono Protocol Adapter\ninstance 2"
+    "Protocol Adapter\ninstance #2" -> "Device Connection\nAPI component": get command handling adapter \ninstances for device 4711
+    activate "Device Connection\nAPI component"
+    return JSON containing adapter instance "#1" \nhandling commands for "4711"
+
+    "Protocol Adapter\ninstance #2" -> "AMQP messaging \nnetwork": transfer("command_internal/#1",\n "command/TENANT/4711","${payload}")
+    deactivate "Protocol Adapter\ninstance #2"
     activate "AMQP messaging \nnetwork"
-    "AMQP messaging \nnetwork" -> "Hono Protocol Adapter\ninstance 1": transfer("control/TENANT/4711",\n "command/TENANT/4711","${payload}")
+    "AMQP messaging \nnetwork" -> "Protocol Adapter\ninstance #1": transfer("command_internal/#1",\n "command/TENANT/4711","${payload}")
     deactivate "AMQP messaging \nnetwork"
 
-    "Hono Protocol Adapter\ninstance 1" -> Device: Command is published
-    "Hono Protocol Adapter\ninstance 1" -> Application: disposition("accepted")  via AMQP messaging network
+    "Protocol Adapter\ninstance #1" -> Device: Command is published
+    "Protocol Adapter\ninstance #1" -> Application: disposition("accepted")  via AMQP messaging network
 end
 @enduml
 
diff --git a/docs/dev/concepts/command_control_concept_gateway_3.svg b/docs/dev/concepts/command_control_concept_gateway_3.svg
index 2a5499e..a72f4c1 100644
--- a/docs/dev/concepts/command_control_concept_gateway_3.svg
+++ b/docs/dev/concepts/command_control_concept_gateway_3.svg
@@ -1,10 +1,10 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="382.8px" preserveAspectRatio="none" style="width:1046px;height:382px;" version="1.1" viewBox="0 0 1046 382" width="1046.4px" zoomAndPan="magnify"><defs><filter height="300%" id="f1syi2mmgw2dx7" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="364.9406" style="stroke: #A80036; stroke-width: 1.2;" width="360" x="358.8" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="516" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f1syi2mmgw2dx7)" height="173.7563" style="stroke: #000000; stroke-width: 2.4;" width="1018.8" x="14.4" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="187.2" x2="187.2" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="442.8" x2="442.8" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="624" x2="624" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="811.2" x2="811.2" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="964.8" x2="964.8" y1="89.6719" y2="304.2281"/><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="141.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="150" y="71.3098">Gateway</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="141.6" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="150" y="327.0223">Gateway</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="363.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="372" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="397.8" y="71.3098">instance 1</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="363.6" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="372" y="327.0223">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="397.8" y="346.5785">instance 1</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="535.2" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="543.6" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="559.2" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="535.2" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="543.6" y="327.0223">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="559.2" y="346.5785">API component</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="726" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="734.4" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="775.8" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="726" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="734.4" y="327.0223">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="775.8" y="346.5785">network</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="909.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="918" y="71.3098">Application</text><rect fill="#FEFECE" filter="url(#f1syi2mmgw2dx7)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="909.6" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="918" y="327.0223">Application</text><path d="M14.4,110.0719 L328.8,110.0719 L328.8,118.4719 L316.8,130.4719 L14.4,130.4719 L14.4,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="173.7563" style="stroke: #000000; stroke-width: 2.4;" width="1018.8" x="14.4" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="260.4" x="32.4" y="125.7521">Command response handling</text><path d="M26.4,136.6313 L26.4,184.6313 L343.2,184.6313 L343.2,148.6313 L331.2,136.6313 L26.4,136.6313 " fill="#FBFB77" filter="url(#f1syi2mmgw2dx7)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M331.2,136.6313 L331.2,148.6313 L343.2,148.6313 L331.2,136.6313 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="194.4" x="33.6" y="157.1115">The gateway receives the</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="291.6" x="33.6" y="175.2709">command response from device 4711</text><polygon fill="#A80036" points="429,216.3094,441,221.1094,429,225.9094,433.8,221.1094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="187.8" x2="436.2" y1="221.1094" y2="221.1094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="196.2" y="215.0303">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="211.2" x="211.8" y="215.0303">Command response is sent</text><polygon fill="#A80036" points="951,269.4281,963,274.2281,951,279.0281,955.8,274.2281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="443.4" x2="958.2" y1="274.2281" y2="274.2281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="451.8" y="259.0693">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="390" x="467.4" y="249.9896">transfer("command_response/TENANT/${replyId}",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="453.6" x="472.2" y="268.149">"status=200","${payload}")   via AMQP messaging network</text><!--MD5=[314ae5857e0e2e146e21c67a08eb6e9b]
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="382.8px" preserveAspectRatio="none" style="width:1070px;height:382px;" version="1.1" viewBox="0 0 1070 382" width="1070.4px" zoomAndPan="magnify"><defs><filter height="300%" id="f1du81qzywy1qb" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="364.9406" style="stroke: #A80036; stroke-width: 1.2;" width="409.2" x="334.2" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="516" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f1du81qzywy1qb)" height="173.7563" style="stroke: #000000; stroke-width: 2.4;" width="1043.4" x="14.4" y="110.0719"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="187.2" x2="187.2" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="443.4" x2="443.4" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="648.6" x2="648.6" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="835.8" x2="835.8" y1="89.6719" y2="304.2281"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="989.4" x2="989.4" y1="89.6719" y2="304.2281"/><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="141.6" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="150" y="71.3098">Gateway</text><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="141.6" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="150" y="327.0223">Gateway</text><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="339" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="347.4" y="51.7535">Hono Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="397.8" y="71.3098">instance 1</text><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="339" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="347.4" y="327.0223">Hono Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="397.8" y="346.5785">instance 1</text><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="559.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="568.2" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="583.8" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="559.8" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="568.2" y="327.0223">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="583.8" y="346.5785">API component</text><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="750.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="759" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="800.4" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="750.6" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="759" y="327.0223">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="800.4" y="346.5785">network</text><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="934.2" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="942.6" y="71.3098">Application</text><rect fill="#FEFECE" filter="url(#f1du81qzywy1qb)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="934.2" y="303.0281"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="942.6" y="327.0223">Application</text><path d="M14.4,110.0719 L328.8,110.0719 L328.8,118.4719 L316.8,130.4719 L14.4,130.4719 L14.4,110.0719 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="173.7563" style="stroke: #000000; stroke-width: 2.4;" width="1043.4" x="14.4" y="110.0719"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="260.4" x="32.4" y="125.7521">Command response handling</text><path d="M26.4,136.6313 L26.4,184.6313 L343.2,184.6313 L343.2,148.6313 L331.2,136.6313 L26.4,136.6313 " fill="#FBFB77" filter="url(#f1du81qzywy1qb)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M331.2,136.6313 L331.2,148.6313 L343.2,148.6313 L331.2,136.6313 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="194.4" x="33.6" y="157.1115">The gateway receives the</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="291.6" x="33.6" y="175.2709">command response from device 4711</text><polygon fill="#A80036" points="429,216.3094,441,221.1094,429,225.9094,433.8,221.1094" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="187.8" x2="436.2" y1="221.1094" y2="221.1094"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="196.2" y="215.0303">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="211.2" x="211.8" y="215.0303">Command response is sent</text><polygon fill="#A80036" points="975.6,269.4281,987.6,274.2281,975.6,279.0281,980.4,274.2281" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="443.4" x2="982.8" y1="274.2281" y2="274.2281"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="451.8" y="259.0693">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="390" x="467.4" y="249.9896">transfer("command_response/TENANT/${replyId}",</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="453.6" x="472.2" y="268.149">"status=200","${payload}")   via AMQP messaging network</text><!--MD5=[303c83bfa669dba0d0715de29b2a056c]
 @startuml
 scale 1.2
 
 participant Gateway order 20
 box "Hono"
-    participant "Protocol Adapter\ninstance 1" order 30
+    participant "Hono Protocol Adapter\ninstance 1" order 30
     participant "Device Connection\nAPI component" order 50
 end box
 participant "AMQP messaging \nnetwork" order 60
@@ -17,9 +17,9 @@
     The gateway receives the
     command response from device 4711
     end note
-    Gateway -> "Protocol Adapter\ninstance 1": Command response is sent
-    "Protocol Adapter\ninstance 1" -> Application: transfer("command_response/TENANT/${replyId}",\n "status=200","${payload}")   via AMQP messaging network
-    deactivate "Protocol Adapter\ninstance 1"
+    Gateway -> "Hono Protocol Adapter\ninstance 1": Command response is sent
+    "Hono Protocol Adapter\ninstance 1" -> Application: transfer("command_response/TENANT/${replyId}",\n "status=200","${payload}")   via AMQP messaging network
+    deactivate "Hono Protocol Adapter\ninstance 1"
     deactivate Application
 end
 @enduml
diff --git a/docs/dev/concepts/command_control_concept_gateway_all_devices_1.svg b/docs/dev/concepts/command_control_concept_gateway_all_devices_1.svg
index d2161d0..d9a2b1a 100644
--- a/docs/dev/concepts/command_control_concept_gateway_all_devices_1.svg
+++ b/docs/dev/concepts/command_control_concept_gateway_all_devices_1.svg
@@ -1,11 +1,11 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="590.4px" preserveAspectRatio="none" style="width:1074px;height:590px;" version="1.1" viewBox="0 0 1074 590" width="1074px" zoomAndPan="magnify"><defs><filter height="300%" id="f3s3y7qbr2dv1" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="565.0219" style="stroke: #A80036; stroke-width: 1.2;" width="409.2" x="250.2" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="432" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f3s3y7qbr2dv1)" height="225.5156" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="353.4" y="340.7063"/><rect fill="#FFFFFF" filter="url(#f3s3y7qbr2dv1)" height="120.6375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="987" y="445.5844"/><rect fill="#FFFFFF" filter="url(#f3s3y7qbr2dv1)" height="261.8344" style="stroke: #000000; stroke-width: 2.4;" width="1041.6" x="19.2" y="193.35"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="136.8" x2="136.8" y1="89.6719" y2="577.0219"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="359.4" x2="359.4" y1="89.6719" y2="577.0219"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="564.6" x2="564.6" y1="89.6719" y2="577.0219"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="751.8" x2="751.8" y1="89.6719" y2="577.0219"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="992.4" x2="992.4" y1="89.6719" y2="577.0219"/><rect fill="#FEFECE" filter="url(#f3s3y7qbr2dv1)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="91.2" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="99.6" y="71.3098">Gateway</text><rect fill="#FEFECE" filter="url(#f3s3y7qbr2dv1)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="204" x="255" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="187.2" x="263.4" y="51.7535">Hono Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="86.4" x="313.8" y="71.3098">instance 1</text><rect fill="#FEFECE" filter="url(#f3s3y7qbr2dv1)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="475.8" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="484.2" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="499.8" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f3s3y7qbr2dv1)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="666.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="675" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="716.4" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f3s3y7qbr2dv1)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="937.2" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="945.6" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#f3s3y7qbr2dv1)" height="225.5156" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="353.4" y="340.7063"/><rect fill="#FFFFFF" filter="url(#f3s3y7qbr2dv1)" height="120.6375" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="987" y="445.5844"/><path d="M9.6,107.6719 L9.6,173.6719 L260.4,173.6719 L260.4,119.6719 L248.4,107.6719 L9.6,107.6719 " fill="#FBFB77" filter="url(#f3s3y7qbr2dv1)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M248.4,107.6719 L248.4,119.6719 L260.4,119.6719 L248.4,107.6719 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="160.8" x="16.8" y="128.1521">The gateway 'gw-1' is</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="16.8" y="146.3115">connected and authenticated</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="136.8" x="16.8" y="164.4709">with TENANT/gw-1</text><path d="M19.2,193.35 L278.4,193.35 L278.4,201.75 L266.4,213.75 L19.2,213.75 L19.2,193.35 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="261.8344" style="stroke: #000000; stroke-width: 2.4;" width="1041.6" x="19.2" y="193.35"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="37.2" y="209.0303">Command subscription</text><path d="M31.2,219.9094 L31.2,285.9094 L238.8,285.9094 L238.8,231.9094 L226.8,219.9094 L31.2,219.9094 " fill="#FBFB77" filter="url(#f3s3y7qbr2dv1)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M226.8,219.9094 L226.8,231.9094 L238.8,231.9094 L226.8,219.9094 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="182.4" x="38.4" y="240.3896">The gateway subscribes</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="38.4" y="258.549">to commands just as a</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="156" x="38.4" y="276.7084">normal device would</text><polygon fill="#A80036" points="339,335.9063,351,340.7063,339,345.5062,343.8,340.7063" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="137.4" x2="346.2" y1="340.7063" y2="340.7063"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="145.8" y="325.5475">0</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="161.4" y="316.4678">Command subscription</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="102" x="166.2" y="334.6271">/ TTD request</text><polygon fill="#A80036" points="738,370.8656,750,375.6656,738,380.4656,742.8,375.6656" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="365.4" x2="745.2" y1="375.6656" y2="375.6656"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="373.8" y="369.5865">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="300" x="389.4" y="369.5865">attach("receiver", "command/TENANT")</text><polygon fill="#A80036" points="738,405.825,750,410.625,738,415.425,742.8,410.625" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="365.4" x2="745.2" y1="410.625" y2="410.625"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="373.8" y="404.5459">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="315.6" x="389.4" y="404.5459">attach("receiver", "control/TENANT/gw-1")</text><polygon fill="#A80036" points="972.6,440.7844,984.6,445.5844,972.6,450.3844,977.4,445.5844" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="365.4" x2="979.8" y1="445.5844" y2="445.5844"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="373.8" y="439.5053">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="583.2" x="389.4" y="439.5053">transfer("event/TENANT","gw-1","ttd=${ttd}")  via AMQP messaging network</text><path d="M72,469.5844 L72,553.5844 L628.8,553.5844 L628.8,481.5844 L616.8,469.5844 L72,469.5844 " fill="#FBFB77" filter="url(#f3s3y7qbr2dv1)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M616.8,469.5844 L616.8,481.5844 L628.8,481.5844 L616.8,469.5844 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="502.8" x="91.5" y="490.0646">In order for commands to be successfully mapped to the gateway</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="462" x="91.5" y="508.224">from here on, the gateway must have acted on behalf of the</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="465.6" x="91.5" y="526.3834">command target device (e.g. sent telemetry for it) or it must</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="364.8" x="91.5" y="544.5428">be the only gateway associated with the device.</text><!--MD5=[0e0adb0319001e8de4010f18d7c7ed35]
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="543.6px" preserveAspectRatio="none" style="width:1074px;height:543px;" version="1.1" viewBox="0 0 1074 543" width="1074px" zoomAndPan="magnify"><defs><filter height="300%" id="f1jklk7noazmnx" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.4"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.8" dy="4.8" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><rect fill="#DDDDDD" height="518.0625" style="stroke: #A80036; stroke-width: 1.2;" width="410.4" x="274.8" y="4.8"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="45.6" x="457.2" y="19.2803">Hono</text><rect fill="#FFFFFF" filter="url(#f1jklk7noazmnx)" height="178.5563" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="353.4" y="340.7063"/><rect fill="#FFFFFF" filter="url(#f1jklk7noazmnx)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="987" y="500.0625"/><rect fill="#FFFFFF" filter="url(#f1jklk7noazmnx)" height="316.3125" style="stroke: #000000; stroke-width: 2.4;" width="1041.6" x="19.2" y="193.35"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="136.8" x2="136.8" y1="89.6719" y2="530.0625"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="358.8" x2="358.8" y1="89.6719" y2="530.0625"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="590.4" x2="590.4" y1="89.6719" y2="530.0625"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="777.6" x2="777.6" y1="89.6719" y2="530.0625"/><line style="stroke: #A80036; stroke-width: 1.2; stroke-dasharray: 5.0,5.0;" x1="992.4" x2="992.4" y1="89.6719" y2="530.0625"/><rect fill="#FEFECE" filter="url(#f1jklk7noazmnx)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="87.6" x="91.2" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="70.8" x="99.6" y="71.3098">Gateway</text><rect fill="#FEFECE" filter="url(#f1jklk7noazmnx)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="154.8" x="279.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="138" x="288" y="51.7535">Protocol Adapter</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="100.8" x="306.6" y="71.3098">instance #1</text><rect fill="#FEFECE" filter="url(#f1jklk7noazmnx)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="174" x="501.6" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="157.2" x="510" y="51.7535">Device Connection</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="126" x="525.6" y="71.3098">API component</text><rect fill="#FEFECE" filter="url(#f1jklk7noazmnx)" height="55.9125" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="166.8" x="692.4" y="27.7594"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="145.2" x="700.8" y="51.7535">AMQP messaging</text><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="67.2" x="742.2" y="71.3098">network</text><rect fill="#FEFECE" filter="url(#f1jklk7noazmnx)" height="36.3562" style="stroke: #A80036; stroke-width: 1.7999999999999998;" width="106.8" x="937.2" y="47.3156"/><text fill="#000000" font-family="sans-serif" font-size="16.8" lengthAdjust="spacingAndGlyphs" textLength="90" x="945.6" y="71.3098">Application</text><rect fill="#FFFFFF" filter="url(#f1jklk7noazmnx)" height="178.5563" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="353.4" y="340.7063"/><rect fill="#FFFFFF" filter="url(#f1jklk7noazmnx)" height="19.2" style="stroke: #A80036; stroke-width: 1.2;" width="12" x="987" y="500.0625"/><path d="M9.6,107.6719 L9.6,173.6719 L260.4,173.6719 L260.4,119.6719 L248.4,107.6719 L9.6,107.6719 " fill="#FBFB77" filter="url(#f1jklk7noazmnx)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M248.4,107.6719 L248.4,119.6719 L260.4,119.6719 L248.4,107.6719 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="160.8" x="16.8" y="128.1521">The gateway 'gw-1' is</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="225.6" x="16.8" y="146.3115">connected and authenticated</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="136.8" x="16.8" y="164.4709">with TENANT/gw-1</text><path d="M19.2,193.35 L278.4,193.35 L278.4,201.75 L266.4,213.75 L19.2,213.75 L19.2,193.35 " fill="#EEEEEE" style="stroke: #000000; stroke-width: 1.2;"/><rect fill="none" height="316.3125" style="stroke: #000000; stroke-width: 2.4;" width="1041.6" x="19.2" y="193.35"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="205.2" x="37.2" y="209.0303">Command subscription</text><path d="M31.2,219.9094 L31.2,285.9094 L238.8,285.9094 L238.8,231.9094 L226.8,219.9094 L31.2,219.9094 " fill="#FBFB77" filter="url(#f1jklk7noazmnx)" style="stroke: #A80036; stroke-width: 1.2;"/><path d="M226.8,219.9094 L226.8,231.9094 L238.8,231.9094 L226.8,219.9094 " fill="#FBFB77" style="stroke: #A80036; stroke-width: 1.2;"/><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="182.4" x="38.4" y="240.3896">The gateway subscribes</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="38.4" y="258.549">to commands just as a</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="156" x="38.4" y="276.7084">normal device would</text><polygon fill="#A80036" points="339,335.9063,351,340.7063,339,345.5062,343.8,340.7063" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="137.4" x2="346.2" y1="340.7063" y2="340.7063"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="145.8" y="325.5475">0</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="161.4" y="316.4678">Command subscription</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="102" x="166.2" y="334.6271">/ TTD request</text><polygon fill="#A80036" points="763.8,370.8656,775.8,375.6656,763.8,380.4656,768.6,375.6656" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="365.4" x2="771" y1="375.6656" y2="375.6656"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="373.8" y="369.5865">1</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="300" x="389.4" y="369.5865">attach("receiver", "command/TENANT")</text><polygon fill="#A80036" points="576.6,460.3031,588.6,465.1031,576.6,469.9031,581.4,465.1031" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="365.4" x2="583.8" y1="465.1031" y2="465.1031"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="373.8" y="431.785">2</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="176.4" x="389.4" y="404.5459">set command handling</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="129.6" x="389.4" y="422.7053">adapter instance</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="122.4" x="389.4" y="440.8646">for device 'gw-1'</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="177.6" x="389.4" y="459.024">to adapter instance #1</text><polygon fill="#A80036" points="972.6,495.2625,984.6,500.0625,972.6,504.8625,977.4,500.0625" style="stroke: #A80036; stroke-width: 1.2;"/><line style="stroke: #A80036; stroke-width: 1.2;" x1="365.4" x2="979.8" y1="500.0625" y2="500.0625"/><text fill="#000000" font-family="sans-serif" font-size="15.6" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="10.8" x="373.8" y="493.9834">3</text><text fill="#000000" font-family="sans-serif" font-size="15.6" lengthAdjust="spacingAndGlyphs" textLength="583.2" x="389.4" y="493.9834">transfer("event/TENANT","gw-1","ttd=${ttd}")  via AMQP messaging network</text><!--MD5=[93e2f9ddcc703299e7ec00e54289c11f]
 @startuml
 scale 1.2
 hide footbox
 
 participant Gateway order 20
 box "Hono"
-    participant "Hono Protocol Adapter\ninstance 1" order 30
+    participant "Protocol Adapter\ninstance #1" order 30
     participant "Device Connection\nAPI component" order 50
 end box
 participant "AMQP messaging \nnetwork" order 60
@@ -25,23 +25,16 @@
     to commands just as a
     normal device would
     end note
-    Gateway -> "Hono Protocol Adapter\ninstance 1": Command subscription\n / TTD request
-    activate "Hono Protocol Adapter\ninstance 1"
+    Gateway -> "Protocol Adapter\ninstance #1": Command subscription\n / TTD request
+    activate "Protocol Adapter\ninstance #1"
 
-    "Hono Protocol Adapter\ninstance 1" -> "AMQP messaging \nnetwork": attach("receiver", "command/TENANT")
-    "Hono Protocol Adapter\ninstance 1" -> "AMQP messaging \nnetwork": attach("receiver", "control/TENANT/gw-1")
+    "Protocol Adapter\ninstance #1" -> "AMQP messaging \nnetwork": attach("receiver", "command/TENANT")
+    "Protocol Adapter\ninstance #1" -> "Device Connection\nAPI component": set command handling \nadapter instance \nfor device 'gw-1' \nto adapter instance #1
 
-    "Hono Protocol Adapter\ninstance 1" -> Application: transfer("event/TENANT","gw-1","ttd=${ttd}")  via AMQP messaging network
+    "Protocol Adapter\ninstance #1" -> Application: transfer("event/TENANT","gw-1","ttd=${ttd}")  via AMQP messaging network
     activate Application
 end
 
-note over Gateway, "Device Connection\nAPI component"
-In order for commands to be successfully mapped to the gateway
-from here on, the gateway must have acted on behalf of the
-command target device (e.g. sent telemetry for it) or it must
-be the only gateway associated with the device.
-end note
-
 @enduml
 
 PlantUML version 1.2019.11(Sun Sep 22 12:02:15 CEST 2019)
diff --git a/docs/dev/concepts/connecting-devices/index.html b/docs/dev/concepts/connecting-devices/index.html
index 417f85d..4c15a54 100644
--- a/docs/dev/concepts/connecting-devices/index.html
+++ b/docs/dev/concepts/connecting-devices/index.html
@@ -21,19 +21,19 @@
     <title>Connecting Devices :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/connecting-devices/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/connecting-devices/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/connecting-devices/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/connecting-devices/">1.1</option>
@@ -1370,6 +1392,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/connecting-devices/" selected>dev</option>
@@ -2648,20 +2672,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/concepts/connection-events/index.html b/docs/dev/concepts/connection-events/index.html
index a6be20f..a4f0680 100644
--- a/docs/dev/concepts/connection-events/index.html
+++ b/docs/dev/concepts/connection-events/index.html
@@ -21,19 +21,19 @@
     <title>Connection Events :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/connection-events/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/connection-events/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/connection-events/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/connection-events/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/connection-events/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/connection-events/" selected>dev</option>
@@ -2533,20 +2559,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/concepts/device-identity/index.html b/docs/dev/concepts/device-identity/index.html
index 6fbe1d7..d1c0e6d 100644
--- a/docs/dev/concepts/device-identity/index.html
+++ b/docs/dev/concepts/device-identity/index.html
@@ -21,19 +21,19 @@
     <title>Device Identity :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/device-identity/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/device-identity/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/device-identity/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/device-identity/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/device-identity/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/device-identity/" selected>dev</option>
@@ -2553,20 +2579,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/concepts/device-notifications/index.html b/docs/dev/concepts/device-notifications/index.html
index d96adbb..78e3bba 100644
--- a/docs/dev/concepts/device-notifications/index.html
+++ b/docs/dev/concepts/device-notifications/index.html
@@ -21,19 +21,19 @@
     <title>Device Notifications :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1332,6 +1332,26 @@
               
               
                   
+                    
+                    
+                      <option id="stable" value="/hono/docs/concepts/device-notifications/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
               
                   
               
@@ -2576,20 +2596,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/concepts/device-provisioning/index.html b/docs/dev/concepts/device-provisioning/index.html
index ef1db65..25fb79f 100644
--- a/docs/dev/concepts/device-provisioning/index.html
+++ b/docs/dev/concepts/device-provisioning/index.html
@@ -21,19 +21,19 @@
     <title>Device Provisioning :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/device-provisioning/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/device-provisioning/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/device-provisioning/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/device-provisioning/">1.1</option>
@@ -1370,6 +1392,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/device-provisioning/" selected>dev</option>
@@ -2593,20 +2617,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/concepts/index.html b/docs/dev/concepts/index.html
index a950599..0a945eb 100644
--- a/docs/dev/concepts/index.html
+++ b/docs/dev/concepts/index.html
@@ -21,19 +21,19 @@
     <title>Concepts :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/" selected>dev</option>
@@ -2493,20 +2519,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/concepts/resource-limits/index.html b/docs/dev/concepts/resource-limits/index.html
index a6a87c7..3972384 100644
--- a/docs/dev/concepts/resource-limits/index.html
+++ b/docs/dev/concepts/resource-limits/index.html
@@ -21,19 +21,19 @@
     <title>Resource limits :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/concepts/resource-limits/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/concepts/resource-limits/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/concepts/resource-limits/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/concepts/resource-limits/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/concepts/resource-limits/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/concepts/resource-limits/" selected>dev</option>
@@ -2597,20 +2623,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/concepts/tenancy/index.html b/docs/dev/concepts/tenancy/index.html
index d71a6a0..04fee70 100644
--- a/docs/dev/concepts/tenancy/index.html
+++ b/docs/dev/concepts/tenancy/index.html
@@ -21,19 +21,19 @@
     <title>Multi-Tenancy :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1332,6 +1332,26 @@
               
               
                   
+                    
+                    
+                      <option id="stable" value="/hono/docs/concepts/tenancy/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
               
                   
               
@@ -2613,20 +2633,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/deployment/create-kubernetes-cluster/index.html b/docs/dev/deployment/create-kubernetes-cluster/index.html
index 1a86452..3af28ed 100644
--- a/docs/dev/deployment/create-kubernetes-cluster/index.html
+++ b/docs/dev/deployment/create-kubernetes-cluster/index.html
@@ -21,19 +21,19 @@
     <title>Setting up a Kubernetes Cluster :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/create-kubernetes-cluster/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/create-kubernetes-cluster/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/create-kubernetes-cluster/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/create-kubernetes-cluster/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/create-kubernetes-cluster/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/create-kubernetes-cluster/" selected>dev</option>
@@ -2673,20 +2699,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/deployment/helm-based-deployment/index.html b/docs/dev/deployment/helm-based-deployment/index.html
index b84d3d5..696ea31 100644
--- a/docs/dev/deployment/helm-based-deployment/index.html
+++ b/docs/dev/deployment/helm-based-deployment/index.html
@@ -21,19 +21,19 @@
     <title>Helm based Deployment :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/helm-based-deployment/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/helm-based-deployment/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/helm-based-deployment/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/helm-based-deployment/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/helm-based-deployment/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/helm-based-deployment/" selected>dev</option>
@@ -2743,20 +2769,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/deployment/index.html b/docs/dev/deployment/index.html
index cf03da1..f950bb2 100644
--- a/docs/dev/deployment/index.html
+++ b/docs/dev/deployment/index.html
@@ -21,19 +21,19 @@
     <title>Deployment :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/" selected>dev</option>
@@ -2496,20 +2522,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/deployment/openshift/index.html b/docs/dev/deployment/openshift/index.html
index fca0a7e..a316c1f 100644
--- a/docs/dev/deployment/openshift/index.html
+++ b/docs/dev/deployment/openshift/index.html
@@ -21,19 +21,19 @@
     <title>OpenShift / OKD :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/openshift/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/openshift/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/openshift/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/openshift/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/openshift/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/openshift/" selected>dev</option>
@@ -2517,20 +2543,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/deployment/resource-limitation/index.html b/docs/dev/deployment/resource-limitation/index.html
index 67f6c99..1d3a222 100644
--- a/docs/dev/deployment/resource-limitation/index.html
+++ b/docs/dev/deployment/resource-limitation/index.html
@@ -21,19 +21,19 @@
     <title>Limiting Resource Usage :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/deployment/resource-limitation/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/deployment/resource-limitation/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/deployment/resource-limitation/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/deployment/resource-limitation/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/deployment/resource-limitation/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/deployment/resource-limitation/" selected>dev</option>
@@ -2601,20 +2627,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/dev-guide/amqp_adapter_client/index.html b/docs/dev/dev-guide/amqp_adapter_client/index.html
index ebc42ab..dfcb2b9 100644
--- a/docs/dev/dev-guide/amqp_adapter_client/index.html
+++ b/docs/dev/dev-guide/amqp_adapter_client/index.html
@@ -21,19 +21,19 @@
     <title>AMQP Adapter Client for Java :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/dev-guide/amqp_adapter_client/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/dev-guide/amqp_adapter_client/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/amqp_adapter_client/">1.2</option>
                     
                   
               
@@ -1354,6 +1374,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/dev-guide/amqp_adapter_client/" selected>dev</option>
@@ -2535,20 +2557,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/dev-guide/building_hono/index.html b/docs/dev/dev-guide/building_hono/index.html
index b3a1764..7caee6e 100644
--- a/docs/dev/dev-guide/building_hono/index.html
+++ b/docs/dev/dev-guide/building_hono/index.html
@@ -21,19 +21,19 @@
     <title>Building from Source :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/dev-guide/building_hono/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/dev-guide/building_hono/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/building_hono/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/dev-guide/building_hono/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/dev-guide/building_hono/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/dev-guide/building_hono/" selected>dev</option>
@@ -2591,20 +2617,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/dev-guide/custom_http_adapter/index.html b/docs/dev/dev-guide/custom_http_adapter/index.html
index 836a3b2..55fe6d0 100644
--- a/docs/dev/dev-guide/custom_http_adapter/index.html
+++ b/docs/dev/dev-guide/custom_http_adapter/index.html
@@ -21,19 +21,19 @@
     <title>Implement a Custom Hono HTTP Protocol Adapter :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/dev-guide/custom_http_adapter/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/dev-guide/custom_http_adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/custom_http_adapter/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/dev-guide/custom_http_adapter/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/dev-guide/custom_http_adapter/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/dev-guide/custom_http_adapter/" selected>dev</option>
@@ -2628,20 +2654,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/dev-guide/index.html b/docs/dev/dev-guide/index.html
index ce865b4..5976242 100644
--- a/docs/dev/dev-guide/index.html
+++ b/docs/dev/dev-guide/index.html
@@ -21,19 +21,19 @@
     <title>Developer Guide :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/dev-guide/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/dev-guide/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/dev-guide/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/dev-guide/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/dev-guide/" selected>dev</option>
@@ -2496,20 +2522,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/dev-guide/java_client_consumer/index.html b/docs/dev/dev-guide/java_client_consumer/index.html
index 6423905..fede204 100644
--- a/docs/dev/dev-guide/java_client_consumer/index.html
+++ b/docs/dev/dev-guide/java_client_consumer/index.html
@@ -21,19 +21,19 @@
     <title>Consuming Messages from Java :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/dev-guide/java_client_consumer/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/dev-guide/java_client_consumer/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/dev-guide/java_client_consumer/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/dev-guide/java_client_consumer/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/dev-guide/java_client_consumer/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/dev-guide/java_client_consumer/" selected>dev</option>
@@ -2598,20 +2624,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/index.html b/docs/dev/index.html
index 65aee49..73a399b 100644
--- a/docs/dev/index.html
+++ b/docs/dev/index.html
@@ -21,19 +21,19 @@
     <title>Documentation :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/" selected>dev</option>
@@ -2448,20 +2474,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/sitemap.xml b/docs/dev/sitemap.xml
index afb05b0..ee05e52 100644
--- a/docs/dev/sitemap.xml
+++ b/docs/dev/sitemap.xml
@@ -11,6 +11,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/"
                 />
@@ -35,6 +40,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/concepts/"
                 />
@@ -59,6 +69,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/device-identity/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/concepts/device-identity/"
                 />
@@ -76,6 +91,16 @@
   
   <url>
     <loc>https://www.eclipse.org/hono/docs/dev/concepts/tenancy/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/concepts/tenancy/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/concepts/tenancy/"
+                />
   </url>
   
   <url>
@@ -87,6 +112,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/device-provisioning/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/concepts/device-provisioning/"
                 />
@@ -106,6 +136,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/connecting-devices/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/concepts/connecting-devices/"
                 />
@@ -118,10 +153,30 @@
   
   <url>
     <loc>https://www.eclipse.org/hono/docs/dev/concepts/device-notifications/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/concepts/device-notifications/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/concepts/device-notifications/"
+                />
   </url>
   
   <url>
     <loc>https://www.eclipse.org/hono/docs/dev/concepts/command-and-control/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/concepts/command-and-control/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/concepts/command-and-control/"
+                />
   </url>
   
   <url>
@@ -133,6 +188,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/resource-limits/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/concepts/resource-limits/"
                 />
@@ -157,6 +217,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/connection-events/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/concepts/connection-events/"
                 />
@@ -181,6 +246,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/"
                 />
@@ -198,10 +268,30 @@
   
   <url>
     <loc>https://www.eclipse.org/hono/docs/dev/user-guide/mongodb-based-device-registry/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/user-guide/mongodb-based-device-registry/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/user-guide/mongodb-based-device-registry/"
+                />
   </url>
   
   <url>
     <loc>https://www.eclipse.org/hono/docs/dev/user-guide/file-based-device-registry/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/user-guide/file-based-device-registry/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/user-guide/file-based-device-registry/"
+                />
   </url>
   
   <url>
@@ -213,6 +303,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/http-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/http-adapter/"
                 />
@@ -237,6 +332,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/mqtt-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/mqtt-adapter/"
                 />
@@ -261,6 +361,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/amqp-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/amqp-adapter/"
                 />
@@ -285,6 +390,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/coap-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="dev"
                 href="https://www.eclipse.org/hono/docs/dev/user-guide/coap-adapter/"
                 />
@@ -299,6 +409,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/kura-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/kura-adapter/"
                 />
@@ -323,6 +438,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/sigfox-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/sigfox-adapter/"
                 />
@@ -347,6 +467,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/jmeter_load_tests/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/jmeter_load_tests/"
                 />
@@ -371,6 +496,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/"
                 />
@@ -395,6 +525,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/common-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/common-config/"
                 />
@@ -419,6 +554,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/auth-server-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/auth-server-config/"
                 />
@@ -436,10 +576,30 @@
   
   <url>
     <loc>https://www.eclipse.org/hono/docs/dev/admin-guide/mongodb-device-registry-config/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/admin-guide/mongodb-device-registry-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/admin-guide/mongodb-device-registry-config/"
+                />
   </url>
   
   <url>
     <loc>https://www.eclipse.org/hono/docs/dev/admin-guide/file-based-device-registry-config/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/admin-guide/file-based-device-registry-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/admin-guide/file-based-device-registry-config/"
+                />
   </url>
   
   <url>
@@ -451,6 +611,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/device-connection-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/device-connection-config/"
                 />
@@ -475,6 +640,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/http-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/http-adapter-config/"
                 />
@@ -499,6 +669,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/mqtt-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/mqtt-adapter-config/"
                 />
@@ -523,6 +698,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/amqp-adapter-config/"
                 />
@@ -540,6 +720,16 @@
   
   <url>
     <loc>https://www.eclipse.org/hono/docs/dev/admin-guide/coap-adapter-config/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/admin-guide/coap-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/admin-guide/coap-adapter-config/"
+                />
   </url>
   
   <url>
@@ -551,6 +741,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/kura-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/kura-adapter-config/"
                 />
@@ -575,6 +770,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/hono-client-configuration/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/hono-client-configuration/"
                 />
@@ -599,6 +799,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-network-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/amqp-network-config/"
                 />
@@ -623,6 +828,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/secure_communication/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/secure_communication/"
                 />
@@ -647,6 +857,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/monitoring-tracing-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/monitoring-tracing-config/"
                 />
@@ -671,6 +886,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/dev-guide/"
                 />
@@ -695,6 +915,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/building_hono/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/dev-guide/building_hono/"
                 />
@@ -719,6 +944,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/amqp_adapter_client/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="dev"
                 href="https://www.eclipse.org/hono/docs/dev/dev-guide/amqp_adapter_client/"
                 />
@@ -733,6 +963,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/java_client_consumer/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/dev-guide/java_client_consumer/"
                 />
@@ -757,6 +992,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/custom_http_adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/dev-guide/custom_http_adapter/"
                 />
@@ -781,6 +1021,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/"
                 />
@@ -805,6 +1050,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/telemetry/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/telemetry/"
                 />
@@ -829,6 +1079,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/event/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/event/"
                 />
@@ -853,6 +1108,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/command-and-control/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/command-and-control/"
                 />
@@ -877,6 +1137,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/tenant/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/tenant/"
                 />
@@ -901,6 +1166,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/device-connection/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/device-connection/"
                 />
@@ -925,6 +1195,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/device-registration/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/device-registration/"
                 />
@@ -949,6 +1224,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/credentials/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/credentials/"
                 />
@@ -973,6 +1253,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/authentication/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/authentication/"
                 />
@@ -997,6 +1282,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/management/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/management/"
                 />
@@ -1021,6 +1311,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/metrics/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/metrics/"
                 />
@@ -1045,6 +1340,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/deployment/"
                 />
@@ -1069,6 +1369,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/helm-based-deployment/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/deployment/helm-based-deployment/"
                 />
@@ -1093,6 +1398,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/openshift/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/deployment/openshift/"
                 />
@@ -1117,6 +1427,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/create-kubernetes-cluster/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/deployment/create-kubernetes-cluster/"
                 />
@@ -1141,6 +1456,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/resource-limitation/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/deployment/resource-limitation/"
                 />
@@ -1165,6 +1485,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/architecture/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/architecture/"
                 />
@@ -1189,6 +1514,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/architecture/component-view/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/architecture/component-view/"
                 />
@@ -1213,6 +1543,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/architecture/auth/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/architecture/auth/"
                 />
@@ -1238,6 +1573,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/categories/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/categories/"
                 />
@@ -1263,6 +1603,11 @@
                 />
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/tags/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/tags/"
                 />
diff --git a/docs/dev/tags/index.html b/docs/dev/tags/index.html
index d996ad5..d715f66 100644
--- a/docs/dev/tags/index.html
+++ b/docs/dev/tags/index.html
@@ -21,19 +21,19 @@
     <title>Tags :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/tags/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/tags/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/tags/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/tags/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/tags/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/tags/" selected>dev</option>
@@ -2477,20 +2503,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/user-guide/amqp-adapter/index.html b/docs/dev/user-guide/amqp-adapter/index.html
index 45838e9..5d1514e 100644
--- a/docs/dev/user-guide/amqp-adapter/index.html
+++ b/docs/dev/user-guide/amqp-adapter/index.html
@@ -21,19 +21,19 @@
     <title>AMQP Adapter :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/amqp-adapter/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/amqp-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/amqp-adapter/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/amqp-adapter/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/amqp-adapter/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/amqp-adapter/" selected>dev</option>
@@ -3181,20 +3207,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/user-guide/coap-adapter/index.html b/docs/dev/user-guide/coap-adapter/index.html
index 7754abb..67d5ece 100644
--- a/docs/dev/user-guide/coap-adapter/index.html
+++ b/docs/dev/user-guide/coap-adapter/index.html
@@ -21,19 +21,19 @@
     <title>CoAP Adapter :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/coap-adapter/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/coap-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/coap-adapter/">1.2</option>
                     
                   
               
@@ -1354,6 +1374,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/coap-adapter/" selected>dev</option>
@@ -3473,20 +3495,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/user-guide/file-based-device-registry/index.html b/docs/dev/user-guide/file-based-device-registry/index.html
index 5f73b5c..d80d7e6 100644
--- a/docs/dev/user-guide/file-based-device-registry/index.html
+++ b/docs/dev/user-guide/file-based-device-registry/index.html
@@ -21,19 +21,19 @@
     <title>File Based Device Registry :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1332,6 +1332,26 @@
               
               
                   
+                    
+                    
+                      <option id="stable" value="/hono/docs/user-guide/file-based-device-registry/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
               
                   
               
@@ -2495,20 +2515,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/user-guide/http-adapter/index.html b/docs/dev/user-guide/http-adapter/index.html
index 8f10dab..924027c 100644
--- a/docs/dev/user-guide/http-adapter/index.html
+++ b/docs/dev/user-guide/http-adapter/index.html
@@ -21,19 +21,19 @@
     <title>HTTP Adapter :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/http-adapter/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/http-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/http-adapter/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/http-adapter/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/http-adapter/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/http-adapter/" selected>dev</option>
@@ -3385,20 +3411,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/user-guide/index.html b/docs/dev/user-guide/index.html
index b13ff57..7d91b02 100644
--- a/docs/dev/user-guide/index.html
+++ b/docs/dev/user-guide/index.html
@@ -21,19 +21,19 @@
     <title>User Guide :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/" selected>dev</option>
@@ -2496,20 +2522,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/user-guide/jmeter_load_tests/index.html b/docs/dev/user-guide/jmeter_load_tests/index.html
index c9d76cc..2b72c68 100644
--- a/docs/dev/user-guide/jmeter_load_tests/index.html
+++ b/docs/dev/user-guide/jmeter_load_tests/index.html
@@ -21,19 +21,19 @@
     <title>Load Tests with JMeter :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/jmeter_load_tests/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/jmeter_load_tests/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/jmeter_load_tests/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/jmeter_load_tests/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/jmeter_load_tests/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/jmeter_load_tests/" selected>dev</option>
@@ -2547,20 +2573,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/user-guide/kura-adapter/index.html b/docs/dev/user-guide/kura-adapter/index.html
index cb2ee38..253b403 100644
--- a/docs/dev/user-guide/kura-adapter/index.html
+++ b/docs/dev/user-guide/kura-adapter/index.html
@@ -21,19 +21,19 @@
     <title>Kura Adapter :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/kura-adapter/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/kura-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/kura-adapter/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/kura-adapter/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/kura-adapter/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/kura-adapter/" selected>dev</option>
@@ -2712,20 +2738,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/user-guide/mongodb-based-device-registry/index.html b/docs/dev/user-guide/mongodb-based-device-registry/index.html
index 0f2b1bc..34cb659 100644
--- a/docs/dev/user-guide/mongodb-based-device-registry/index.html
+++ b/docs/dev/user-guide/mongodb-based-device-registry/index.html
@@ -21,19 +21,19 @@
     <title>MongoDB Based Device Registry :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1332,6 +1332,26 @@
               
               
                   
+                    
+                    
+                      <option id="stable" value="/hono/docs/user-guide/mongodb-based-device-registry/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
               
                   
               
@@ -2489,20 +2509,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/user-guide/mqtt-adapter/index.html b/docs/dev/user-guide/mqtt-adapter/index.html
index 871a5f1..4f45109 100644
--- a/docs/dev/user-guide/mqtt-adapter/index.html
+++ b/docs/dev/user-guide/mqtt-adapter/index.html
@@ -21,19 +21,19 @@
     <title>MQTT Adapter :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/mqtt-adapter/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/mqtt-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/mqtt-adapter/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/mqtt-adapter/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/mqtt-adapter/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/mqtt-adapter/" selected>dev</option>
@@ -3132,20 +3158,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/dev/user-guide/sigfox-adapter/index.html b/docs/dev/user-guide/sigfox-adapter/index.html
index b87e65b..6d0e754 100644
--- a/docs/dev/user-guide/sigfox-adapter/index.html
+++ b/docs/dev/user-guide/sigfox-adapter/index.html
@@ -21,19 +21,19 @@
     <title>Sigfox Adapter :: Eclipse Hono&trade; Vers.: dev</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208215" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208215" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294629" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294629" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208215" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294629" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208215"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294629"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208215"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294629"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294629"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/dev";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208215"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294629"></script>
 
     
   </div>
@@ -1334,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/sigfox-adapter/">stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/sigfox-adapter/">stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/sigfox-adapter/">1.2</option>
                     
                   
               
@@ -1350,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/sigfox-adapter/">1.1</option>
@@ -1368,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/sigfox-adapter/">1.0</option>
@@ -1386,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/sigfox-adapter/" selected>dev</option>
@@ -2665,20 +2691,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208215"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208215"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208215"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208215"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208215"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208215"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294629"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294629"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294629"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294629"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294629"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294629"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208215"></script>
-    <script src="/hono/docs/js/learn.js?1595208215"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208215"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294629"></script>
+    <script src="/hono/docs/js/learn.js?1595294629"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294629"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208215" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208215"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294629" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294629"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/index.html b/docs/index.html
index 1c8b5bf..1840195 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -21,19 +21,19 @@
     <title>Documentation :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/">dev</option>
@@ -1727,6 +1810,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -1935,6 +2034,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2337,20 +2468,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/index.json b/docs/index.json
index 838d07d..6dc7838 100644
--- a/docs/index.json
+++ b/docs/index.json
@@ -18,21 +18,21 @@
 	"title": "Device Identity",
 	"tags": [],
 	"description": "",
-	"content": "This page describes how devices are represented and identified throughout Hono and its APIs.\nThe main purpose of Hono is to provide a uniform API for applications to interact with devices, regardless of the particular communication protocol the devices natively use. In order to do so, Hono uses a unique logical identifier to refer to each device individually.\nHono does not make any assumptions about the format of a device identifier (or device-id for short). It basically is a string which is defined at the time a device is being provisioned. Once created, the device can be referred to by this identifier when using Hono\u0026rsquo;s APIs until the device is being removed from the system.\nTenant Hono supports the logical partitioning of devices into groups called tenants. Each tenant has a unique identifier, a string called the tenant-id, and can be used to provide a logical grouping of devices belonging e.g. to the same application scope or organizational unit. Each device can thus be uniquely identified by the tuple (tenant-id, device-id). This tuple is broadly used throughout Hono\u0026rsquo;s APIs when addressing a particular device.\nDevice Registration Hono components use the Device Registration API to access device registration information. The API defines the assert Registration operation for verifying a device\u0026rsquo;s registration status. In many real world scenarios there will already be a component in place which keeps track of devices and which supports the particular provisioning process being used to bring devices into life. In such cases it makes sense to simply implement the Device Registration API as a facade on top of the existing component.\nIn addition to that, Hono defines a Device Registry Management API, which can be implemented to take advantage of standardized operations for managing devices and credentials. This API is optional because Hono components do not require it during runtime.\nFor demonstration purposes, Hono comes with a simple default implementation of both APIs which keeps all data in memory only. Therefore it is not supposed to be used in production scenarios. For the future, it is planned that a production-ready Device Registry will be released as part of Hono that implements both APIs.\nDevice Authentication Devices connect to protocol adapters in order to publish telemetry data or events. Downstream applications consuming this data often take particular actions based on the content of the messages. Such actions may include simply updating some statistics, e.g. tracking the average room temperature, but may also trigger more serious activities like shutting down a power plant. It is therefore important that applications can rely on the fact that the messages they process have in fact been produced by the device indicated by a message\u0026rsquo;s source address.\nHono relies on protocol adapters to establish a device\u0026rsquo;s identity before it is allowed to publish downstream data or receive commands. Conceptually, Hono distinguishes between two identities\n an identity associated with the authentication credentials (termed the authentication identity or auth-id), and an identity to act as (the device identity or device-id).  A device therefore presents an auth-id as part of its credentials during the authentication process which is then resolved to a device identity by the protocol adapter on successful verification of the credentials.\nIn order to support the protocol adapters in the process of verifying credentials presented by a device, the Credentials API provides means to look up secrets on record for the device and use this information to verify the credentials.\nThe Credentials API supports registration of multiple sets of credentials for each device. A set of credentials consists of an auth-id and some sort of secret information. The particular type of secret determines the kind of information kept. Please refer to the Standard Credential Types defined in the Credentials API for details. Based on this approach, a device may be authenticated using different types of secrets, e.g. a hashed password or a pre-shared key, depending on the capabilities of the device and/or protocol adapter.\nOnce the protocol adapter has resolved the device-id for a device, it uses this identity when referring to the device in all subsequent API invocations, e.g. when forwarding telemetry messages downstream to the AMQP Messaging Network.\n"
+	"content": "This page describes how devices are represented and identified throughout Hono and its APIs.\nThe main purpose of Hono is to provide a uniform API for applications to interact with devices, regardless of the particular communication protocol the devices natively use. In order to do so, Hono uses a unique logical identifier to refer to each device individually.\nHono does not make any assumptions about the format of a device identifier (or device-id for short). It basically is a string which is defined at the time a device is being provisioned. Once created, the device can be referred to by this identifier when using Hono\u0026rsquo;s APIs until the device is being removed from the system.\nTenant Hono supports the logical partitioning of devices into groups called tenants. Each tenant has a unique identifier, a string called the tenant-id, and can be used to provide a logical grouping of devices belonging e.g. to the same application scope or organizational unit. Each device can thus be uniquely identified by the tuple (tenant-id, device-id). This tuple is broadly used throughout Hono\u0026rsquo;s APIs when addressing a particular device.\nDevice Registration Hono components use the Device Registration API to access device registration information. The API defines the assert Registration operation for verifying a device\u0026rsquo;s registration status. In many real world scenarios there will already be a component in place which keeps track of devices and which supports the particular provisioning process being used to bring devices into life. In such cases it makes sense to simply implement the Device Registration API as a facade on top of the existing component.\nIn addition to that, Hono defines a Device Registry Management API, which can be implemented to take advantage of standardized operations for managing devices and credentials. This API is optional because Hono components do not require it during runtime.\nHono comes with a MongoDB and a simple file based implementations of both APIs. The file based implementation, which keeps all data in memory, is to be used only for demonstration purposes and is not supposed to be used in production scenarios.\nDevice Authentication Devices connect to protocol adapters in order to publish telemetry data or events. Downstream applications consuming this data often take particular actions based on the content of the messages. Such actions may include simply updating some statistics, e.g. tracking the average room temperature, but may also trigger more serious activities like shutting down a power plant. It is therefore important that applications can rely on the fact that the messages they process have in fact been produced by the device indicated by a message\u0026rsquo;s source address.\nHono relies on protocol adapters to establish a device\u0026rsquo;s identity before it is allowed to publish downstream data or receive commands. Conceptually, Hono distinguishes between two identities\n an identity associated with the authentication credentials (termed the authentication identity or auth-id), and an identity to act as (the device identity or device-id).  A device therefore presents an auth-id as part of its credentials during the authentication process which is then resolved to a device identity by the protocol adapter on successful verification of the credentials.\nIn order to support the protocol adapters in the process of verifying credentials presented by a device, the Credentials API provides means to look up secrets on record for the device and use this information to verify the credentials.\nThe Credentials API supports registration of multiple sets of credentials for each device. A set of credentials consists of an auth-id and some sort of secret information. The particular type of secret determines the kind of information kept. Please refer to the Standard Credential Types defined in the Credentials API for details. Based on this approach, a device may be authenticated using different types of secrets, e.g. a hashed password or a pre-shared key, depending on the capabilities of the device and/or protocol adapter.\nOnce the protocol adapter has resolved the device-id for a device, it uses this identity when referring to the device in all subsequent API invocations, e.g. when forwarding telemetry messages downstream to the AMQP Messaging Network.\n"
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/concepts/tenancy/",
 	"title": "Multi-Tenancy",
 	"tags": [],
 	"description": "",
-	"content": " Hono is designed to structure the set of all internally managed data and data streams into strictly isolated subsets. This includes the registration data and credentials of devices, internal users that are used for authentication, and the Business Applications that are part of such subsets as well.\nThis way of strict isolation is generally known as multi-tenancy, where a tenant is the term for such a subset. Such an isolation is essential for enabling a scalable distributed architecture to handle independent subsets as if each subset had its own installation (which would be much harder to maintain and would not benefit from runtime cost sharing).\nHono\u0026rsquo;s multi-tenancy concept is based on handling tenants as own entities. All functionality of Hono is provided in the context of a previously created tenant - except the creation of a tenant itself.\nIn the following the different aspects of multi-tenancy in Hono are addressed and a full overview of the concept is given.\nThe Tenant API By means of the Tenant API Hono handles tenants as own entities. The API defines how to retrieve the details of a specific tenant. This offers the possibility to handle arbitrary properties on the level of a tenant (see e.g. Protocol adapter configuration). For convenience, there are CRUD operations for the handling of tenants, which can be found in the Device Registry.\nProtocol Adapters respect the Tenant API When a device connects to one of Hono\u0026rsquo;s protocol adapters, the adapter determines the tenant this device belongs to. How this is done is described in the User Guide. After the tenant is determined, the adapter retrieves the details of the determined tenant by means of the Tenant API. Only if the tenant exists and is enabled the adapter further processes the data of the device that is connecting. Otherwise the connection will be closed.\nProtocol Adapter Configuration Protocol adapters retrieve parts of their configuration on a tenant level by using the details of the determined tenant. This includes e.g. if a specific protocol adapter is enabled at all for this tenant, allowing to define tenants with only a subset of Hono\u0026rsquo;s functionality. This feature is foreseen to be especially important for production setups.\nExample: a tenant that\n can use the MQTT protocol adapter but is not allowed to use the HTTP protocol adapter  Please refer to the Tenant API to find out which protocol adapter properties can be configured at the tenant level.\nAMQP 1.0 Endpoints The AMQP 1.0 endpoints for all APIs of Hono are scoped to a tenant, by using the scheme \u0026lt;api-name\u0026gt;/TENANT/....\nExamples:\n telemetry/TENANT registration/TENANT  etc.\nThis separates the AMQP endpoints from each other on a tenant level.\nThe only exception to this is the Tenant API, which does not follow this scheme since it is addressing the tenants themselves.\nDevices and Tenants A physical device will usually be represented in Hono as an entity in the device registry, having a unique identity and belonging to exactly one tenant. All data sent from a device, as well as from the application to the device, is therefore treated as belonging to the corresponding tenant.\nThe following diagram shows the relation between tenants, devices and their credentials:\n  Tenants, Devices and Credentials   Tenant based Flow Control An important detail in Hono\u0026rsquo;s architecture is that data sent downstream is transported via the tenant scoped AMQP 1.0 links from the protocol adapters to the AMQP 1.0 network. Each tenant has its own pair of AMQP 1.0 links and is treated independently from other tenants regarding the back pressure mechanism that AMQP 1.0 offers. This enables a Business application to limit the rate at which it consumes AMQP 1.0 messages per tenant.\nFor the other direction, when commands are sent from the application to the device, the rate is also limited per tenant.\nAuthorization at Tenant Level Hono\u0026rsquo;s components authenticate each other by means of the Authentication API. The returned token for a successful authentication contains authorization information that is addressing the AMQP 1.0 endpoints. Since the endpoints (as outlined above) are scoped to a tenant, this enables to configure tenants that are authorized to only a subset of Hono\u0026rsquo;s full functionality.\nExample: a tenant (defined by means of authorization configuration) that\n is allowed to send telemetry data downstream but is not allowed to send event data  This is done by not including the event endpoint in the authorization token for these tenants.\nBusiness Applications and Tenants The northbound Business applications are always connecting to the AMQP 1.0 endpoints of Hono. By means of the authentication and authorization setup and the fact that the endpoints are scoped to a tenant, the Business application is only acting in the context of one tenant.\nSeparation of Tenants Tenants are separated from each other in all of Hono\u0026rsquo;s components. Here is a summary of how this is implemented:\n the registration of devices are strictly scoped to a tenant the credentials of devices are strictly scoped to a tenant protocol adapters can be enabled/disabled for a tenant the downstream data flow is isolated for every tenant the upstream data flow (Command \u0026amp; Control) is isolated for every tenant Business applications need to authenticate to the AMQP 1.0 network and are by that mechanism scoped to their tenant  Hints for Production To be flexible for the different needs of production setups, Hono tries to make as few assumptions about the combination of the different APIs as possible. This means e.g. that the Device Registry does not enforce referential integrity of the APIs:\n devices can be created for a tenant that is not existing (yet) credentials can be created for a tenant and/or a device that is not existing (yet) tenants can be deleted and leave their scoped devices and credentials still in the configuration (which may not be usable anymore, since the tenant is missing)  These are points that production setups may want to implement differently.\n"
+	"content": " Hono is designed to structure the set of all internally managed data and data streams into strictly isolated subsets. This includes the registration data and credentials of devices, internal users that are used for authentication, and the Business Applications that are part of such subsets as well.\nThis way of strict isolation is generally known as multi-tenancy, where a tenant is the term for such a subset. Such an isolation is essential for enabling a scalable distributed architecture to handle independent subsets as if each subset had its own installation (which would be much harder to maintain and would not benefit from runtime cost sharing).\nHono\u0026rsquo;s multi-tenancy concept is based on handling tenants as own entities. All functionality of Hono is provided in the context of a previously created tenant - except the creation of a tenant itself.\nIn the following the different aspects of multi-tenancy in Hono are addressed and a full overview of the concept is given.\nThe Tenant API By means of the Tenant API Hono handles tenants as own entities. The API defines how to retrieve the details of a specific tenant. This offers the possibility to handle arbitrary properties on the level of a tenant (see e.g. Protocol adapter configuration). For convenience, there are CRUD operations for the handling of tenants, which can be found in the Device Registry Management API.\nProtocol Adapters respect the Tenant API When a device connects to one of Hono\u0026rsquo;s protocol adapters, the adapter determines the tenant this device belongs to. How this is done is described in the User Guide. After the tenant is determined, the adapter retrieves the details of the determined tenant by means of the Tenant API. Only if the tenant exists and is enabled the adapter further processes the data of the device that is connecting. Otherwise the connection will be closed.\nProtocol Adapter Configuration Protocol adapters retrieve parts of their configuration on a tenant level by using the details of the determined tenant. This includes e.g. if a specific protocol adapter is enabled at all for this tenant, allowing to define tenants with only a subset of Hono\u0026rsquo;s functionality. This feature is foreseen to be especially important for production setups.\nExample: a tenant that\n can use the MQTT protocol adapter but is not allowed to use the HTTP protocol adapter  Please refer to the Tenant API to find out which protocol adapter properties can be configured at the tenant level.\nAMQP 1.0 Endpoints The AMQP 1.0 endpoints for all APIs of Hono are scoped to a tenant, by using the scheme \u0026lt;api-name\u0026gt;/TENANT/....\nExamples:\n telemetry/TENANT event/TENANT registration/TENANT  This separates the AMQP endpoints from each other on a tenant level.\nThe only exception to this is the Tenant API which does not follow this scheme since it is addressing the tenants themselves.\nDevices and Tenants A physical device will usually be represented in Hono as an entity in the device registry, having a unique identity and belonging to exactly one tenant. All data sent from a device, as well as from the application to the device, is therefore treated as belonging to the corresponding tenant.\nThe following diagram shows the relation between tenants, devices and their credentials:\n  Tenants, Devices and Credentials   Tenant based Flow Control An important detail in Hono\u0026rsquo;s architecture is that data sent downstream is transported via the tenant scoped AMQP 1.0 links from the protocol adapters to the AMQP 1.0 network. Each tenant has its own pair of AMQP 1.0 links and is treated independently from other tenants regarding the back pressure mechanism that AMQP 1.0 offers. This enables a Business application to limit the rate at which it consumes AMQP 1.0 messages per tenant.\nFor the other direction, when commands are sent from the application to the device, the rate is also limited per tenant.\nAuthorization at Tenant Level Hono\u0026rsquo;s components authenticate each other by means of the Authentication API. The returned token for a successful authentication contains authorization information that is addressing the AMQP 1.0 endpoints. Since the endpoints (as outlined above) are scoped to a tenant, this enables to configure tenants that are authorized to only a subset of Hono\u0026rsquo;s full functionality.\nExample: a tenant (defined by means of authorization configuration) that\n is allowed to send telemetry data downstream but is not allowed to send event data  This is done by not including the event endpoint in the authorization token for these tenants.\nBusiness Applications and Tenants The northbound Business applications are always connecting to the AMQP 1.0 endpoints of Hono. By means of the authentication and authorization setup and the fact that the endpoints are scoped to a tenant, the Business application is only acting in the context of one tenant.\nSeparation of Tenants Tenants are separated from each other in all of Hono\u0026rsquo;s components. Here is a summary of how this is implemented:\n the registration of devices are strictly scoped to a tenant the credentials of devices are strictly scoped to a tenant protocol adapters can be enabled/disabled for a tenant the downstream data flow is isolated for every tenant the upstream data flow (Command \u0026amp; Control) is isolated for every tenant Business applications need to authenticate to the AMQP 1.0 network and are by that mechanism scoped to their tenant  Hints for Production To be flexible for the different needs of production setups, Hono tries to make as few assumptions about the combination of the different APIs as possible. This means e.g. that the Device Registry does not enforce referential integrity of the APIs:\n devices can be created for a tenant that is not existing (yet) credentials can be created for a tenant and/or a device that is not existing (yet) tenants can be deleted and leave their scoped devices and credentials still in the configuration (which may not be usable anymore, since the tenant is missing)  These are points that production setups may want to implement differently.\n"
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/concepts/device-provisioning/",
 	"title": "Device Provisioning",
 	"tags": [],
 	"description": "",
-	"content": " This page describes how devices are provisioned in Hono, i.e. how their digital representation is generated. For each device, registration information is stored that defines a device identity. Each device belongs to exactly one tenant. Each device must have at least one set of credentials that are used to authenticate to Hono.\nTo get an understanding of what is meant by the terms tenant, device registration and credentials, it is recommended to read the Device Identity page first.\nSo in order to use a device with Hono, it has to be provisioned. This means that registration information and at least one credential record must be stored in the device registry.\nThere are different ways to perform device provisioning.\nManual Device Provisioning Devices can be provisioned using Hono\u0026rsquo;s Device Registry Management API via HTTP.\nIf the desired tenant does not yet exist, it must be created first. How to do this is described in the User Guide of the Device Registry.\nThe actual Device Provisioning is then performed as described under Register Device. This creates both a device identity and an (empty) credentials record. The last step is to add real credentials as described in Update Credentials for a Device.\nAutomatic Device Provisioning The term Auto-Provisioning denotes a feature of Hono where the Device Registry automatically generates the credentials and registration information for a device the first time it connects. Auto-Provisioning is supported by Hono\u0026rsquo;s protocol adapters for devices that authenticate with client certificates. The feature can be enabled per certificate authority (CA) at the tenant.\nPrerequisites Hono does not require a specific Device Registry implementation, but only specifies a set of APIs that must be provided by a compatible implementation. Since the main part of the Auto-Provisioning has to be done by the Device Registry, the used implementation must explicitly support this feature.\nSequence of steps in Auto-Provisioning Auto-Provisioning consists of two steps.\nStep 1: Configure the Tenant The CA to be used by the devices needs to be configured. The following tasks must be performed:\n Create tenant Configure the trusted CA for the tenant Enable the feature for the CA  If the Device Registry implementation provides the Management API, this could be done in a single step. For details refer to the Tenant API specification.\nStep 2: Connect an unregistered Device to Hono   Automatic Provisioning of a Device   Hono\u0026rsquo;s protocol adapters query the APIs of the Device Registry during Device Authentication. First, the Tenant API is queried. If the Tenant configuration returned contains the CA used for authentication and the feature is switched on for this CA, the protocol adapter assumes that automatic provisioning must be performed. It puts the device\u0026rsquo;s certificate into the query to enable the device registry to do the provisioning.\nIf the Device Registry does not find any credentials for the device, it takes the information from the client certificate to create both credentials and device registration data for it.\nThe Device Registry is expected to perform the following steps:\n Generate a unique device-id Create device Create credentials Optional: Provision device in external systems  The newly created credentials are returned to the protocol adapter in the response as if they had been present before.\nThe following query of the Device Registration API returns the previously generated registration data.\nThe provisioning is, of course, a one-time action, on subsequent connections the APIs simply return the stored records.\n"
+	"content": " This page describes how devices are provisioned in Hono, i.e. how their digital representation is generated. For each device, registration information is stored that defines a device identity. Each device belongs to exactly one tenant. Each device must have at least one set of credentials that are used to authenticate to Hono.\nTo get an understanding of what is meant by the terms tenant, device registration and credentials, it is recommended to read the Device Identity page first.\nSo in order to use a device with Hono, it has to be provisioned. This means that registration information and at least one credential record must be stored in the device registry.\nThere are different ways to perform device provisioning.\nManual Device Provisioning Devices can be provisioned using Hono\u0026rsquo;s Device Registry Management API via HTTP.\nIf the desired tenant does not yet exist, it must be created first. How to do this is described in the tenants section of the Device Registry Management API.\nThe actual Device Provisioning is then performed by adding devices as described under devices section of the Device Registry Management API. This creates both a device identity and an (empty) credentials record. The last step is to add real credentials as described in the credentials section of the Device Registry Management API.\nAutomatic Device Provisioning The term Auto-Provisioning denotes a feature of Hono where the Device Registry automatically generates the credentials and registration information for a device the first time it connects. Auto-Provisioning is supported by Hono\u0026rsquo;s protocol adapters for devices that authenticate with client certificates. The feature can be enabled per certificate authority (CA) at the tenant.\nPrerequisites Hono does not require a specific Device Registry implementation, but only specifies a set of APIs that must be provided by a compatible implementation. Since the main part of the Auto-Provisioning has to be done by the Device Registry, the used implementation must explicitly support this feature.\nSequence of steps in Auto-Provisioning Auto-Provisioning consists of two steps.\nStep 1: Configure the Tenant The CA to be used by the devices needs to be configured. The following tasks must be performed:\n Create tenant Configure the trusted CA for the tenant Enable the feature for the CA  If the Device Registry implementation provides the Management API, this could be done in a single step. For details refer to the Tenant API specification.\nStep 2: Connect an unregistered Device to Hono   Automatic Provisioning of a Device   Hono\u0026rsquo;s protocol adapters query the APIs of the Device Registry during Device Authentication. First, the Tenant API is queried. If the Tenant configuration returned contains the CA used for authentication and the feature is switched on for this CA, the protocol adapter assumes that automatic provisioning must be performed. It puts the device\u0026rsquo;s certificate into the query to enable the device registry to do the provisioning.\nIf the Device Registry does not find any credentials for the device, it takes the information from the client certificate to create both credentials and device registration data for it.\nThe Device Registry is expected to perform the following steps:\n Generate a unique device-id Create device Create credentials Optional: Provision device in external systems  The newly created credentials are returned to the protocol adapter in the response as if they had been present before.\nThe following query of the Device Registration API returns the previously generated registration data.\nThe provisioning is, of course, a one-time action, on subsequent connections the APIs simply return the stored records.\n"
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/concepts/connecting-devices/",
@@ -77,46 +77,53 @@
 	"content": " User Guide Learn how Eclipse Hono\u0026trade; enables you to quickly send data from devices to business applications and vice versa.\n"
 },
 {
-	"uri": "https://www.eclipse.org/hono/docs/user-guide/device-registry/",
-	"title": "Device Registry",
+	"uri": "https://www.eclipse.org/hono/docs/user-guide/mongodb-based-device-registry/",
+	"title": "MongoDB Based Device Registry",
 	"tags": [],
 	"description": "",
-	"content": "The Device Registry component provides exemplary implementations of Hono\u0026rsquo;s Tenant API, Device Registration API and Credentials API.\nAs such it exposes AMQP 1.0 based endpoints for retrieving the relevant information and persists data in the local filesystem.\nIn addition, the Device Registry also exposes HTTP resources for managing the contents of the registry according to the Device Registry HTTP API.\n Warning The Device Registry is not intended to be used in production environments. In particular, access to the HTTP resources described below is not restricted to authorized clients only.\nThe resources have been designed to provide convenient access to the registry\u0026rsquo;s content using command line tools like curl or HTTPie.\n  Managing Tenants The following sections describe the resources representing the operations of the Tenant API and how they can be used to manage tenants. Please refer to the Device Registry HTTP API for the specific elements that are explained in detail there.\nAdd a Tenant  URI: /v1/tenants/${tenantId} Method: POST Request Headers:  (required) Content-Type: application/json (no other type supported)  Request Body:  (Optional) A JSON object as specified by Tenant schema of the HTTP API specification.  Status Codes:  201 (Created): Tenant has been added successfully under the resource indicated by Location header. 400 (Bad Request): The tenant has not been created because the request was malformed, e .g. because the payload was malformed. The response body may contain hints regarding the cause of the problem. 409 (Conflict): A tenant with the given tenantId already exists. The request has not been processed.  Response Headers:  Location: The URI under which the newly created resource can be accessed. ETag: Version of the resource   Example\nThe following commands add some tenants with different adapter configurations:\nAdd a tenant that has all adapters set to enabled:\ncurl -i -X POST http://localhost:28080/v1/tenants/tenantAllAdapters HTTP/1.1 201 Created ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4 Location: /v1/tenants/tenantAllAdapters Content-Type: application/json; charset=utf-8 {\u0026quot;id\u0026quot;: \u0026quot;tenantAllAdapters\u0026quot;}  Add a tenant that can only use the MQTT adapter:\ncurl -i -X POST -H 'Content-Type: application/json' --data-binary '{ \u0026quot;adapters\u0026quot;: [ { \u0026quot;type\u0026quot;: \u0026quot;hono-mqtt\u0026quot;, \u0026quot;enabled\u0026quot;: true } ] }' http://localhost:28080/v1/tenants/tenantMqttAdapter HTTP/1.1 201 Created ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4 Location: /v1/tenants/tenantMqttAdapter Content-Type: application/json; charset=utf-8 {\u0026quot;id\u0026quot;: \u0026quot;tenantMqttAdapter\u0026quot;}  Get configuration details of a Tenant  URI: /v1/tenants/${tenantId} Method: GET Status Codes:  200 (OK): A tenant with the given identifier has been found. The response body contains the tenant data as specified by Tenant schema of the HTTP API specification. 404 (Not Found): No tenant with the given identifier is registered.   Example\nThe following command retrieves the details for the tenant tenantMqttAdapter:\ncurl -i http://localhost:28080/v1/tenants/tenantMqttAdapter HTTP/1.1 200 OK ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4 Content-Type: application/json; charset=utf-8 { \u0026quot;enabled\u0026quot;: true, \u0026quot;adapters\u0026quot;: [ { \u0026quot;type\u0026quot;: \u0026quot;hono-mqtt\u0026quot;, \u0026quot;enabled\u0026quot;: true } ] }  NB A tenant can be created without specifying a tenant identifier. The device registry will generate a tenant ID:\ncurl -i -X POST http://localhost:28080/v1/tenants/ HTTP/1.1 201 Created Etag: edc93899-7838-4dd1-93c8-839748c2fa42 location: /v1/tenants/0b2df55f-1a02-43f7-a1c0-f3dbd25041e0 content-type: application/json; charset=utf-8 content-length: 45 {\u0026quot;id\u0026quot;:\u0026quot;0b2df55f-1a02-43f7-a1c0-f3dbd25041e0\u0026quot;}  Update Tenant  URI: /v1/tenants/${tenantId} Method: PUT Request Headers:  (required) Content-Type: application/json (no other type supported)  Request Body:  (required) A JSON object as specified by Tenant schema of the HTTP API specification.  Status Codes:  204 (No Content): The tenant has been updated successfully. 400 (Bad Request): The tenant has not been updated because the request was malformed, e .g. because the payload was malformed. The response body may contain hints regarding the cause of the problem. 404 (Not Found): The request could not be processed because no tenant with the given identifier exists.   This resource can be used to change the configuration of a particular tenant.\nExample\nThe following command disables the MQTT adapter for devices that belong to the tenant tenantMqttAdapter:\ncurl -i -X PUT -H 'Content-Type: application/json' --data-binary '{ \u0026quot;adapters\u0026quot;: [ { \u0026quot;type\u0026quot;: \u0026quot;hono-mqtt\u0026quot;, \u0026quot;enabled\u0026quot;: true } ] }' http://localhost:28080/v1/tenants/tenantMqttAdapter HTTP/1.1 204 No Content ETag: 8919c736-30aa-40ce-a45a-830b90c4cd42 Content-Length: 0  Delete Tenant  URI: /v1/tenants/${tenantId} Method: DELETE Status Codes:  204 (No Content): The tenant with the given identifier has been deleted. 404 (Not Found): The request could not be processed because no tenant with the given identifier exists.   Example\ncurl -i -X DELETE http://localhost:28080/v1/tenants/tenantMqttAdapter HTTP/1.1 204 No Content Content-Length: 0  Managing Device Registration Information The following sections describe the resources representing the operations of the Device Registration API and how they can be used to manage device registration information. Please refer to the Device Registry HTTP API for the specific elements that are explained in detail there.\nRegister Device  URI: /v1/devices/${tenantId}/${deviceId} Method: POST Headers:  (required) Content-Type: application/json  Request Body:  (Optional) A JSON object as specified by Device schema of the HTTP API specification.  Status Codes:  201 (Created): Device has been registered successfully under resource indicated by Location header. 400 (Bad Request): Device has not been registered because the request was malformed, e .g. a required header is missing (the body may contain hints regarding the problem). 409 (Conflict): There already exists a device with the given ID. The request has not been processed.   Example\nThe following command registers a device with ID 4711 for tenant DEFAULT_TENANT\ncurl -i -X POST -H 'Content-Type: application/json' --data-binary '{ \u0026quot;ext\u0026quot;: { \u0026quot;ep\u0026quot;: \u0026quot;IMEI4711\u0026quot; } }' http://localhost:28080/v1/devices/DEFAULT_TENANT/4711  The response will contain a Location header containing the resource path created for the device. In this example it will look like this:\nHTTP/1.1 201 Created Location: /v1/devices/DEFAULT_TENANT/4711 ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4 Content-Type: application/json; charset=utf-8 {\u0026quot;id\u0026quot;: \u0026quot;4711\u0026quot;}  NB A device can be created without specifying a device identifier. The device registry will generate a device identifier:\ncurl -i -X POST http://localhost:28080/v1/devices/DEFAULT_TENANT HTTP/1.1 201 Created Etag: 0d615bcd-0825-44d9-9ef5-54a7b12165d8 location: /v1/devices/DEFAULT_TENANT/98d25103-d49d-44b0-bdd0-0de84743c522 content-type: application/json; charset=utf-8 content-length: 45 {\u0026quot;id\u0026quot;:\u0026quot;98d25103-d49d-44b0-bdd0-0de84743c522\u0026quot;}  Read Device  URI: /v1/devices/${tenantId}/${deviceId} Method: GET Status Codes:  200 (OK): A device with the given identifier has been found. The response body contains the registration information as specified by Device schema of the HTTP API specification. 404 (Not Found): No device with the given identifier is registered for the given tenant.   Example\nThe following command retrieves registration data for device 4711:\ncurl -i http://localhost:28080/v1/devices/DEFAULT_TENANT/4711 HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { \u0026quot;enabled\u0026quot;: true, \u0026quot;ext\u0026quot;: { \u0026quot;ep\u0026quot;: \u0026quot;IMEI4711\u0026quot; } }  Update Device  URI: /devices/v1/${tenantId}/${deviceId} Method: PUT Headers:  (required) Content-Type: application/json  Parameters (encoded as a JSON object in the request body): Request Body:  (required) A JSON object as specified by Device schema of the HTTP API specification. All existing registration information will be replaced by the data provided in the object.  Status Codes:  204 (No Content): Device registration data has been updated. 400 (Bad Request): Device registration has not been updated because the request was malformed, e .g. a required header is missing (the body may contain hints regarding the problem). 404 (Not Found): No device with the given identifier is registered for the given tenant.   Example\ncurl -i -X PUT -H 'Content-Type: application/json' --data-binary '{ \u0026quot;ext\u0026quot;: { \u0026quot;ep\u0026quot;: \u0026quot;IMEI4711\u0026quot;, \u0026quot;psk-id\u0026quot;: \u0026quot;psk4711\u0026quot; } }' http://localhost:28080/v1/devices/DEFAULT_TENANT/4711 HTTP/1.1 204 No Content Content-Length: 0  Delete Device  URI: /v1/devices/${tenantId}/${deviceId} Method: DELETE Status Codes:  204 (No Content): Device registration has been deleted. 404 (Not Found): No device with the given identifier is registered for the given tenant.   Example\ncurl -i -X DELETE http://localhost:28080/v1/devices/DEFAULT_TENANT/4711 HTTP/1.1 204 No Content Content-Length: 0  Managing Credentials The following sections describe the resources representing the operations of the Credentials API and how they can be used to manage credentials for devices. Please refer to the Device Registry HTTP API for the specific elements that are explained in detail there.\nUpdate Credentials for a Device  URI: /v1/credentials/${tenantId}/${deviceId} Method: PUT Request Headers:  (required) Content-Type: application/json (no other type supported)  Request Body:  (required) A JSON object as specified by Credentials schema of the HTTP API specification.  Status Codes:  204 (No Content): Credentials have been updated successfully. 400 (Bad Request): The credentials have not been added because the request was malformed, e .g. because the payload did not contain required values. The response body may contain hints regarding the cause of the problem.  Response Headers:  ETag: Version of the resource   Example\nThe following command adds some hashed-password credentials from a given plain text password for device 4710 using authentication identifier sensor10:\ncurl -i -X PUT -H 'Content-Type: application/json' --data-binary '[{ \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor10\u0026quot;, \u0026quot;secrets\u0026quot;: [{ \u0026quot;pwd-plain\u0026quot;: \u0026quot;mylittlesecret\u0026quot; }] }]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4710 HTTP/1.1 204 No Content ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4x  This uses a convenient option which lets the Device Registry do the hashing of the password. The following command retrieves the credentials that are stored by the Device Registry as a result of the command above:\ncurl -i http://localhost:28080/v1/credentials/DEFAULT_TENANT/4710 HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4x [{ \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor10\u0026quot;, \u0026quot;enabled\u0026quot;: true, \u0026quot;secrets\u0026quot;: [ { \u0026quot;id\u0026quot;: \u0026quot;349556ea-4902-47c7-beb0-1009ab693fb4\u0026quot; } ] }]  The above result does not contain pwd_hash and hash_function of the secret, as these values are confidential.\nThe following commands set some hashed-password credentials for device 4720 using authentication identifier sensor20:\ncurl -i -X PUT -H 'Content-Type: application/json' --data-binary '[{ \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor20\u0026quot;, \u0026quot;secrets\u0026quot;: [{ \u0026quot;pwd-plain\u0026quot;: \u0026quot;mylittlesecret\u0026quot; }] }]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720 HTTP/1.1 204 No Content ETag: 02c99fb5-af8c-409f-8520-b405e224b27f  The following command adds an expiration date to the hashed-password credentials for authentication identifier sensor20:\ncurl -i -X PUT -H 'Content-Type: application/json' --data-binary '{ \u0026quot;device-id\u0026quot;: \u0026quot;4720\u0026quot;, \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor20\u0026quot;, \u0026quot;secrets\u0026quot;: [{ \u0026quot;pwd-plain\u0026quot;: \u0026quot;mylittlesecret\u0026quot;, \u0026quot;not-after\u0026quot;: \u0026quot;2018-01-01T00:00:00+01:00\u0026quot; }] }' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720 HTTP/1.1 204 No Content ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4x  Multiple credentials of different type can be registered for the same authentication identifier. The following commands add psk credentials for the same device 4720 using authentication identifier sensor20:\nSHARED_KEY=$(echo -n \u0026quot;TheSharedKey\u0026quot; | base64 -w 0) curl -i -X PUT -H 'Content-Type: application/json' --data-binary '[ { \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor20\u0026quot;, \u0026quot;secrets\u0026quot;: [{ \u0026quot;pwd-plain\u0026quot;: \u0026quot;mylittlesecret\u0026quot; }] }, { \u0026quot;device-id\u0026quot;: \u0026quot;4720\u0026quot;, \u0026quot;type\u0026quot;: \u0026quot;psk\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor20\u0026quot;, \u0026quot;secrets\u0026quot;: [{ \u0026quot;key\u0026quot;: \u0026quot;'$SHARED_KEY'\u0026quot; }] }]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720 HTTP/1.1 204 No Content ETag: 122c971a-505a-4336-8f7d-640360e909bc  The following command deletes all credentials for device 4710:\ncurl -i -X PUT -H 'Content-Type: application/json' --data-binary '[]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4710 HTTP/1.1 204 No Content ETag: d383ba4d-1853-4d03-b322-b7ff5af05ae2  Get all Credentials for a Device  URI: /v1/credentials/${tenantId}/${deviceId} Method: GET Status Codes:  200 (OK): Credentials for the device have been found, body contains the credentials. The response body contains the registration information as specified by Credentials schema of the HTTP API specification. 404 (Not Found): No credentials for the device are registered.   Example\nThe following command retrieves credentials metadata for device 4720:\ncurl -i http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720 HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 ETag: f3449b77-2c84-4b09-8d04-2b305876e0cb {[ { \u0026quot;auth-id\u0026quot;: \u0026quot;sensor20\u0026quot;, \u0026quot;enabled\u0026quot;: true, \u0026quot;secrets\u0026quot;: [ { \u0026quot;id\u0026quot;: \u0026quot;d383ba4d-1853-4d03-b322-b7ff5af05ae2\u0026quot; \u0026quot;not-after\u0026quot;: \u0026quot;2020-02-1T00:00:00+01:00\u0026quot; }, { \u0026quot;id\u0026quot;: \u0026quot;46810d5c-133e-4c1c-994d-ed7745516b8e\u0026quot; \u0026quot;not-before\u0026quot;: \u0026quot;2020-01-01T00:00:00+01:00\u0026quot; } ], \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot; }, { \u0026quot;auth-id\u0026quot;: \u0026quot;sensor20\u0026quot;, \u0026quot;enabled\u0026quot;: true, \u0026quot;secrets\u0026quot;: [ { \u0026quot;key\u0026quot;: \u0026quot;VGhlU2hhcmVkS2V5\u0026quot; } ], \u0026quot;type\u0026quot;: \u0026quot;psk\u0026quot; } ]} "
+	"content": " The MongoDB based Device Registry component provides implementations of Hono\u0026rsquo;s Tenant API, Device Registration API and Credentials API. As such it exposes AMQP 1.0 based endpoints for retrieving the relevant information. Protocol adapters use these APIs to determine a device\u0026rsquo;s registration status, e.g. if it is enabled and if it is registered with a particular tenant, and to authenticate a device before accepting any data for processing from it.\nIn addition to the above APIs, this Device Registry also exposes HTTP endpoints for managing the contents of the Device Registry according to the Device Registry Management API. It uses a MongoDB database to persist the data. The credentials, device and tenant information are stored in separate collections in a MongoDB database. For more information on how to configure the MongoDB based device registry, see MongoDB based Device Registry configuration.\nAuthentication This Device Registry secures its HTTP Endpoints using basic authentication mechanism. Thereby the clients connecting to the MongoDB based Device Registry are required to authenticate. For more information on how to enable the authentication and configure it, please refer to the hono.registry.http.authenticationRequired property in the MongoDB based Device Registry configuration.\nManaging Tenants Please refer to the Device Registry Management API for information about managing tenants.\nManaging Devices Please refer to the Device Registry Management API for information about managing devices.\nManaging Credentials Please refer to the Device Registry Management API for information about managing credentials.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/user-guide/file-based-device-registry/",
+	"title": "File Based Device Registry",
+	"tags": [],
+	"description": "",
+	"content": "The Device Registry component provides exemplary implementations of Hono\u0026rsquo;s Tenant API, Device Registration API and Credentials API.\nAs such it exposes AMQP 1.0 based endpoints for retrieving the relevant information and persists data in the local filesystem.\nIn addition, the Device Registry also exposes HTTP resources for managing the contents of the registry according to the Device Registry HTTP API.\n Warning The Device Registry is not intended to be used in production environments. In particular, access to the HTTP resources described below is not restricted to authorized clients only.\nThe resources have been designed to provide convenient access to the registry\u0026rsquo;s content using command line tools like curl or HTTPie.\n  Managing Tenants Please refer to the Device Registry Management API for information about managing tenants.\nManaging Devices Please refer to the Device Registry Management API for information about managing devices.\nManaging Credentials Please refer to the Device Registry Management API for information about managing credentials.\n"
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/user-guide/http-adapter/",
 	"title": "HTTP Adapter",
 	"tags": [],
 	"description": "",
-	"content": "The HTTP protocol adapter exposes HTTP based endpoints for Eclipse Hono\u0026trade;\u0026rsquo;s south bound Telemetry, Event and Command \u0026amp; Control APIs.\nDevice Authentication The HTTP adapter by default requires clients (devices or gateway components) to authenticate during connection establishment. The adapter supports both the Basic HTTP authentication scheme as well as client certificate based authentication as part of a TLS handshake for that purpose.\nThe adapter tries to authenticate the device using these mechanisms in the following order\nClient Certificate When a device uses a client certificate for authentication during the TLS handshake, the adapter tries to determine the tenant that the device belongs to, based on the issuer DN contained in the certificate. In order for the lookup to succeed, the tenant\u0026rsquo;s trust anchor needs to be configured by means of registering the trusted certificate authority. The device\u0026rsquo;s client certificate will then be validated using the registered trust anchor, thus implicitly establishing the tenant that the device belongs to. In a second step, the adapter then uses the Credentials API\u0026rsquo;s get operation with the client certificate\u0026rsquo;s subject DN as the auth-id and x509-cert as the type of secret as query parameters.\nNB The HTTP adapter needs to be configured for TLS in order to support this mechanism.\nHTTP Basic Auth The username provided in the header must have the form auth-id@tenant, e.g. sensor1@DEFAULT_TENANT. The adapter verifies the credentials provided by the client against the credentials that the configured Credentials service has on record for the client. The adapter uses the Credentials API\u0026rsquo;s get operation to retrieve the credentials on record with the tenant and auth-id provided by the device in the username and hashed-password as the type of secret as query parameters.\nThe examples below refer to devices 4711 and gw-1 of tenant DEFAULT_TENANT using auth-ids sensor1 and gw1 and corresponding passwords. The example deployment as described in the Deployment Guides comes pre-configured with the corresponding entities in its device registry component. Please refer to the Credentials API for details regarding the different types of secrets.\nNB There is a subtle difference between the device identifier (device-id) and the auth-id a device uses for authentication. See Device Identity for a discussion of the concepts.\nMessage Limits Before accepting any telemetry or event or command messages, the HTTP adapter verifies that the configured message limit is not exceeded. If the limit is exceeded then the incoming message is discarded with the status code 429 Too Many Requests.\nPublish Telemetry Data (authenticated Device)  URI: /telemetry Method: POST Request Headers:  (optional) authorization: The device\u0026rsquo;s auth-id and plain text password encoded according to the Basic HTTP authentication scheme. If not set, the adapter expects the device to present a client certificate as part of the TLS handshake during connection establishment. (required) content-type: The type of payload contained in the request body. (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) qos-level: The QoS level for publishing telemetry messages. The adapter supports at most once (0) and at least once (1) QoS levels. The default value of 0 is assumed if this header is omitted.  Request Body:  (required) Arbitrary payload encoded according to the given content type.  Response Headers:  (optional) content-type: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data. (optional) hono-command: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-req-id: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-target-device: The id of the device that shall execute the command. This header will only be present if the response contains a command to be executed by the device and if the response goes to a gateway that acts on behalf of the target device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200. (optional) Error details, if status code is \u0026gt;= 400.  Status Codes:  200 (OK): The telemetry data has been accepted for processing. The response contains a command for the device to execute. 202 (Accepted): The telemetry data has been accepted for processing. Note that if the qos-level request header is omitted (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer. However, if the QoS level header is set to 1 (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 400 (Bad Request): The request cannot be processed. Possible reasons for this include:  The content type header is missing. The request body is empty. The QoS header value is invalid.  401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials. 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This is the preferred way for devices to publish telemetry data. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).\nExamples\nPublish some JSON data for device 4711:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry HTTP/1.1 202 Accepted content-length: 0  Publish some JSON data for device 4711 using at least once QoS:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' -H 'qos-level: 1' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://localhost:8080/telemetry HTTP/1.1 202 Accepted content-length: 0  Publish some JSON data for device 4711, indicating that the device will wait for 10 seconds to receive the response:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' -H 'hono-ttd: 10' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://localhost:8080/telemetry HTTP/1.1 200 OK hono-command: set hono-cmd-req-id: 1010a7249aa5-f742-4376-8458-bbfc88c72d92 content-length: 23 { \u0026quot;brightness\u0026quot;: 87 }  Publish some JSON data for device 4711 using a client certificate for authentication:\n# in base directory of Hono repository: curl -i --cert demo-certs/certs/device-4711-cert.pem --key demo-certs/certs/device-4711-key.pem --cacert demo-certs/certs/trusted-certs.pem -H 'content-type: application/json' --data-binary '{\u0026quot;temp\u0026quot;: 5}' https://localhost:8443/telemetry HTTP/1.1 202 Accepted content-length: 0  NB The example above assumes that the HTTP adapter is configured for TLS and the secure port is used.\nPublish Telemetry Data (unauthenticated Device)  URI: /telemetry/${tenantId}/${deviceId} Method: PUT Request Headers:  (required) content-type: The type of payload contained in the request body. (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) qos-level: The QoS level for publishing telemetry messages. The adapter supports at most once (0) and at least once (1) QoS levels. The default value of 0 is assumed if this header is omitted.  Request Body:  (required) Arbitrary payload encoded according to the given content type.  Response Headers:  (optional) content-type: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data. (optional) hono-command: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-req-id: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200. (optional) Error details, if status code is \u0026gt;= 400.  Status Codes:  200 (OK): The telemetry data has been accepted for processing. The response contains a command for the device to execute. 202 (Accepted): The telemetry data has been accepted for processing. Note that if the qos-level request header is omitted (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer. However, if the QoS level header is set to 1 (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 400 (Bad Request): The request cannot be processed. Possible reasons for this include:  The content type header is missing. The request body is empty. The QoS header value is invalid.  403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_HTTP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711:\ncurl -i -X PUT -H 'content-type: application/json' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry/DEFAULT_TENANT/4711 HTTP/1.1 202 Accepted content-length: 0  Publish some JSON data for device 4711 using at least once QoS:\ncurl -i -X PUT -H 'content-type: application/json' -H 'qos-level: 1' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry/DEFAULT_TENANT/4711 HTTP/1.1 202 Accepted content-length: 0  Publish some JSON data for device 4711, indicating that the device will wait for 10 seconds to receive the response:\ncurl -i -X PUT -H 'content-type: application/json' -H 'hono-ttd: 10' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://localhost:8080/telemetry/DEFAULT_TENANT/4711 HTTP/1.1 200 OK hono-command: set hono-cmd-req-id: 1010a7249aa5-f742-4376-8458-bbfc88c72d92 content-length: 23 { \u0026quot;brightness\u0026quot;: 87 }  Publish Telemetry Data (authenticated Gateway)  URI: /telemetry/${tenantId}/${deviceId} Method: PUT Request Headers:  (optional) authorization: The gateway\u0026rsquo;s auth-id and plain text password encoded according to the Basic HTTP authentication scheme. If not set, the adapter expects the gateway to present a client certificate as part of the TLS handshake during connection establishment. (required) content-type: The type of payload contained in the request body. (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) qos-level: The QoS level for publishing telemetry messages. The adapter supports at most once (0) and at least once (1) QoS levels. The default value of 0 is assumed if this header is omitted.  Request Body:  (required) Arbitrary payload encoded according to the given content type.  Response Headers:  (optional) content-type: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data. (optional) hono-command: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-req-id: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-target-device: The id of the device that shall execute the command. This header will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200. (optional) Error details, if status code is \u0026gt;= 400.  Status Codes:  200 (OK): The telemetry data has been accepted for processing. The response contains a command for the device to execute. 202 (Accepted): The telemetry data has been accepted for processing. Note that if the qos-level request header is omitted (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer. However, if the QoS level header is set to 1 (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 400 (Bad Request): The request cannot be processed. Possible reasons for this include:  The content type header is missing. The request body is empty. The QoS header value is invalid.  401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials. 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The tenant that the gateway belongs to is not allowed to use this protocol adapter. The device belongs to another tenant than the gateway. The gateway is not authorized to act on behalf of the device. The gateway associated with the device is not registered or disabled.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This resource can be used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nPublish some JSON data for device 4712:\ncurl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry/DEFAULT_TENANT/4712 HTTP/1.1 202 Accepted content-length: 0  Publish some JSON data for device 4712 using at least once QoS:\ncurl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' -H 'qos-level: 1' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry/DEFAULT_TENANT/4712 HTTP/1.1 202 Accepted content-length: 0  Publish some JSON data for device 4712, indicating that the gateway will wait for 10 seconds to receive the response:\ncurl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' -H 'hono-ttd: 10' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://localhost:8080/telemetry/DEFAULT_TENANT/4712 HTTP/1.1 200 OK hono-command: set hono-cmd-req-id: 1010a7249aa5-f742-4376-8458-bbfc88c72d92 content-length: 23 { \u0026quot;brightness\u0026quot;: 87 }  NB The example above assumes that a gateway device has been registered with hashed-password credentials with auth-id gw and password gw-secret which is authorized to publish data on behalf of device 4712.\nPublish an Event (authenticated Device)  URI: /event Method: POST Request Headers:  (optional) authorization: The device\u0026rsquo;s auth-id and plain text password encoded according to the Basic HTTP authentication scheme. If not set, the adapter expects the device to present a client certificate as part of the TLS handshake during connection establishment. (required) content-type: The type of payload contained in the request body. (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) hono-ttl: The time-to-live in number of seconds for event messages.\n  Request Body:  (required) Arbitrary payload encoded according to the given content type.  Response Headers:  (optional) content-type: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data. (optional) hono-command: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-req-id: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-target-device: The id of the device that shall execute the command. This header will only be present if the response contains a command to be executed by the device and if the response goes to a gateway that acts on behalf of the target device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200. (optional) Error details, if status code is \u0026gt;= 400.  Status Codes:  200 (OK): The event has been accepted for processing. The response contains a command for the device to execute. 202 (Accepted): The event has been accepted for processing. 400 (Bad Request): The request cannot be processed. Possible reasons for this include:  The content type header is missing. The request body is empty but the event is not of type empty-notification.  401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials. 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed because there is no consumer of events for the given tenant connected to Hono.   This is the preferred way for devices to publish events. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).\nExample\nPublish some JSON data for device 4711:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' --data-binary '{\u0026quot;alarm\u0026quot;: true}' http://127.0.0.1:8080/event HTTP/1.1 202 Accepted content-length: 0  Publish an Event (unauthenticated Device)  URI: /event/${tenantId}/${deviceId} Method: PUT Request Headers:  (required) content-type: The type of payload contained in the request body. (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) hono-ttl: The time-to-live in number of seconds for event messages.  Request Body:  (required) Arbitrary payload encoded according to the given content type.  Response Headers:  (optional) content-type: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data. (optional) hono-command: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-req-id: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200. (optional) Error details, if status code is \u0026gt;= 400.  Status Codes:  200 (OK): The event has been accepted and put to a persistent store for delivery to consumers. The response contains a command for the device to execute. 202 (Accepted): The event has been accepted and put to a persistent store for delivery to consumers. 400 (Bad Request): The request cannot be processed. Possible reasons for this include:  The content type header is missing. The request body is empty but the event is not of type empty-notification.  403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed because there is no consumer of events for the given tenant connected to Hono.   This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_HTTP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711:\ncurl -i -X PUT -H 'content-type: application/json' --data-binary '{\u0026quot;alarm\u0026quot;: true}' http://127.0.0.1:8080/event/DEFAULT_TENANT/4711 HTTP/1.1 202 Accepted content-length: 0  Publish an Event (authenticated Gateway)  URI: /event/${tenantId}/${deviceId} Method: PUT Request Headers:  (optional) authorization: The gateway\u0026rsquo;s auth-id and plain text password encoded according to the Basic HTTP authentication scheme. If not set, the adapter expects the gateway to present a client certificate as part of the TLS handshake during connection establishment. (required) content-type: The type of payload contained in the request body. (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) hono-ttl: The time-to-live in number of seconds for event messages.  Request Body:  (required) Arbitrary payload encoded according to the given content type.  Response Headers:  (optional) content-type: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data. (optional) hono-command: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-req-id: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-target-device: The id of the device that shall execute the command. This header will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200. (optional) Error details, if status code is \u0026gt;= 400.  Status Codes:  200 (OK): The event has been accepted and put to a persistent store for delivery to consumers. The response contains a command for the device to execute. 202 (Accepted): The event has been accepted and put to a persistent store for delivery to consumers. 400 (Bad Request): The request cannot be processed. Possible reasons for this include:  The content type header is missing. The request body is empty but the event is not of type empty-notification.  401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials. 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The tenant that the gateway belongs to is not allowed to use this protocol adapter. The device belongs to another tenant than the gateway. The gateway is not authorized to act on behalf of the device. The gateway associated with the device is not registered or disabled.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed because there is no consumer of events for the given tenant connected to Hono.   This resource can be used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nPublish some JSON data for device 4712:\ncurl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/event/DEFAULT_TENANT/4712 HTTP/1.1 202 Accepted content-length: 0  NB The example above assumes that a gateway device has been registered with hashed-password credentials with auth-id gw and password gw-secret which is authorized to publish data on behalf of device 4712.\nCommand \u0026amp; Control The HTTP adapter enables devices to receive commands that have been sent by business applications. Commands are delivered to the device by means of an HTTP response message. That means a device first has to send a request, indicating how long it will wait for the response. That request can either be a telemetry or event message, with a hono-ttd header or query parameter (ttd for time till disconnect) specifying the number of seconds the device will wait for the response. The business application can react on that message by sending a command message, targeted at the device. The HTTP adapter will then send the command message as part of the HTTP response message with status 200 (OK) to the device. If the HTTP adapter receives no command message in the given time period, a 202 (Accepted) response will be sent to the device (provided the request was valid).\nSpecifying the Time a Device will wait for a Response The adapter lets devices indicate the number of seconds they will wait for a response by setting a header or a query parameter.\nUsing an HTTP Header The (optional) hono-ttd header can be set in requests for publishing telemetry data or events.\nExample:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' -H 'hono-ttd: 60' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry HTTP/1.1 202 Accepted content-length: 0  Using a Query Parameter Alternatively the hono-ttd query parameter can be used:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry?hono-ttd=60 HTTP/1.1 202 Accepted content-length: 0  Commands handled by gateways Authenticated gateways will receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway. Corresponding devices have to be configured so that they can be used with a gateway. See Configuring Gateway Devices for details.\nA gateway can send a request with the hono-ttd header or query parameter on the /event or /telemetry URI, indicating its readiness to receive a command for any device it acts on behalf of. Note that in this case, the business application will be notified with the gateway id in the device_id property of the downstream message.\nAn authenticated gateway can also indicate its readiness to receive a command targeted at a specific device. For that, the /event/${tenantId}/${deviceId} or /telemetry/${tenantId}/${deviceId} URI is to be used, containing the id of the device to receive a command for. The business application will receive a notification with that device id.\nIf there are multiple concurrent requests with a hono-ttd header or query parameter, sent by the command target device and/or one or more of its potential gateways, the HTTP adapter will choose the device or gateway to send the command to as follows:\n A request done by the command target device or by a gateway specifically done for that device, has precedence. If there are multiple, concurrent such requests, the last one will get the command message (if received) in its response. Note that the other requests won\u0026rsquo;t be answered with a command message in their response event if the business application sent multiple command messages. That means commands for a single device can only be requested sequentially, not in parallel. If the above doesn\u0026rsquo;t apply, a single hono-ttd request on the /event or /telemetry URI, sent by a gateway that the command target device is configured for, will get the command message in its response. If there are multiple, concurrent such requests by different gateways, all configured for the command target device, the request by the gateway will be chosen, through which the target device has last sent a telemetry or event message. If the target device hasn\u0026rsquo;t sent a message yet and it is thereby unknown via which gateway the device communicates, then one of the requests will be chosen randomly to set the command in its response.  Sending a Response to a Command (authenticated Device)  URI: /command/res/${commandRequestId} or /command/res/${commandRequestId}?hono-cmd-status=${status} Method: POST Request Headers:  (optional) authorization: The device\u0026rsquo;s auth-id and plain text password encoded according to the Basic HTTP authentication scheme. If not set, the adapter expects the device to present a client certificate as part of the TLS handshake during connection establishment. (optional) content-type: A media type describing the semantics and format of the payload contained in the request body. This header may be set if the result of processing the command on the device is non-empty. In this case the result data is contained in the request body. (optional) hono-cmd-status: The status of the command execution. If not set, the adapter expects that the URI contains it as request parameter at the end.  Request Body:  (optional) Arbitrary data representing the result of processing the command on the device.  Status Codes:  202 (Accepted): The response has been successfully delivered to the application that has sent the command. 400 (Bad Request): The request cannot be processed because the command status is missing. 401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials.\n 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed. Possible reasons for this include:  There is no application listening for a reply to the given commandRequestId. The application has already given up on waiting for a response.    This is the preferred way for devices to respond to commands. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).\nExample\nSend a response to a previously received command with the command-request-id req-id-uuid for device 4711:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' --data-binary '{\u0026quot;brightness-changed\u0026quot;: true}' http://127.0.0.1:8080/command/res/req-id-uuid?hono-cmd-status=200 HTTP/1.1 202 Accepted content-length: 0  Sending a Response to a Command (unauthenticated Device)  URI: /command/res/${tenantId}/${deviceId}/${commandRequestId} or /command/res/${tenantId}/${deviceId}/${commandRequestId}?hono-cmd-status=${status} Method: PUT Request Headers:  (optional) content-type: A media type describing the semantics and format of the payload contained in the request body (the outcome of processing the command). (optional) hono-cmd-status: The status of the command execution. If not set, the adapter expects that the URI contains it as request parameter at the end.  Request Body:  (optional) Arbitrary data representing the result of processing the command on the device.  Status Codes:  202 (Accepted): The response has been successfully delivered to the application that has sent the command. 400 (Bad Request): The request cannot be processed because the command status is missing. 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this might be:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed. Possible reasons for this include:  There is no application listening for a reply to the given commandRequestId. The application has already given up on waiting for a response.    This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_HTTP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nSend a response to a previously received command with the command-request-id req-id-uuid for the unauthenticated device 4711:\ncurl -i -X PUT -H 'content-type: application/json' --data-binary '{\u0026quot;brightness-changed\u0026quot;: true}' http://127.0.0.1:8080/command/res/DEFAULT_TENANT/4711/req-id-uuid?hono-cmd-status=200 HTTP/1.1 202 Accepted content-length: 0  Sending a Response to a Command (authenticated Gateway)  URI: /command/res/${tenantId}/${deviceId}/${commandRequestId} or /command/res/${tenantId}/${deviceId}/${commandRequestId}?hono-cmd-status=${status} Method: PUT Request Headers:  (optional) authorization: The gateway\u0026rsquo;s auth-id and plain text password encoded according to the Basic HTTP authentication scheme. If not set, the adapter expects the gateway to present a client certificate as part of the TLS handshake during connection establishment. (optional) content-type: A media type describing the semantics and format of the payload contained in the request body (the outcome of processing the command). (optional) hono-cmd-status: The status of the command execution. If not set, the adapter expects that the URI contains it as request parameter at the end.  Request Body:  (optional) Arbitrary data representing the result of processing the command on the device.  Status Codes:  202 (Accepted): The response has been successfully delivered to the application that has sent the command. 400 (Bad Request): The request cannot be processed because the command status is missing. 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this might be:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant. The gateway is not authorized to act on behalf of the device. The gateway associated with the device is not registered or disabled.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed. Possible reasons for this include:  There is no application listening for a reply to the given commandRequestId. The application has already given up on waiting for a response.    This resource can be used by gateway components to send the response to a command on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to send responses to a command on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nSend a response to a previously received command with the command-request-id req-id-uuid for device 4712:\ncurl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' --data-binary '{\u0026quot;brightness-changed\u0026quot;: true}' http://127.0.0.1:8080/command/res/DEFAULT_TENANT/4712/req-id-uuid?hono-cmd-status=200 HTTP/1.1 202 Accepted content-length: 0  NB The example above assumes that a gateway device has been registered with hashed-password credentials with auth-id gw and password gw-secret which is authorized to publish data on behalf of device 4712.\nDownstream Meta Data The adapter includes the following meta data in the application properties of messages being sent downstream:\n   Name Type Description     device_id string The identifier of the device that the message originates from.   orig_adapter string Contains the adapter\u0026rsquo;s type name which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The HTTP adapter\u0026rsquo;s type name is hono-http.   orig_address string Contains the (relative) URI that the device has originally posted the data to.   ttd integer Contains the effective number of seconds that the device will wait for a response. This property is only set if the HTTP request contains the hono-ttd header or request parameter.    The adapter also considers defaults registered for the device at either the tenant or the device level. The values of the default properties are determined as follows:\n If the message already contains a non-empty property of the same name, the value if unchanged. Otherwise, if a default property of the same name is defined in the device\u0026rsquo;s registration information, that value is used. Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.  Note that of the standard AMQP 1.0 message properties only the content-type and ttl can be set this way to a default value.\nEvent Message Time-to-live Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers. In most cases the AMQP Messaging Network can be configured with a maximum time-to-live to apply to the events so that the events will be removed from the persistent store if no consumer has attached to receive the event before the message expires.\nIn order to support environments where the AMQP Messaging Network cannot be configured accordingly, the protocol adapter supports setting a downstream event message\u0026rsquo;s ttl property based on the hono-ttl property set as a header or a query parameter in the event requests by the devices. Also the default ttl and max-ttl values can be configured for a tenant/device as described in the Tenant API.\nTenant specific Configuration The adapter uses the Tenant API to retrieve tenant specific configuration for adapter type hono-http. The following properties are (currently) supported:\n   Name Type Default Value Description     enabled boolean true If set to false the adapter will reject all data from devices belonging to the tenant.   max-ttd integer 60 Defines a tenant specific upper limit for the time until disconnect property that devices may include in requests for uploading telemetry data or events. Please refer to the Command \u0026amp; Control concept page for a discussion of this parameter\u0026rsquo;s purpose and usage.\nThis property can be set for the hono-http adapter type as an extension property in the adapter section of the tenant configuration.\nIf it is not set, then the default value of 60 seconds is used.   "
+	"content": "The HTTP protocol adapter exposes HTTP based endpoints for Eclipse Hono\u0026trade;\u0026rsquo;s south bound Telemetry, Event and Command \u0026amp; Control APIs.\nDevice Authentication The HTTP adapter by default requires clients (devices or gateway components) to authenticate during connection establishment. The adapter supports both the Basic HTTP authentication scheme as well as client certificate based authentication as part of a TLS handshake for that purpose.\nThe adapter tries to authenticate the device using these mechanisms in the following order\nClient Certificate When a device uses a client certificate for authentication during the TLS handshake, the adapter tries to determine the tenant that the device belongs to, based on the issuer DN contained in the certificate. In order for the lookup to succeed, the tenant\u0026rsquo;s trust anchor needs to be configured by means of registering the trusted certificate authority. The device\u0026rsquo;s client certificate will then be validated using the registered trust anchor, thus implicitly establishing the tenant that the device belongs to. In a second step, the adapter then uses the Credentials API\u0026rsquo;s get operation with the client certificate\u0026rsquo;s subject DN as the auth-id and x509-cert as the type of secret as query parameters.\nNB The HTTP adapter needs to be configured for TLS in order to support this mechanism.\nHTTP Basic Auth The username provided in the header must have the form auth-id@tenant, e.g. sensor1@DEFAULT_TENANT. The adapter verifies the credentials provided by the client against the credentials that the configured Credentials service has on record for the client. The adapter uses the Credentials API\u0026rsquo;s get operation to retrieve the credentials on record with the tenant and auth-id provided by the device in the username and hashed-password as the type of secret as query parameters.\nThe examples below refer to devices 4711 and gw-1 of tenant DEFAULT_TENANT using auth-ids sensor1 and gw1 and corresponding passwords. The example deployment as described in the Deployment Guides comes pre-configured with the corresponding entities in its device registry component. Please refer to the Credentials API for details regarding the different types of secrets.\nNB There is a subtle difference between the device identifier (device-id) and the auth-id a device uses for authentication. See Device Identity for a discussion of the concepts.\nMessage Limits The adapter rejects\n a client\u0026rsquo;s request to upload data with status code 429 Too Many Requests and any AMQP 1.0 message containing a command sent by a north bound application  if the message limit that has been configured for the device\u0026rsquo;s tenant is exceeded.\nPublish Telemetry Data (authenticated Device)  URI: /telemetry Method: POST Request Headers:  (optional) authorization: The device\u0026rsquo;s auth-id and plain text password encoded according to the Basic HTTP authentication scheme. If not set, the adapter expects the device to present a client certificate as part of the TLS handshake during connection establishment. (required) content-type: The type of payload contained in the request body. (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) qos-level: The QoS level for publishing telemetry messages. The adapter supports at most once (0) and at least once (1) QoS levels. The default value of 0 is assumed if this header is omitted.  Request Body:  (required) Arbitrary payload encoded according to the given content type.  Response Headers:  (optional) content-type: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data. (optional) hono-command: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-req-id: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-target-device: The id of the device that shall execute the command. This header will only be present if the response contains a command to be executed by the device and if the response goes to a gateway that acts on behalf of the target device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200. (optional) Error details, if status code is \u0026gt;= 400.  Status Codes:  200 (OK): The telemetry data has been accepted for processing. The response contains a command for the device to execute. 202 (Accepted): The telemetry data has been accepted for processing. Note that if the qos-level request header is omitted (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer. However, if the QoS level header is set to 1 (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 400 (Bad Request): The request cannot be processed. Possible reasons for this include:  The content type header is missing. The request body is empty. The QoS header value is invalid.  401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials. 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This is the preferred way for devices to publish telemetry data. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).\nExamples\nPublish some JSON data for device 4711:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry HTTP/1.1 202 Accepted content-length: 0  Publish some JSON data for device 4711 using at least once QoS:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' -H 'qos-level: 1' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://localhost:8080/telemetry HTTP/1.1 202 Accepted content-length: 0  Publish some JSON data for device 4711, indicating that the device will wait for 10 seconds to receive the response:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' -H 'hono-ttd: 10' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://localhost:8080/telemetry HTTP/1.1 200 OK hono-command: set hono-cmd-req-id: 1010a7249aa5-f742-4376-8458-bbfc88c72d92 content-length: 23 { \u0026quot;brightness\u0026quot;: 87 }  Publish some JSON data for device 4711 using a client certificate for authentication:\n# in base directory of Hono repository: curl -i --cert demo-certs/certs/device-4711-cert.pem --key demo-certs/certs/device-4711-key.pem --cacert demo-certs/certs/trusted-certs.pem -H 'content-type: application/json' --data-binary '{\u0026quot;temp\u0026quot;: 5}' https://localhost:8443/telemetry HTTP/1.1 202 Accepted content-length: 0  NB The example above assumes that the HTTP adapter is configured for TLS and the secure port is used.\nPublish Telemetry Data (unauthenticated Device)  URI: /telemetry/${tenantId}/${deviceId} Method: PUT Request Headers:  (required) content-type: The type of payload contained in the request body. (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) qos-level: The QoS level for publishing telemetry messages. The adapter supports at most once (0) and at least once (1) QoS levels. The default value of 0 is assumed if this header is omitted.  Request Body:  (required) Arbitrary payload encoded according to the given content type.  Response Headers:  (optional) content-type: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data. (optional) hono-command: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-req-id: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200. (optional) Error details, if status code is \u0026gt;= 400.  Status Codes:  200 (OK): The telemetry data has been accepted for processing. The response contains a command for the device to execute. 202 (Accepted): The telemetry data has been accepted for processing. Note that if the qos-level request header is omitted (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer. However, if the QoS level header is set to 1 (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 400 (Bad Request): The request cannot be processed. Possible reasons for this include:  The content type header is missing. The request body is empty. The QoS header value is invalid.  403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_HTTP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711:\ncurl -i -X PUT -H 'content-type: application/json' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry/DEFAULT_TENANT/4711 HTTP/1.1 202 Accepted content-length: 0  Publish some JSON data for device 4711 using at least once QoS:\ncurl -i -X PUT -H 'content-type: application/json' -H 'qos-level: 1' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry/DEFAULT_TENANT/4711 HTTP/1.1 202 Accepted content-length: 0  Publish some JSON data for device 4711, indicating that the device will wait for 10 seconds to receive the response:\ncurl -i -X PUT -H 'content-type: application/json' -H 'hono-ttd: 10' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://localhost:8080/telemetry/DEFAULT_TENANT/4711 HTTP/1.1 200 OK hono-command: set hono-cmd-req-id: 1010a7249aa5-f742-4376-8458-bbfc88c72d92 content-length: 23 { \u0026quot;brightness\u0026quot;: 87 }  Publish Telemetry Data (authenticated Gateway)  URI: /telemetry/${tenantId}/${deviceId} Method: PUT Request Headers:  (optional) authorization: The gateway\u0026rsquo;s auth-id and plain text password encoded according to the Basic HTTP authentication scheme. If not set, the adapter expects the gateway to present a client certificate as part of the TLS handshake during connection establishment. (required) content-type: The type of payload contained in the request body. (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) qos-level: The QoS level for publishing telemetry messages. The adapter supports at most once (0) and at least once (1) QoS levels. The default value of 0 is assumed if this header is omitted.  Request Body:  (required) Arbitrary payload encoded according to the given content type.  Response Headers:  (optional) content-type: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data. (optional) hono-command: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-req-id: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-target-device: The id of the device that shall execute the command. This header will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200. (optional) Error details, if status code is \u0026gt;= 400.  Status Codes:  200 (OK): The telemetry data has been accepted for processing. The response contains a command for the device to execute. 202 (Accepted): The telemetry data has been accepted for processing. Note that if the qos-level request header is omitted (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer. However, if the QoS level header is set to 1 (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 400 (Bad Request): The request cannot be processed. Possible reasons for this include:  The content type header is missing. The request body is empty. The QoS header value is invalid.  401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials. 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The tenant that the gateway belongs to is not allowed to use this protocol adapter. The device belongs to another tenant than the gateway. The gateway is not authorized to act on behalf of the device. The gateway associated with the device is not registered or disabled.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This resource can be used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nPublish some JSON data for device 4712:\ncurl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry/DEFAULT_TENANT/4712 HTTP/1.1 202 Accepted content-length: 0  Publish some JSON data for device 4712 using at least once QoS:\ncurl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' -H 'qos-level: 1' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry/DEFAULT_TENANT/4712 HTTP/1.1 202 Accepted content-length: 0  Publish some JSON data for device 4712, indicating that the gateway will wait for 10 seconds to receive the response:\ncurl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' -H 'hono-ttd: 10' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://localhost:8080/telemetry/DEFAULT_TENANT/4712 HTTP/1.1 200 OK hono-command: set hono-cmd-req-id: 1010a7249aa5-f742-4376-8458-bbfc88c72d92 content-length: 23 { \u0026quot;brightness\u0026quot;: 87 }  NB The example above assumes that a gateway device has been registered with hashed-password credentials with auth-id gw and password gw-secret which is authorized to publish data on behalf of device 4712.\nPublish an Event (authenticated Device)  URI: /event Method: POST Request Headers:  (optional) authorization: The device\u0026rsquo;s auth-id and plain text password encoded according to the Basic HTTP authentication scheme. If not set, the adapter expects the device to present a client certificate as part of the TLS handshake during connection establishment. (required) content-type: The type of payload contained in the request body. (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) hono-ttl: The time-to-live in number of seconds for event messages.\n  Request Body:  (required) Arbitrary payload encoded according to the given content type.  Response Headers:  (optional) content-type: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data. (optional) hono-command: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-req-id: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-target-device: The id of the device that shall execute the command. This header will only be present if the response contains a command to be executed by the device and if the response goes to a gateway that acts on behalf of the target device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200. (optional) Error details, if status code is \u0026gt;= 400.  Status Codes:  200 (OK): The event has been accepted for processing. The response contains a command for the device to execute. 202 (Accepted): The event has been accepted for processing. 400 (Bad Request): The request cannot be processed. Possible reasons for this include:  The content type header is missing. The request body is empty but the event is not of type empty-notification.  401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials. 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed because there is no consumer of events for the given tenant connected to Hono.   This is the preferred way for devices to publish events. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).\nExample\nPublish some JSON data for device 4711:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' --data-binary '{\u0026quot;alarm\u0026quot;: true}' http://127.0.0.1:8080/event HTTP/1.1 202 Accepted content-length: 0  Publish an Event (unauthenticated Device)  URI: /event/${tenantId}/${deviceId} Method: PUT Request Headers:  (required) content-type: The type of payload contained in the request body. (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) hono-ttl: The time-to-live in number of seconds for event messages.  Request Body:  (required) Arbitrary payload encoded according to the given content type.  Response Headers:  (optional) content-type: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data. (optional) hono-command: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-req-id: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200. (optional) Error details, if status code is \u0026gt;= 400.  Status Codes:  200 (OK): The event has been accepted and put to a persistent store for delivery to consumers. The response contains a command for the device to execute. 202 (Accepted): The event has been accepted and put to a persistent store for delivery to consumers. 400 (Bad Request): The request cannot be processed. Possible reasons for this include:  The content type header is missing. The request body is empty but the event is not of type empty-notification.  403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed because there is no consumer of events for the given tenant connected to Hono.   This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_HTTP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711:\ncurl -i -X PUT -H 'content-type: application/json' --data-binary '{\u0026quot;alarm\u0026quot;: true}' http://127.0.0.1:8080/event/DEFAULT_TENANT/4711 HTTP/1.1 202 Accepted content-length: 0  Publish an Event (authenticated Gateway)  URI: /event/${tenantId}/${deviceId} Method: PUT Request Headers:  (optional) authorization: The gateway\u0026rsquo;s auth-id and plain text password encoded according to the Basic HTTP authentication scheme. If not set, the adapter expects the gateway to present a client certificate as part of the TLS handshake during connection establishment. (required) content-type: The type of payload contained in the request body. (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) hono-ttl: The time-to-live in number of seconds for event messages.  Request Body:  (required) Arbitrary payload encoded according to the given content type.  Response Headers:  (optional) content-type: A media type describing the semantics and format of payload contained in the response body. This header will only be present if the response contains a command to be executed by the device which requires input data. (optional) hono-command: The name of the command to execute. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-req-id: An identifier that the device must include in its response to a command. This header will only be present if the response contains a command to be executed by the device. (optional) hono-cmd-target-device: The id of the device that shall execute the command. This header will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 200. (optional) Error details, if status code is \u0026gt;= 400.  Status Codes:  200 (OK): The event has been accepted and put to a persistent store for delivery to consumers. The response contains a command for the device to execute. 202 (Accepted): The event has been accepted and put to a persistent store for delivery to consumers. 400 (Bad Request): The request cannot be processed. Possible reasons for this include:  The content type header is missing. The request body is empty but the event is not of type empty-notification.  401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials. 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The tenant that the gateway belongs to is not allowed to use this protocol adapter. The device belongs to another tenant than the gateway. The gateway is not authorized to act on behalf of the device. The gateway associated with the device is not registered or disabled.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed because there is no consumer of events for the given tenant connected to Hono.   This resource can be used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nPublish some JSON data for device 4712:\ncurl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/event/DEFAULT_TENANT/4712 HTTP/1.1 202 Accepted content-length: 0  NB The example above assumes that a gateway device has been registered with hashed-password credentials with auth-id gw and password gw-secret which is authorized to publish data on behalf of device 4712.\nCommand \u0026amp; Control The HTTP adapter enables devices to receive commands that have been sent by business applications. Commands are delivered to the device by means of an HTTP response message. That means a device first has to send a request, indicating how long it will wait for the response. That request can either be a telemetry or event message, with a hono-ttd header or query parameter (ttd for time till disconnect) specifying the number of seconds the device will wait for the response. The business application can react on that message by sending a command message, targeted at the device. The HTTP adapter will then send the command message as part of the HTTP response message with status 200 (OK) to the device. If the HTTP adapter receives no command message in the given time period, a 202 (Accepted) response will be sent to the device (provided the request was valid).\nSpecifying the Time a Device will wait for a Response The adapter lets devices indicate the number of seconds they will wait for a response by setting a header or a query parameter.\nUsing an HTTP Header The (optional) hono-ttd header can be set in requests for publishing telemetry data or events.\nExample:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' -H 'hono-ttd: 60' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry HTTP/1.1 202 Accepted content-length: 0  Using a Query Parameter Alternatively the hono-ttd query parameter can be used:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' --data-binary '{\u0026quot;temp\u0026quot;: 5}' http://127.0.0.1:8080/telemetry?hono-ttd=60 HTTP/1.1 202 Accepted content-length: 0  Commands handled by gateways Authenticated gateways will receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway. Corresponding devices have to be configured so that they can be used with a gateway. See Configuring Gateway Devices for details.\nA gateway can send a request with the hono-ttd header or query parameter on the /event or /telemetry URI, indicating its readiness to receive a command for any device it acts on behalf of. Note that in this case, the business application will be notified with the gateway id in the device_id property of the downstream message.\nAn authenticated gateway can also indicate its readiness to receive a command targeted at a specific device. For that, the /event/${tenantId}/${deviceId} or /telemetry/${tenantId}/${deviceId} URI is to be used, containing the id of the device to receive a command for. The business application will receive a notification with that device id.\nIf there are multiple concurrent requests with a hono-ttd header or query parameter, sent by the command target device and/or one or more of its potential gateways, the HTTP adapter will choose the device or gateway to send the command to as follows:\n A request done by the command target device or by a gateway specifically done for that device, has precedence. If there are multiple, concurrent such requests, the last one will get the command message (if received) in its response. Note that the other requests won\u0026rsquo;t be answered with a command message in their response event if the business application sent multiple command messages. That means commands for a single device can only be requested sequentially, not in parallel. If the above doesn\u0026rsquo;t apply, a single hono-ttd request on the /event or /telemetry URI, sent by a gateway that the command target device is configured for, will get the command message in its response. If there are multiple, concurrent such requests by different gateways, all configured for the command target device, the request by the gateway will be chosen, through which the target device has last sent a telemetry or event message. If the target device hasn\u0026rsquo;t sent a message yet and it is thereby unknown via which gateway the device communicates, then one of the requests will be chosen randomly to set the command in its response.  Sending a Response to a Command (authenticated Device)  URI: /command/res/${commandRequestId} or /command/res/${commandRequestId}?hono-cmd-status=${status} Method: POST Request Headers:  (optional) authorization: The device\u0026rsquo;s auth-id and plain text password encoded according to the Basic HTTP authentication scheme. If not set, the adapter expects the device to present a client certificate as part of the TLS handshake during connection establishment. (optional) content-type: A media type describing the semantics and format of the payload contained in the request body. This header may be set if the result of processing the command on the device is non-empty. In this case the result data is contained in the request body. (optional) hono-cmd-status: The status of the command execution. If not set, the adapter expects that the URI contains it as request parameter at the end.  Request Body:  (optional) Arbitrary data representing the result of processing the command on the device.  Status Codes:  202 (Accepted): The response has been successfully delivered to the application that has sent the command. 400 (Bad Request): The request cannot be processed because the command status is missing. 401 (Unauthorized): The request cannot be processed because the request does not contain valid credentials.\n 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed. Possible reasons for this include:  There is no application listening for a reply to the given commandRequestId. The application has already given up on waiting for a response.    This is the preferred way for devices to respond to commands. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).\nExample\nSend a response to a previously received command with the command-request-id req-id-uuid for device 4711:\ncurl -i -u sensor1@DEFAULT_TENANT:hono-secret -H 'content-type: application/json' --data-binary '{\u0026quot;brightness-changed\u0026quot;: true}' http://127.0.0.1:8080/command/res/req-id-uuid?hono-cmd-status=200 HTTP/1.1 202 Accepted content-length: 0  Sending a Response to a Command (unauthenticated Device)  URI: /command/res/${tenantId}/${deviceId}/${commandRequestId} or /command/res/${tenantId}/${deviceId}/${commandRequestId}?hono-cmd-status=${status} Method: PUT Request Headers:  (optional) content-type: A media type describing the semantics and format of the payload contained in the request body (the outcome of processing the command). (optional) hono-cmd-status: The status of the command execution. If not set, the adapter expects that the URI contains it as request parameter at the end.  Request Body:  (optional) Arbitrary data representing the result of processing the command on the device.  Status Codes:  202 (Accepted): The response has been successfully delivered to the application that has sent the command. 400 (Bad Request): The request cannot be processed because the command status is missing. 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this might be:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed. Possible reasons for this include:  There is no application listening for a reply to the given commandRequestId. The application has already given up on waiting for a response.    This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_HTTP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nSend a response to a previously received command with the command-request-id req-id-uuid for the unauthenticated device 4711:\ncurl -i -X PUT -H 'content-type: application/json' --data-binary '{\u0026quot;brightness-changed\u0026quot;: true}' http://127.0.0.1:8080/command/res/DEFAULT_TENANT/4711/req-id-uuid?hono-cmd-status=200 HTTP/1.1 202 Accepted content-length: 0  Sending a Response to a Command (authenticated Gateway)  URI: /command/res/${tenantId}/${deviceId}/${commandRequestId} or /command/res/${tenantId}/${deviceId}/${commandRequestId}?hono-cmd-status=${status} Method: PUT Request Headers:  (optional) authorization: The gateway\u0026rsquo;s auth-id and plain text password encoded according to the Basic HTTP authentication scheme. If not set, the adapter expects the gateway to present a client certificate as part of the TLS handshake during connection establishment. (optional) content-type: A media type describing the semantics and format of the payload contained in the request body (the outcome of processing the command). (optional) hono-cmd-status: The status of the command execution. If not set, the adapter expects that the URI contains it as request parameter at the end.  Request Body:  (optional) Arbitrary data representing the result of processing the command on the device.  Status Codes:  202 (Accepted): The response has been successfully delivered to the application that has sent the command. 400 (Bad Request): The request cannot be processed because the command status is missing. 403 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this might be:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant. The gateway is not authorized to act on behalf of the device. The gateway associated with the device is not registered or disabled.  404 (Not Found): The request cannot be processed because the device is disabled or does not exist. 413 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 429 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 503 (Service Unavailable): The request cannot be processed. Possible reasons for this include:  There is no application listening for a reply to the given commandRequestId. The application has already given up on waiting for a response.    This resource can be used by gateway components to send the response to a command on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to send responses to a command on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nSend a response to a previously received command with the command-request-id req-id-uuid for device 4712:\ncurl -i -X PUT -u gw@DEFAULT_TENANT:gw-secret -H 'content-type: application/json' --data-binary '{\u0026quot;brightness-changed\u0026quot;: true}' http://127.0.0.1:8080/command/res/DEFAULT_TENANT/4712/req-id-uuid?hono-cmd-status=200 HTTP/1.1 202 Accepted content-length: 0  NB The example above assumes that a gateway device has been registered with hashed-password credentials with auth-id gw and password gw-secret which is authorized to publish data on behalf of device 4712.\nDownstream Meta Data The adapter includes the following meta data in the application properties of messages being sent downstream:\n   Name Type Description     device_id string The identifier of the device that the message originates from.   orig_adapter string Contains the adapter\u0026rsquo;s type name which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The HTTP adapter\u0026rsquo;s type name is hono-http.   orig_address string Contains the (relative) URI that the device has originally posted the data to.   ttd integer Contains the effective number of seconds that the device will wait for a response. This property is only set if the HTTP request contains the hono-ttd header or request parameter.    The adapter also considers defaults registered for the device at either the tenant or the device level. The values of the default properties are determined as follows:\n If the message already contains a non-empty property of the same name, the value if unchanged. Otherwise, if a default property of the same name is defined in the device\u0026rsquo;s registration information, that value is used. Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.  Note that of the standard AMQP 1.0 message properties only the content-type and ttl can be set this way to a default value.\nEvent Message Time-to-live Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers. In most cases the AMQP Messaging Network can be configured with a maximum time-to-live to apply to the events so that the events will be removed from the persistent store if no consumer has attached to receive the event before the message expires.\nIn order to support environments where the AMQP Messaging Network cannot be configured accordingly, the protocol adapter supports setting a downstream event message\u0026rsquo;s ttl property based on the hono-ttl property set as a header or a query parameter in the event requests by the devices. Also the default ttl and max-ttl values can be configured for a tenant/device as described in the Tenant API.\nTenant specific Configuration The adapter uses the Tenant API to retrieve tenant specific configuration for adapter type hono-http. The following properties are (currently) supported:\n   Name Type Default Value Description     enabled boolean true If set to false the adapter will reject all data from devices belonging to the tenant.   max-ttd integer 60 Defines a tenant specific upper limit for the time until disconnect property that devices may include in requests for uploading telemetry data or events. Please refer to the Command \u0026amp; Control concept page for a discussion of this parameter\u0026rsquo;s purpose and usage.\nThis property can be set for the hono-http adapter type as an extension property in the adapter section of the tenant configuration.\nIf it is not set, then the default value of 60 seconds is used.   "
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/user-guide/mqtt-adapter/",
 	"title": "MQTT Adapter",
 	"tags": [],
 	"description": "",
-	"content": "The MQTT protocol adapter exposes an MQTT topic hierarchy for publishing telemetry data and events to downstream consumers and for receiving commands from applications and sending back responses.\nThe MQTT adapter is not a general purpose MQTT broker. In particular the adapter\n supports MQTT 3.1.1 only. does not maintain session state for clients and thus always sets the session present flag in its CONNACK packet to 0, regardless of the value of the clean session flag provided in a client\u0026rsquo;s CONNECT packet. ignores any Will included in a client\u0026rsquo;s CONNECT packet. only supports topic names/filters for devices to publish and subscribe to that are specific to Hono\u0026rsquo;s functionality as described in the following sections. does not support retaining messages. However, if an event or telemetry message\u0026rsquo;s retain flag is set to 1 then the corresponding AMQP 1.0 message being sent downstream by the adapter will contain an x-opt-retain message annotation containing the boolean value true. A downstream consumer may then react according to the presence of this annotation.  Authentication The MQTT adapter by default requires clients (devices or gateway components) to authenticate during connection establishment. The adapter supports both the authentication based on the username/password provided in an MQTT CONNECT packet as well as client certificate based authentication as part of a TLS handshake for that purpose.\nThe adapter tries to authenticate the device using these mechanisms in the following order\nClient Certificate When a device uses a client certificate for authentication during the TLS handshake, the adapter tries to determine the tenant that the device belongs to based on the issuer DN contained in the certificate. In order for the lookup to succeed, the tenant\u0026rsquo;s trust anchor needs to be configured by means of registering the trusted certificate authority. The device\u0026rsquo;s client certificate will then be validated using the registered trust anchor, thus implicitly establishing the tenant that the device belongs to. In a second step, the adapter uses the Credentials API\u0026rsquo;s get operation to retrieve the credentials on record, including the client certificate\u0026rsquo;s subject DN as the auth-id, x509-cert as the type of secret and the MQTT client identifier as client-id in the request payload.\nNB The adapter needs to be configured for TLS in order to support this mechanism.\nUsername/Password When a device wants to authenticate using this mechanism, it needs to provide a username and a password in the MQTT CONNECT packet it sends in order to initiate the connection. The username must have the form auth-id@tenant, e.g. sensor1@DEFAULT_TENANT. The adapter verifies the credentials provided by the client against the credentials that the configured Credentials service has on record for the client. The adapter uses the Credentials API\u0026rsquo;s get operation to retrieve the credentials on record, including the tenant and auth-id provided by the client in the username, hashed-password as the type of secret and the MQTT client identifier as client-id in the request payload.\nThe examples below refer to devices 4711 and gw-1 of tenant DEFAULT_TENANT using auth-ids sensor1 and gw1 and corresponding passwords. The example deployment as described in the Deployment Guides comes pre-configured with the corresponding entities in its device registry component.\nNB There is a subtle difference between the device identifier (device-id) and the auth-id a device uses for authentication. See Device Identity for a discussion of the concepts.\nResource Limit Checks The adapter performs additional checks regarding resource limits when a client tries to connect and/or send a message to the adapter.\nConnection Limits The adapter rejects a client’s connection attempt with return code\n 0x03 (Connection Refused: server unavailable), if the maximum number of connections per protocol adapter instance is reached 0x05 (Connection Refused: not authorized), if the maximum number of simultaneously connected devices for the tenant is reached.  Connection Duration Limits The adapter rejects a client’s connection attempt with return code 0x05 (Connection Refused: not authorized), if the connection duration limit that has been configured for the client’s tenant is exceeded.\nMessage Limits The adapter\n rejects a client\u0026rsquo;s connection attempt with return code 0x05 (Connection Refused: not authorized), discards any MQTT PUBLISH packet containing telemetry data or an event that is sent by a client and rejects any AMQP 1.0 message containing a command sent by a north bound application  if the message limit that has been configured for the device’s tenant is exceeded.\nConnection Event The MQTT Adapter can send a Connection Event once the connection with a device has been successfully established or ended. Note that this requires the HONO_CONNECTION_EVENTS_PRODUCER configuration property to be explicitly set to events.\nPublishing Telemetry Data The MQTT adapter supports the publishing of telemetry data by means of MQTT PUBLISH packets using either QoS 0 or QoS 1. Using QoS 1 will result in the adapter sending an MQTT PUBACK packet to the client once the message has been settled with the accepted outcome by the AMQP 1.0 Messaging Network.\nThis requires that\n the AMQP 1.0 Messaging Network has capacity to process telemetry messages for the client\u0026rsquo;s tenant and the messages published by the client comply with the format defined by the Telemetry API.  The protocol adapter checks the configured message limit before accepting any telemetry messages. If the message limit is exceeded or the incoming telemetry message cannot be processed, the connection to the client is closed.\nPublish Telemetry Data (authenticated Device)  Topic: telemetry or t Authentication: required Payload:  (required) Arbitrary payload   This is the preferred way for devices to publish telemetry data. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default). When using this topic, the MQTT adapter determines the device\u0026rsquo;s tenant and device identity as part of the authentication process.\nExample\nPublish some JSON data for device 4711:\nmosquitto_pub -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t telemetry -m '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4711 using a client certificate for authentication:\n# in base directory of Hono repository: mosquitto_pub -p 8883 -t telemetry -m '{\u0026quot;temp\u0026quot;: 5}' --cert demo-certs/certs/device-4711-cert.pem --key demo-certs/certs/device-4711-key.pem --cafile demo-certs/certs/trusted-certs.pem  NB The example above assumes that the MQTT adapter is configured for TLS and the secure port is used.\nPublish Telemetry Data (unauthenticated Device)  Topic: telemetry/${tenant-id}/${device-id} or t/${tenant-id}/${device-id} Authentication: none Payload:  (required) Arbitrary payload   This topic can be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_MQTT_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711:\nmosquitto_pub -t telemetry/DEFAULT_TENANT/4711 -m '{\u0026quot;temp\u0026quot;: 5}'  Publish Telemetry Data (authenticated Gateway)  Topic: telemetry/${tenant-id}/${device-id} or t/${tenant-id}/${device-id} Authentication: required Payload:  (required) Arbitrary payload   This topic can be used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the topic name are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nPublish some JSON data for device 4712 via gateway gw-1:\nmosquitto_pub -u 'gw@DEFAULT_TENANT' -P gw-secret -t telemetry/DEFAULT_TENANT/4712 -m '{\u0026quot;temp\u0026quot;: 5}'  NB The example above assumes that a gateway device with ID gw-1 has been registered with hashed-password credentials with auth-id gw and password gw-secret.\nPublishing Events The MQTT adapter supports the publishing of events by means of MQTT PUBLISH packets using QoS 1 only. The adapter will send an MQTT PUBACK packet to the client once the event has been settled with the accepted outcome by the AMQP 1.0 Messaging Network.\nThis requires that\n the AMQP 1.0 Messaging Network has capacity to process events for the client\u0026rsquo;s tenant and the events published by the client comply with the format defined by the Event API.  The protocol adapter checks the configured message limit before accepting any event messages. If the message limit is exceeded or the incoming event message cannot be processed, the connection to the client is closed.\nThe devices can optionally indicate a time-to-live duration for event messages by setting the hono-ttl property explicitly in the property-bag. The property-bag is an optional collection of properties intended for the receiver of the message. A property bag is only allowed at the very end of a topic. It always starts with a /? character, followed by pairs of URL encoded property names and values that are separated by \u0026amp;. For example, a property bag containing two properties seqNo and importance looks like this: /topic/name/?seqNo=10034\u0026amp;importance=high.\nThe MQTT adapter currently does not use any properties except hono-ttl.\nPublish an Event (authenticated Device)  Topic: event or e Authentication: required Payload:  (required) Arbitrary payload   This is the preferred way for devices to publish events. It is available only if the protocol adapter has been configured to require devices to authenticate (which is the default).\nExample\nUpload a JSON string for device 4711:\nmosquitto_pub -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t event -q 1 -m '{\u0026quot;alarm\u0026quot;: 1}'  Upload a JSON string for device 4711 with time-to-live as 10 seconds:\nmosquitto_pub -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t event/?hono-ttl=10 -q 1 -m '{\u0026quot;alarm\u0026quot;: 1}'  Publish an Event (unauthenticated Device)  Topic: event/${tenant-id}/${device-id} or e/${tenant-id}/${device-id} Authentication: none Payload:  (required) Arbitrary payload   This topic can be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_MQTT_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711:\nmosquitto_pub -t event/DEFAULT_TENANT/4711 -q 1 -m '{\u0026quot;alarm\u0026quot;: 1}'  Publish some JSON data for device 4711 with time-to-live as 15 seconds:\nmosquitto_pub -t event/DEFAULT_TENANT/4711/?hono-ttl=15 -q 1 -m '{\u0026quot;alarm\u0026quot;: 1}'  Publish an Event (authenticated Gateway)  Topic: event/${tenant-id}/${device-id} or e/${tenant-id}/${device-id} Authentication: required Payload:  (required) Arbitrary payload   This topic can be used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the topic name are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nPublish some JSON data for device 4712 via gateway gw-1:\nmosquitto_pub -u 'gw@DEFAULT_TENANT' -P gw-secret -t event/DEFAULT_TENANT/4712 -q 1 -m '{\u0026quot;temp\u0026quot;: 5}'  NB The example above assumes that a gateway device with ID gw-1 has been registered with hashed-password credentials with auth-id gw and password gw-secret.\nCommand \u0026amp; Control The MQTT adapter enables devices to receive commands that have been sent by business applications by means of sending an MQTT SUBSCRIBE packet containing a device specific topic filter as described below. Devices can subscribe with QoS 1 or QoS 0. The adapter indicates the outcome of the subscription request by sending back a corresponding SUBACK packet. The SUBACK packet will contain Success - QoS 0 (0x00) or Success - QoS 1 (0x01) for a command topic filter indicating QoS 0 or 1 and will contain the Failure (0x80) value for all other filters. When a device no longer wants to receive commands anymore, it can send an MQTT UNSUBSCRIBE packet to the adapter, including the same topic filter that has been used to subscribe.\nWhen a device has successfully subscribed, the adapter sends an empty notification on behalf of the device to the downstream AMQP 1.0 Messaging Network with the ttd header set to -1, indicating that the device will be ready to receive commands until further notice. Analogously, the adapter sends an empty notification with the ttd header set to 0 when a device unsubscribes from commands.\nCommands can be sent following a request/response pattern or being one-way.\nFor Request/Response commands, devices send their responses to commands by means of sending an MQTT PUBLISH message to a topic that is specific to the command that has been executed. The MQTT adapter accepts responses being published using either QoS 0 or QoS 1.\nThe MQTT adapter checks the configured message limit before accepting any command requests and responses. In case of incoming command requests from business applications, if the message limit is exceeded, the Adapter rejects the message with the reason amqp:resource-limit-exceeded. And for the incoming command responses from devices, the Adapter rejects the message and closes the connection to the client.\nThe following sections define the topic filters/names to use for subscribing to and responding to commands. The following shorthand versions of topic path segments are supported:\n c instead of command q instead of req s instead of res  The following variables are used:\n ${command} : An arbitrary string that indicates the command to execute, e.g. setBrightness. The command is provided by the application that sends the command. ${req-id} (only for Request/Response commands) : The unique identifier of the command execution request. The identifier is passed to the device as part of the name of the topic that the command is published to. The device needs to publish its response to the command to a topic which includes this identifier, thus allowing the adapter to correlate the response with the request. ${status} : The HTTP status code indicating the outcome of executing the command. This status code is passed on to the application in the AMQP message\u0026rsquo;s status application property.  Receiving Commands (authenticated Device) An authenticated device MUST use the topic filter command///req/# to subscribe to commands.\n Deprecation Previous versions of Hono required authenticated devices to use command/+/+/req/# for subscribing to commands. This old topic filter is deprecated. Devices MAY still use it until support for it will be removed in a future Hono version.  Example\nmosquitto_sub -v -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t command///req/#  The adapter will then publish Request/Response commands for the device to topic command///req/${req-id}/${command} and one-way commands to topic command///req//${command}.\nFor example, a request/response command with name setBrightness from an application might look like this:\ncommand///q/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/setBrightness { \u0026quot;brightness\u0026quot;: 79 }  A corresponding one-way command might look like this:\ncommand///q//setBrightness { \u0026quot;brightness\u0026quot;: 79 }  Note that the topic in the latter case doesn\u0026rsquo;t contain a request identifier.\nReceiving Commands (unauthenticated Device) An unauthenticated device MUST use the topic filter command/${tenant-id}/${device-id}/req/# to subscribe to commands.\nExample\nmosquitto_sub -v -t command/DEFAULT_TENANT/4711/req/#  The adapter will then publish Request/Response commands for the device to topic command/${tenant-id}/${device-id}/req/${req-id}/${command} and one-way commands to topic command/${tenant-id}/${device-id}/req//${command}.\nFor example, a request/response command with name setBrightness from an application might look like this:\ncommand/DEFAULT_TENANT/4711/q/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/setBrightness { \u0026quot;brightness\u0026quot;: 79 }  A corresponding one-way command might look like this:\ncommand/DEFAULT_TENANT/4711/q//setBrightness { \u0026quot;brightness\u0026quot;: 79 }  Note that the topic in the latter case doesn\u0026rsquo;t contain a request identifier.\nReceiving Commands (authenticated Gateway) Gateway components can receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. Corresponding devices have to be configured so that they can be used with a gateway. See Configuring Gateway Devices for details.\nAn authenticated gateway MUST use the topic filter command//+/req/# to subscribe to commands for all devices in whose behalf it acts.\nTo subscribe only to commands for a specific device, an authenticated gateway MUST use the topic filter command//${device-id}/req/#.\n Deprecation Previous versions of Hono required authenticated gateways to use command/+/+/req/# for subscribing to commands. This old topic filter is deprecated. Gateways MAY still use it until support for it will be removed in a future Hono version.  When processing an incoming command message, the protocol adapter will give precedence to a device-specific command subscription matching the command target device, whether the subscription comes from a gateway or the device itself. If there are multiple such subscriptions from multiple gateways and/or from the device itself, the subscription initiated last will get the command messages.\nIf no device-specific command subscription exists for a command target device, but one gateway, that may act on behalf of the device, has subscribed to commands for all its devices, then the command message is sent to that gateway.\nIf multiple gateways have initiated such generic subscriptions, the protocol adapter may have to decide to which gateway a particular command message will be sent to. In case the command target device has already sent a telemetry, event or command response message via a gateway and if that gateway has created such a command subscription, that gateway will be chosen. Otherwise one gateway that may act on behalf of the command target device and that has an open subscription will be chosen randomly to receive the command message.\nExample\nA subscription to commands for all devices that a gateway acts on behalf of looks like this:\nmosquitto_sub -v -u 'gw@DEFAULT_TENANT' -P gw-secret -t command//+/req/#  A subscription to commands for a specific device can be done like this:\nmosquitto_sub -v -u 'gw@DEFAULT_TENANT' -P gw-secret -t command//4711/req/#  The adapter will then publish Request/Response commands for devices, that the gateway has acted on behalf of, to topic command//${device-id}/req/${req-id}/${command} and one-way commands to topic command//${device-id}/req//${command}.\nFor example, a request/response command for device 4711 with name setBrightness from an application might look like this:\ncommand//4711/q/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/setBrightness { \u0026quot;brightness\u0026quot;: 79 }  A corresponding one-way command might look like this:\ncommand//4711/q//setBrightness { \u0026quot;brightness\u0026quot;: 79 }  Note that the topic in the latter case doesn\u0026rsquo;t contain a request identifier.\nSending a Response to a Command (authenticated Device) An authenticated device MUST send the response to a previously received command to the topic command///res/${req-id}/${status}.\nExample\nAfter a command has arrived as in the above example, you send a response using the arrived ${req-id}:\nmosquitto_pub -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t command///res/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/200 -m '{\u0026quot;lumen\u0026quot;: 200}'  Sending a Response to a Command (unauthenticated Device) An unauthenticated device MUST send the response to a previously received command to the topic command/${tenant-id}/${device-id}/res/${req-id}/${status}.\nExample\nAfter a command has arrived as in the above example, you send a response using the arrived ${req-id}:\nmosquitto_pub -t command/DEFAULT_TENANT/4711/res/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/200 -m '{\u0026quot;lumen\u0026quot;: 200}'  Sending a Response to a Command (authenticated Gateway) An authenticated gateway MUST send a device\u0026rsquo;s response to a command it has received on behalf of the device to the topic command//${device-id}/res/${req-id}/${status}.\nExample\nAfter a command has arrived as in the above example, the response is sent using the ${req-id} from the topic that the command had been published to:\nmosquitto_pub -u 'gw@DEFAULT_TENANT' -P gw-secret -t command//4711/res/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/200 -m '{\u0026quot;lumen\u0026quot;: 200}'  Downstream Meta Data The adapter includes the following meta data in messages being sent downstream:\n   Name Location Type Description     device_id application string The identifier of the device that the message originates from.   orig_adapter application string Contains the adapter\u0026rsquo;s type name which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The MQTT adapter\u0026rsquo;s type name is hono-mqtt.   orig_address application string Contains the name of the MQTT topic that the device has originally published the data to.   x-opt-retain * message-annotations boolean Contains true if the device has published an event or telemetry message with its retain flag set to 1    The adapter also considers defaults registered for the device at either the tenant or the device level. The values of the default properties are determined as follows:\n If the message already contains a non-empty property of the same name, the value if unchanged. Otherwise, if a default property of the same name is defined in the device\u0026rsquo;s registration information, that value is used. Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.  Note that of the standard AMQP 1.0 message properties only the content-type and ttl can be set this way to a default value.\nEvent Message Time-to-live Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers. In most cases the AMQP Messaging Network can be configured with a maximum time-to-live to apply to the events so that the events will be removed from the persistent store if no consumer has attached to receive the event before the message expires.\nIn order to support environments where the AMQP Messaging Network cannot be configured accordingly, the MQTT protocol adapter supports setting a downstream event message\u0026rsquo;s ttl property based on the hono-ttl property set as property-bag at the end of the event topic. Also the default ttl and max-ttl values can be configured for a tenant/device as described in the Tenant API.\nTenant specific Configuration The adapter uses the Tenant API to retrieve tenant specific configuration for adapter type hono-mqtt. The following properties are (currently) supported:\n   Name Type Default Value Description     enabled boolean true If set to false the adapter will reject all data from devices belonging to the tenant.   "
+	"content": "The MQTT protocol adapter exposes an MQTT topic hierarchy for publishing telemetry data and events to downstream consumers and for receiving commands from applications and sending back responses.\nThe MQTT adapter is not a general purpose MQTT broker. In particular the adapter\n supports MQTT 3.1.1 only. does not maintain session state for clients and thus always sets the session present flag in its CONNACK packet to 0, regardless of the value of the clean session flag provided in a client\u0026rsquo;s CONNECT packet. ignores any Will included in a client\u0026rsquo;s CONNECT packet. only supports topic names/filters for devices to publish and subscribe to that are specific to Hono\u0026rsquo;s functionality as described in the following sections. does not support retaining messages. However, if an event or telemetry message\u0026rsquo;s retain flag is set to 1 then the corresponding AMQP 1.0 message being sent downstream by the adapter will contain an x-opt-retain message annotation containing the boolean value true. A downstream consumer may then react according to the presence of this annotation.  Authentication The MQTT adapter by default requires clients (devices or gateway components) to authenticate during connection establishment. The adapter supports both the authentication based on the username/password provided in an MQTT CONNECT packet as well as client certificate based authentication as part of a TLS handshake for that purpose.\nThe adapter tries to authenticate the device using these mechanisms in the following order\nClient Certificate When a device uses a client certificate for authentication during the TLS handshake, the adapter tries to determine the tenant that the device belongs to based on the issuer DN contained in the certificate. In order for the lookup to succeed, the tenant\u0026rsquo;s trust anchor needs to be configured by means of registering the trusted certificate authority. The device\u0026rsquo;s client certificate will then be validated using the registered trust anchor, thus implicitly establishing the tenant that the device belongs to. In a second step, the adapter uses the Credentials API\u0026rsquo;s get operation to retrieve the credentials on record, including the client certificate\u0026rsquo;s subject DN as the auth-id, x509-cert as the type of secret and the MQTT client identifier as client-id in the request payload.\nNB The adapter needs to be configured for TLS in order to support this mechanism.\nUsername/Password When a device wants to authenticate using this mechanism, it needs to provide a username and a password in the MQTT CONNECT packet it sends in order to initiate the connection. The username must have the form auth-id@tenant, e.g. sensor1@DEFAULT_TENANT. The adapter verifies the credentials provided by the client against the credentials that the configured Credentials service has on record for the client. The adapter uses the Credentials API\u0026rsquo;s get operation to retrieve the credentials on record, including the tenant and auth-id provided by the client in the username, hashed-password as the type of secret and the MQTT client identifier as client-id in the request payload.\nThe examples below refer to devices 4711 and gw-1 of tenant DEFAULT_TENANT using auth-ids sensor1 and gw1 and corresponding passwords. The example deployment as described in the Deployment Guides comes pre-configured with the corresponding entities in its device registry component.\nNB There is a subtle difference between the device identifier (device-id) and the auth-id a device uses for authentication. See Device Identity for a discussion of the concepts.\nResource Limit Checks The adapter performs additional checks regarding resource limits when a client tries to connect and/or send a message to the adapter.\nConnection Limits The adapter rejects a client’s connection attempt with return code\n 0x03 (Connection Refused: server unavailable), if the maximum number of connections per protocol adapter instance is reached 0x05 (Connection Refused: not authorized), if the maximum number of simultaneously connected devices for the tenant is reached.  Connection Duration Limits The adapter rejects a client’s connection attempt with return code 0x05 (Connection Refused: not authorized), if the connection duration limit that has been configured for the client’s tenant is exceeded.\nMessage Limits The adapter\n rejects a client\u0026rsquo;s connection attempt with return code 0x05 (Connection Refused: not authorized), discards any MQTT PUBLISH packet containing telemetry data or an event that is sent by a client and rejects any AMQP 1.0 message containing a command sent by a north bound application  if the message limit that has been configured for the device’s tenant is exceeded.\nConnection Events The adapter can emit Connection Events for client connections being established and/or terminated. Please refer to the common configuration options for details regarding how to enable this behavior.\nThe adapter includes the client identifier from the client\u0026rsquo;s MQTT CONNECT packet as the Connection Event\u0026rsquo;s remote-id.\nPublishing Telemetry Data The MQTT adapter supports the publishing of telemetry data by means of MQTT PUBLISH packets using either QoS 0 or QoS 1. Using QoS 1 will result in the adapter sending an MQTT PUBACK packet to the client once the message has been settled with the accepted outcome by the AMQP 1.0 Messaging Network.\nThis requires that\n the AMQP 1.0 Messaging Network has capacity to process telemetry messages for the client\u0026rsquo;s tenant and the messages published by the client comply with the format defined by the Telemetry API.  The protocol adapter checks the configured message limit before accepting any telemetry messages. If the message limit is exceeded or the incoming telemetry message cannot be processed, the connection to the client is closed.\nPublish Telemetry Data (authenticated Device)  Topic: telemetry or t Authentication: required Payload:  (required) Arbitrary payload   This is the preferred way for devices to publish telemetry data. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default). When using this topic, the MQTT adapter determines the device\u0026rsquo;s tenant and device identity as part of the authentication process.\nExample\nPublish some JSON data for device 4711:\nmosquitto_pub -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t telemetry -m '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4711 using a client certificate for authentication:\n# in base directory of Hono repository: mosquitto_pub -p 8883 -t telemetry -m '{\u0026quot;temp\u0026quot;: 5}' --cert demo-certs/certs/device-4711-cert.pem --key demo-certs/certs/device-4711-key.pem --cafile demo-certs/certs/trusted-certs.pem  NB The example above assumes that the MQTT adapter is configured for TLS and the secure port is used.\nPublish Telemetry Data (unauthenticated Device)  Topic: telemetry/${tenant-id}/${device-id} or t/${tenant-id}/${device-id} Authentication: none Payload:  (required) Arbitrary payload   This topic can be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_MQTT_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711:\nmosquitto_pub -t telemetry/DEFAULT_TENANT/4711 -m '{\u0026quot;temp\u0026quot;: 5}'  Publish Telemetry Data (authenticated Gateway)  Topic: telemetry/${tenant-id}/${device-id} or t/${tenant-id}/${device-id} Authentication: required Payload:  (required) Arbitrary payload   This topic can be used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the topic name are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nPublish some JSON data for device 4712 via gateway gw-1:\nmosquitto_pub -u 'gw@DEFAULT_TENANT' -P gw-secret -t telemetry/DEFAULT_TENANT/4712 -m '{\u0026quot;temp\u0026quot;: 5}'  NB The example above assumes that a gateway device with ID gw-1 has been registered with hashed-password credentials with auth-id gw and password gw-secret.\nPublishing Events The MQTT adapter supports the publishing of events by means of MQTT PUBLISH packets using QoS 1 only. The adapter will send an MQTT PUBACK packet to the client once the event has been settled with the accepted outcome by the AMQP 1.0 Messaging Network.\nThis requires that\n the AMQP 1.0 Messaging Network has capacity to process events for the client\u0026rsquo;s tenant and the events published by the client comply with the format defined by the Event API.  The protocol adapter checks the configured message limit before accepting any event messages. If the message limit is exceeded or the incoming event message cannot be processed, the connection to the client is closed.\nThe devices can optionally indicate a time-to-live duration for event messages by setting the hono-ttl property explicitly in the property-bag. The property-bag is an optional collection of properties intended for the receiver of the message. A property bag is only allowed at the very end of a topic. It always starts with a /? character, followed by pairs of URL encoded property names and values that are separated by \u0026amp;. For example, a property bag containing two properties seqNo and importance looks like this: /topic/name/?seqNo=10034\u0026amp;importance=high.\nThe MQTT adapter currently does not use any properties except hono-ttl.\nPublish an Event (authenticated Device)  Topic: event or e Authentication: required Payload:  (required) Arbitrary payload   This is the preferred way for devices to publish events. It is available only if the protocol adapter has been configured to require devices to authenticate (which is the default).\nExample\nUpload a JSON string for device 4711:\nmosquitto_pub -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t event -q 1 -m '{\u0026quot;alarm\u0026quot;: 1}'  Upload a JSON string for device 4711 with time-to-live as 10 seconds:\nmosquitto_pub -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t event/?hono-ttl=10 -q 1 -m '{\u0026quot;alarm\u0026quot;: 1}'  Publish an Event (unauthenticated Device)  Topic: event/${tenant-id}/${device-id} or e/${tenant-id}/${device-id} Authentication: none Payload:  (required) Arbitrary payload   This topic can be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_MQTT_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711:\nmosquitto_pub -t event/DEFAULT_TENANT/4711 -q 1 -m '{\u0026quot;alarm\u0026quot;: 1}'  Publish some JSON data for device 4711 with time-to-live as 15 seconds:\nmosquitto_pub -t event/DEFAULT_TENANT/4711/?hono-ttl=15 -q 1 -m '{\u0026quot;alarm\u0026quot;: 1}'  Publish an Event (authenticated Gateway)  Topic: event/${tenant-id}/${device-id} or e/${tenant-id}/${device-id} Authentication: required Payload:  (required) Arbitrary payload   This topic can be used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the topic name are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nPublish some JSON data for device 4712 via gateway gw-1:\nmosquitto_pub -u 'gw@DEFAULT_TENANT' -P gw-secret -t event/DEFAULT_TENANT/4712 -q 1 -m '{\u0026quot;temp\u0026quot;: 5}'  NB The example above assumes that a gateway device with ID gw-1 has been registered with hashed-password credentials with auth-id gw and password gw-secret.\nCommand \u0026amp; Control The MQTT adapter enables devices to receive commands that have been sent by business applications by means of sending an MQTT SUBSCRIBE packet containing a device specific topic filter as described below. Devices can subscribe with QoS 1 or QoS 0. The adapter indicates the outcome of the subscription request by sending back a corresponding SUBACK packet. The SUBACK packet will contain Success - QoS 0 (0x00) or Success - QoS 1 (0x01) for a command topic filter indicating QoS 0 or 1 and will contain the Failure (0x80) value for all other filters. When a device no longer wants to receive commands anymore, it can send an MQTT UNSUBSCRIBE packet to the adapter, including the same topic filter that has been used to subscribe.\nWhen a device has successfully subscribed, the adapter sends an empty notification on behalf of the device to the downstream AMQP 1.0 Messaging Network with the ttd header set to -1, indicating that the device will be ready to receive commands until further notice. Analogously, the adapter sends an empty notification with the ttd header set to 0 when a device unsubscribes from commands.\nCommands can be sent following a request/response pattern or being one-way.\nFor Request/Response commands, devices send their responses to commands by means of sending an MQTT PUBLISH message to a topic that is specific to the command that has been executed. The MQTT adapter accepts responses being published using either QoS 0 or QoS 1.\nThe MQTT adapter checks the configured message limit before accepting any command requests and responses. In case of incoming command requests from business applications, if the message limit is exceeded, the Adapter rejects the message with the reason amqp:resource-limit-exceeded. And for the incoming command responses from devices, the Adapter rejects the message and closes the connection to the client.\nThe following sections define the topic filters/names to use for subscribing to and responding to commands. The following shorthand versions of topic path segments are supported:\n c instead of command q instead of req s instead of res  The following variables are used:\n ${command} : An arbitrary string that indicates the command to execute, e.g. setBrightness. The command is provided by the application that sends the command. ${req-id} (only for Request/Response commands) : The unique identifier of the command execution request. The identifier is passed to the device as part of the name of the topic that the command is published to. The device needs to publish its response to the command to a topic which includes this identifier, thus allowing the adapter to correlate the response with the request. ${status} : The HTTP status code indicating the outcome of executing the command. This status code is passed on to the application in the AMQP message\u0026rsquo;s status application property.  Receiving Commands (authenticated Device) An authenticated device MUST use the topic filter command///req/# to subscribe to commands.\n Deprecation Previous versions of Hono required authenticated devices to use command/+/+/req/# for subscribing to commands. This old topic filter is deprecated. Devices MAY still use it until support for it will be removed in a future Hono version.  Example\nmosquitto_sub -v -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t command///req/#  The adapter will then publish Request/Response commands for the device to topic command///req/${req-id}/${command} and one-way commands to topic command///req//${command}.\nFor example, a request/response command with name setBrightness from an application might look like this:\ncommand///q/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/setBrightness { \u0026quot;brightness\u0026quot;: 79 }  A corresponding one-way command might look like this:\ncommand///q//setBrightness { \u0026quot;brightness\u0026quot;: 79 }  Note that the topic in the latter case doesn\u0026rsquo;t contain a request identifier.\nReceiving Commands (unauthenticated Device) An unauthenticated device MUST use the topic filter command/${tenant-id}/${device-id}/req/# to subscribe to commands.\nExample\nmosquitto_sub -v -t command/DEFAULT_TENANT/4711/req/#  The adapter will then publish Request/Response commands for the device to topic command/${tenant-id}/${device-id}/req/${req-id}/${command} and one-way commands to topic command/${tenant-id}/${device-id}/req//${command}.\nFor example, a request/response command with name setBrightness from an application might look like this:\ncommand/DEFAULT_TENANT/4711/q/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/setBrightness { \u0026quot;brightness\u0026quot;: 79 }  A corresponding one-way command might look like this:\ncommand/DEFAULT_TENANT/4711/q//setBrightness { \u0026quot;brightness\u0026quot;: 79 }  Note that the topic in the latter case doesn\u0026rsquo;t contain a request identifier.\nReceiving Commands (authenticated Gateway) Gateway components can receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. Corresponding devices have to be configured so that they can be used with a gateway. See Configuring Gateway Devices for details.\nAn authenticated gateway MUST use the topic filter command//+/req/# to subscribe to commands for all devices in whose behalf it acts.\nTo subscribe only to commands for a specific device, an authenticated gateway MUST use the topic filter command//${device-id}/req/#.\n Deprecation Previous versions of Hono required authenticated gateways to use command/+/+/req/# for subscribing to commands. This old topic filter is deprecated. Gateways MAY still use it until support for it will be removed in a future Hono version.  When processing an incoming command message, the protocol adapter will give precedence to a device-specific command subscription matching the command target device, whether the subscription comes from a gateway or the device itself. If there are multiple such subscriptions from multiple gateways and/or from the device itself, the subscription initiated last will get the command messages.\nIf no device-specific command subscription exists for a command target device, but one gateway, that may act on behalf of the device, has subscribed to commands for all its devices, then the command message is sent to that gateway.\nIf multiple gateways have initiated such generic subscriptions, the protocol adapter may have to decide to which gateway a particular command message will be sent to. In case the command target device has already sent a telemetry, event or command response message via a gateway and if that gateway has created such a command subscription, that gateway will be chosen. Otherwise one gateway that may act on behalf of the command target device and that has an open subscription will be chosen randomly to receive the command message.\nExample\nA subscription to commands for all devices that a gateway acts on behalf of looks like this:\nmosquitto_sub -v -u 'gw@DEFAULT_TENANT' -P gw-secret -t command//+/req/#  A subscription to commands for a specific device can be done like this:\nmosquitto_sub -v -u 'gw@DEFAULT_TENANT' -P gw-secret -t command//4711/req/#  The adapter will then publish Request/Response commands for devices, that the gateway has acted on behalf of, to topic command//${device-id}/req/${req-id}/${command} and one-way commands to topic command//${device-id}/req//${command}.\nFor example, a request/response command for device 4711 with name setBrightness from an application might look like this:\ncommand//4711/q/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/setBrightness { \u0026quot;brightness\u0026quot;: 79 }  A corresponding one-way command might look like this:\ncommand//4711/q//setBrightness { \u0026quot;brightness\u0026quot;: 79 }  Note that the topic in the latter case doesn\u0026rsquo;t contain a request identifier.\nSending a Response to a Command (authenticated Device) An authenticated device MUST send the response to a previously received command to the topic command///res/${req-id}/${status}.\nExample\nAfter a command has arrived as in the above example, you send a response using the arrived ${req-id}:\nmosquitto_pub -u 'sensor1@DEFAULT_TENANT' -P hono-secret -t command///res/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/200 -m '{\u0026quot;lumen\u0026quot;: 200}'  Sending a Response to a Command (unauthenticated Device) An unauthenticated device MUST send the response to a previously received command to the topic command/${tenant-id}/${device-id}/res/${req-id}/${status}.\nExample\nAfter a command has arrived as in the above example, you send a response using the arrived ${req-id}:\nmosquitto_pub -t command/DEFAULT_TENANT/4711/res/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/200 -m '{\u0026quot;lumen\u0026quot;: 200}'  Sending a Response to a Command (authenticated Gateway) An authenticated gateway MUST send a device\u0026rsquo;s response to a command it has received on behalf of the device to the topic command//${device-id}/res/${req-id}/${status}.\nExample\nAfter a command has arrived as in the above example, the response is sent using the ${req-id} from the topic that the command had been published to:\nmosquitto_pub -u 'gw@DEFAULT_TENANT' -P gw-secret -t command//4711/res/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/200 -m '{\u0026quot;lumen\u0026quot;: 200}'  Custom Message Mapping This protocol adapter supports transformation of messages that have been uploaded by devices before they get forwarded to downstream consumers.\n Experimental This is an experimental feature. The names of the configuration properties, potential values and the overall functionality are therefore subject to change without prior notice.  This feature is useful in scenarios where devices are connected to the adapter via a gateway but the gateway is not able to include the device ID in the topic that the gateway publishes data to. The gateway will use the plain telemetry or event topics in this case. The message payload will usually contain the identifier of the device that the data originates from.\nThe same functionality can also be used to transform the payload of messages uploaded by a device. This can be used for example to transform binary encoded data into a JSON document which can be consumed more easily by downstream consumers.\nThe mechanism works as follows: 1. A client uploads a message to the MQTT adapter. 1. The adapter invokes the Device Registration service\u0026rsquo;s assert Registration operation using either the authenticated device\u0026rsquo;s identifier, if the topic does not contain a device ID, or the device ID from the topic. 1. If the assertion succeeds, the adapter creates the downstream message using the original message\u0026rsquo;s payload and the asserted device ID as the origin device. 1. If the response payload contains a value for the mapper property, the adapter tries to find a mapper endpoint configuration for the given value. If a mapper endpoint with a matching name has been configured for the adapter, 1. the adapter sends an HTTP request to the endpoint which contains the original message\u0026rsquo;s payload in the request body. 1. If the response body is not empty, it is used as the downstream message\u0026rsquo;s payload. 1. If the response contains a device_id header and its value is different from the original device ID, then the adapter invokes the assert Registration operation again, this time using the mapped device ID instead of the original device ID. If the assertion succeeds, the adapter uses the asserted (mapped) device ID for the downstream message. 1. The adapter forwards the downstream message.\nPlease refer to the Device Registry Management API for how to register a mapper for a device. Please refer to the MQTT Adapter Admin Guide for how to configure custom mapper endpoints.\nDownstream Meta Data The adapter includes the following meta data in messages being sent downstream:\n   Name Location Type Description     device_id application string The identifier of the device that the message originates from.   orig_adapter application string Contains the adapter\u0026rsquo;s type name which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The MQTT adapter\u0026rsquo;s type name is hono-mqtt.   orig_address application string Contains the name of the MQTT topic that the device has originally published the data to.   x-opt-retain message-annotations boolean Contains true if the device has published an event or telemetry message with its retain flag set to 1    The adapter also considers defaults registered for the device at either the tenant or the device level. The values of the default properties are determined as follows:\n If the message already contains a non-empty property of the same name, the value if unchanged. Otherwise, if a default property of the same name is defined in the device\u0026rsquo;s registration information, that value is used. Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.  Note that of the standard AMQP 1.0 message properties only the content-type and ttl can be set this way to a default value.\nEvent Message Time-to-live Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers. In most cases the AMQP Messaging Network can be configured with a maximum time-to-live to apply to the events so that the events will be removed from the persistent store if no consumer has attached to receive the event before the message expires.\nIn order to support environments where the AMQP Messaging Network cannot be configured accordingly, the MQTT protocol adapter supports setting a downstream event message\u0026rsquo;s ttl property based on the hono-ttl property set as property-bag at the end of the event topic. Also the default ttl and max-ttl values can be configured for a tenant/device as described in the Tenant API.\nTenant specific Configuration The adapter uses the Tenant API to retrieve tenant specific configuration for adapter type hono-mqtt. The following properties are (currently) supported:\n   Name Type Default Value Description     enabled boolean true If set to false the adapter will reject all data from devices belonging to the tenant.   "
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/user-guide/amqp-adapter/",
 	"title": "AMQP Adapter",
 	"tags": [],
 	"description": "",
-	"content": "The AMQP protocol adapter allows clients (devices or gateway components) supporting the AMQP 1.0 protocol to publish messages to Eclipse Hono\u0026trade;\u0026rsquo;s Telemetry, Event and Command \u0026amp; Control endpoints.\nDevice Authentication By default, all Hono protocol adapters require clients (devices or gateway components) to authenticate during connection establishment. This is the preferred way for devices to publish data via protocol adapters. The AMQP adapter supports both the SASL PLAIN and SASL EXTERNAL authentication mechanisms. The former uses a username and password to authenticate to the adapter while the latter uses a client certificate.\nIn this guide, we will give examples for publishing telemetry data and events for authenticated (using SASL PLAIN) and unauthenticated clients.\nNB The AMQP adapter can be configured to allow unauthenticated devices to connect by setting configuration variable HONO_AMQP_AUTHENTICATION_REQUIRED to false.\nSASL PLAIN Authentication The AMQP adapter supports authenticating clients using a username and password. This means that clients need to provide a username and a password when connecting to the AMQP adapter. If the adapter is configured for multi-tenancy (i.e HONO_AMQP_SINGLE_TENANT is set to false), then the username must match the pattern [auth-id@tenant], e.g. sensor1@DEFAULT_TENANT. Otherwise the DEFAULT_TENANT is assumed and the tenant-id can be omitted from the username.\nThe adapter verifies the credentials provided by the client against the credentials the configured Credentials service has on record for the client. If the credentials match, then authentication is successful and the client device can proceed to publish messages to Hono.\nThe examples below refer to devices 4711 and gw-1 of tenant DEFAULT_TENANT using auth-ids sensor1 and gw1 and corresponding passwords. The example deployment as described in the Deployment Guides comes pre-configured with the corresponding entities in its device registry component.\nNB There is a subtle difference between the device identifier (device-id) and the auth-id a device uses for authentication. See Device Identity for a discussion of the concepts.\nSASL EXTERNAL Authentication When a device uses a client certificate for authentication, the TLS handshake is initiated during TCP connection establishment. If no trust anchor is configured for the AMQP adapter, the TLS handshake will succeed only if the certificate has not yet expired. Once the TLS handshake completes and a secure connection is established, the certificate\u0026rsquo;s signature is checked during the SASL handshake. To complete the SASL handshake and authenticate the client, the adapter performs the following steps:\n Adapter extracts the client certificate\u0026rsquo;s Issuer DN and uses it to us the Tenant service to look up the tenant that the client belongs to. In order for the lookup to succeed, the tenant’s trust anchor needs to be configured by means of registering the trusted certificate authority. If the lookup succeeds, the Tenant service returns the tenant, thus implicitly establishing the tenant that the device belongs to. Adapter validates the device’s client certificate using the registered trust anchor for the tenant. Finally, adapter authenticates the client certificate using Hono\u0026rsquo;s credentials API. In this step, the adapter uses the client certificate’s Subject DN (as authentication identifier) and x509-cert (for the credentials type) in order to determine the device ID.  NB The AMQP adapter needs to be configured for TLS in order to support this mechanism.\nResource Limit Checks The adapter performs additional checks regarding resource limits when a client tries to connect and/or send a message to the adapter.\nConnection Limits The adapter fails the SASL handshake with a client\n if the maximum number of simultaneously connected devices for the client\u0026rsquo;s tenant is reached, or if the maximum number of connections per protocol adapter instance is reached.  Connection Duration Limits The adapter fails the SASL handshake with a client if the connection duration limit that has been configured for the client’s tenant is exceeded.\nMessage Limits The adapter\n fails the SASL handshake with a client and rejects any AMQP 1.0 message containing  telemetry data or an event uploaded by a client a command sent by a north bound application   if the message limit that has been configured for the device’s tenant is exceeded.\nConnection Event The AMQP Adapter can send a Connection Event once the connection with a device has been successfully established or ended. Note that this requires the HONO_CONNECTION_EVENTS_PRODUCER configuration property to be explicitly set to events.\nLink Establishment The AMQP adapter supports the Anonymous Terminus for Message Routing specification and requires clients to create a single sender link using the null target address for publishing all types of messages to the AMQP adapter.\nUsing AT MOST ONCE delivery semantics, the client will not wait for the message to be accepted and settled by the downstream consumer. However, with AT LEAST ONCE, the client sends the message and waits for the message to be delivered to and accepted by the downstream consumer. If the message cannot be delivered due to a failure, the client will be notified.\nThe client indicates its preferred message delivery mode by means of the snd-settle-mode and rcv-settle-mode fields of its attach frame during link establishment. Clients should use mixed as the snd-settle-mode and first as the rcv-settle-mode in order to be able to use the same link for sending all types of messages using different delivery semantics as described in the following sections.\nError Handling The AMQP adapter distinguishes between two types of errors when a message is published using at least once:\n An error caused by the client side, e.g invalid message address, content-type, adapter disabled for tenant etc. An error caused by the server side, e.g no downstream consumers registered, downstream connection loss etc.  For a client side error, the adapter settles the message transfer with the rejected outcome and provides an error description in the corresponding disposition frame. In the case of a server-side error, the adapter settles the message with the released outcome, indicating to the client that the message itself was OK but it cannot be delivered due to a failure beyond the control of the client. In the latter case, a client may attempt to re-send the message unaltered.\nAMQP Command-line Client For purposes of demonstrating the usage of the AMQP adapter, the Hono CLI Module contains an AMQP command-line client for interacting with the AMQP adapter. The client can be used to send telemetry or events and to receive/respond to command request messages.\nThe command-line client supports the following parameters (with default values):\n --spring.profiles.active=amqp-send: Profile for sending telemetry data or events to Hono. --spring.profiles.active=amqp-command: Profile for receiving and responding to command request messages. --message.address: The AMQP 1.0 message address (default: telemetry) --message.payload: The message payload body (default: '{\u0026quot;temp\u0026quot;: 5}') --hono.client.host: The host name that the AMQP adapter is running on (default: localhost) --hono.client.port: The port that the adapter is listening for incoming connections (default: 5672)  To run the client to send a telemetry message to Hono, open a terminal and execute the following:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=sensor1@DEFAULT_TENANT --hono.client.password=hono-secret Accepted{}  The client prints the outcome of the operation to standard out. The outcome above (Accepted) indicates that the request to upload the data has succeeded.\nNB There are two JAR files in the hono/cli/target directory. The JAR to use for the client is the hono-cli-$VERSION-exec.jar and not the hono-cli-$VERSION.jar file. Running the latter will not work and will output the message: no main manifest attribute, in hono-cli-$VERSION.jar\nPublishing Telemetry Data The client indicates the delivery mode to use when uploading telemetry messages by means of the settled and rcv-settle-mode properties of the AMQP transfer frame(s) it uses for uploading the message. The AMQP adapter will accept messages using a delivery mode according to the following table:\n   settled rcv-settle-mode Delivery semantics     false first The adapter will forward the message to the downstream AMQP 1.0 Messaging Network and will forward any AMQP disposition frame received from the AMQP 1.0 Messaging Network to the client as is. It is up to the client\u0026rsquo;s discretion if and how it processes the disposition frame. The adapter will accept any re-delivered message. Sending unsettled messages allows for clients to implement either AT LEAST ONCE or AT MOST ONCE delivery semantics, depending on whether a client actually waits for and considers the disposition frames it receives from the adapter or not. This is the recommended mode for uploading telemetry data.   true first The adapter will acknowledge and settle any received message spontaneously before forwarding it to the downstream AMQP 1.0 Messaging Network. The adapter will ignore any AMQP disposition frames it receives from the AMQP 1.0 Messaging Network. Sending pre-settled messages allows for clients to implement AT MOST ONCE delivery semantics only. This is the fastest mode of delivery but has the drawback of less reliable end-to-end flow control and potential loss of messages without notice.    All other combinations are not supported by the adapter and will result in the message being ignored (pre-settled) or rejected (unsettled).\nPublish Telemetry Data (authenticated Device) The AMQP adapter supports publishing of telemetry data to Hono\u0026rsquo;s Telemetry API. Telemetry messages can be published using either AT LEAST ONCE or AT MOST ONCE delivery semantics.\n Message Address: telemetry or t  This refers to the to property of the message.  Settlement Mode: presettled (AT MOST ONCE) or unsettled (AT LEAST ONCE) Authentication: SASL PLAIN or SASL EXTERNAL Message Body:  (optional) Arbitrary payload  Message properties:  (optional) Arbitrary properties (content-type, correlation-id, \u0026hellip;)  Disposition Frames:  Accepted: Message successfully processed by the adapter. Released: Message cannot be processed and should be redelivered. Rejected: Adapter rejects the message due to one of the following:  (hono:bad-request): Request rejected due to a bad client request. (amqp:unauthorized-access): Request rejected because the adapter is disabled for tenant. (amqp:precondition-failed): Request does not fulfill certain requirements e.g adapter cannot assert device registration etc. (amqp:resource-limit-exceeded): Request rejected because the message limit for the given tenant is exceeded.    When a device publishes data to the telemetry address, the AMQP adapter automatically determines the device\u0026rsquo;s identity and tenant during the authentication process.\nExample\nPublish some JSON data for device 4711:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=sensor1@DEFAULT_TENANT --hono.client.password=hono-secret  Notice that we only supplied a new value for the message address, leaving the other default values.\nPublish some JSON data for device 4711 using a client certificate for authentication:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.port=5671 --hono.client.certPath=config/hono-demo-certs-jar/device-4711-cert.pem --hono.client.keyPath=config/hono-demo-certs-jar/device-4711-key.pem --hono.client.trustStorePath=config/hono-demo-certs-jar/trusted-certs.pem --hono.client.hostnameVerificationRequired=false  Publish Telemetry Data (unauthenticated Device)  Message Address: telemetry/${tenant-id}/${device-id} or t/${tenant-id}/${device-id} Settlement Mode: presettled (AT MOST ONCE) or unsettled (AT LEAST ONCE) Authentication: none Message Body:  (optional) Arbitrary payload  Message properties:  (optional) Arbitrary properties (content-type, correlation-id, \u0026hellip;)  Disposition Frames:  Accepted: Message successfully processed by the adapter. Released: Message cannot be processed and should be redelivered. Rejected: Adapter rejects the message due to:  (hono:bad-request): A bad client request (e.g invalid content-type). (amqp:unauthorized-access): The adapter is disabled for tenant. (amqp:precondition-failed): Request not fulfilling certain requirements. (amqp:resource-limit-exceeded): Request rejected because the message limit for the given tenant is exceeded.    Note how verbose the address is for unauthenticated devices. This address can be used by devices that have not authenticated to the protocol adapter. This requires the HONO_AMQP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false before starting the protocol adapter.\nExamples\nPublish some JSON data for device 4711:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --message.address=t/DEFAULT_TENANT/4711  Publish Telemetry Data (authenticated Gateway) A device that publishes data on behalf of another device is called a gateway device. The message address is used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the message address is used to identify the device that the gateway publishes data for.\nExamples\nA gateway connecting to the adapter using gw@DEFAULT_TENANT as username and gw-secret as password and then publishing some JSON data for device 4711:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=gw@DEFAULT_TENANT --hono.client.password=gw-secret --message.address=t/DEFAULT_TENANT/4711  In this example, we are using message address t/DEFAULT_TENANT/4711 which contains the device that the gateway is publishing the message for.\nPublishing Events The adapter supports AT LEAST ONCE delivery of Event messages only. A client therefore MUST set the settled property to false and the rcv-settle-mode property to first in all transfer frame(s) it uses for uploading events. All other combinations are not supported by the adapter and result in the message being rejected.\nPublish an Event (authenticated Device)  Message Address: event or e Settlement Mode: unsettled (AT LEAST ONCE) Authentication: SASL PLAIN or SASL EXTERNAL Message Body:  (optional) Arbitrary payload  Message properties:  (optional) Arbitrary properties (content-type, correlation-id, \u0026hellip;)  Disposition Frames:  Accepted: Message successfully processed by the adapter. Released: Message cannot be processed and should be redelivered. Rejected: Adapter rejects the message due to:  (hono:bad-request): A bad client request (e.g invalid content-type). (amqp:unauthorized-access): The adapter is disabled for tenant. (amqp:precondition-failed): Request not fulfilling certain requirements. (amqp:resource-limit-exceeded): Request rejected because the message limit for the given tenant is exceeded.    This is the preferred way for devices to publish events. It is available only if the protocol adapter has been configured to require devices to authenticate (which is the default).\nExample\nUpload a JSON string for device 4711:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=sensor1@DEFAULT_TENANT --hono.client.password=hono-secret --message.address=event --message.payload='{\u0026quot;alarm\u0026quot;: 1}'  Publish an Event (unauthenticated Device)  Message Address: event/${tenant-id}/${device-id} or e/${tenant-id}/${device-id} Settlement Mode: unsettled (AT LEAST ONCE) Message Body:  (optional) Arbitrary payload  Message properties:  (optional) Arbitrary properties (content-type, correlation-id, \u0026hellip;)  Disposition Frames:  Accepted: Message successfully processed by the adapter. Released: Message cannot be processed and should be redelivered. Rejected: Adapter rejects the message due to:  (hono:bad-request): A bad client request (e.g invalid content-type). (amqp:unauthorized-access): The adapter is disabled for tenant. (amqp:precondition-failed): Request not fulfilling certain requirements. (amqp:resource-limit-exceeded): Request rejected because the message limit for the given tenant is exceeded.    This address format is used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_AMQP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --message.address=e/DEFAULT_TENANT/4711 --message.payload='{\u0026quot;alarm\u0026quot;: 1}'  Publish an Event (authenticated Gateway) Examples\nA gateway connecting to the adapter using gw@DEFAULT_TENANT as username and gw-secret as password and then publishing some JSON data for device 4711:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=gw@DEFAULT_TENANT --hono.client.password=gw-secret --message.address=e/DEFAULT_TENANT/4711  In this example, we are using message address e/DEFAULT_TENANT/4711 which contains the device that the gateway is publishing the message for.\nCommand \u0026amp; Control The AMQP adapter enables devices to receive commands that have been sent by business applications by means of opening a receiver link using a device specific source address as described below. When a device no longer wants to receive commands anymore, it can simply close the link.\nWhen a device has successfully opened a receiver link for commands, the adapter sends an empty notification on behalf of the device to the downstream AMQP 1.0 Messaging Network with the ttd header set to -1, indicating that the device will be ready to receive commands until further notice. Analogously, the adapter sends an empty notification with the ttd header set to 0 when a device closes the link or disconnects.\nDevices send their responses to commands by means of sending an AMQP message with properties specific to the command that has been executed. The AMQP adapter accepts responses being published using either at most once (QoS 0) or at least once (QoS 1) delivery semantics. The device must send the command response messages using the same (sender) link that it uses for sending telemetry data and events.\nThe AMQP adapter checks the configured message limit before accepting any command requests and responses. In case of incoming command requests from business applications or the command responses from devices, if the message limit is exceeded, the Adapter rejects the message with the reason amqp:resource-limit-exceeded.\nReceiving Commands A device MUST use the following source address in its attach frame to open a link for receiving commands:\n command (authenticated device) command (authenticated gateway receiving commands for all devices it acts on behalf of) command/${tenant}/${device-id} (unauthenticated device) command/${tenant}/${device-id} (authenticated gateway receiving commands for a specific device it acts on behalf of)  The adapter supports AT LEAST ONCE delivery of command messages only. A client therefore MUST use unsettled for the snd-settle-mode and first for the rcv-settle-mode fields of its attach frame during link establishment. All other combinations are not supported and result in the termination of the link.\nOnce the link has been established, the adapter will send command messages having the following properties:\n   Name Mandatory Location Type Description     subject yes properties string Contains the name of the command to be executed.   reply-to no properties string Contains the address to which the command response should be sent. This property will be empty for one-way commands.   correlation-id no properties string This property will be empty for one-way commands, otherwise it will contain the identifier used to correlate the response with the command request.   device_id no application-properties string This property will only be set if an authenticated gateway has connected to the adapter. It will contain the id of the device (connected to the gateway) that the command is targeted at.    Authenticated gateways will receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway. Corresponding devices have to be configured so that they can be used with a gateway. See Configuring Gateway Devices for details.\nA gateway can open a link to receive commands for all devices it acts on behalf of. An authenticated gateway can also open a receiver link for commands targeted at a specific device.\nWhen processing an incoming command message, the protocol adapter will give precedence to a device-specific command consumer matching the command target device, whether it was created by a gateway or by the device itself. If multiple such consumer links have been created, by multiple gateways and/or from the device itself, the gateway or device that last created the consumer link will get the command messages.\nIf no device-specific command consumer exists for a command target device, but one gateway, that may act on behalf of the device, has opened a generic, device-unspecific command consumer link, then the command message is sent to that gateway.\nIf multiple gateways have opened a generic command consumer link, the protocol adapter may have to decide to which gateway a particular command message will be sent to. In case the command target device has already sent a telemetry, event or command response message via a gateway and if that gateway has opened a command consumer link, that gateway will be chosen. Otherwise one gateway that may act on behalf of the command target device and that has opened a command consumer link will be chosen randomly to receive the command message.\nSending a Response to a Command A device only needs to respond to commands that contain a reply-to address and a correlation-id. However, if the application expects a response, then devices must publish a response back to the application. Devices may use the same anonymous sender link for this purpose that they also use for sending telemetry data and events.\nThe adapter supports AT LEAST ONCE delivery of command response messages only. A client therefore MUST set the settled property to true and the rcv-settle-mode property to first in all transfer frame(s) it uses for uploading command responses. All other combinations are not supported by the adapter and result in the message being rejected.\nThe table below provides an overview of the properties that must be set on a command response message:\n   Name Mandatory Location Type Description     to yes properties string MUST contain the value of the reply-to property of the command request message.   correlation-id yes properties string MUST contain the value of the correlation-id property of the command request message.   status yes application-properties integer MUST contain a status code indicating the outcome of processing the command at the device (see Command \u0026amp; Control API for details).    Examples The AMQP adapter client can be used to simulate a device which receives commands and sends responses back to the application. The command line client is used to simulate an application sending commands to devices and receiving command responses from devices.\nStart the AMQP adapter client, as follows:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-command --hono.client.username=sensor1@DEFAULT_TENANT --hono.client.password=hono-secret  After successfully starting the client, a message indicating that the device is ready to receive commands will be printed to standard output. The device is now waiting to receive commands from applications.\nTo send a command to the device, open a new terminal shell and start the command application, as shown below:\n# in directory: hono/cli/ java -jar target/hono-cli-*-exec.jar --hono.client.host=localhost --hono.client.username=consumer@HONO --hono.client.password=verysecret --spring.profiles.active=command,ssl   Note Change into the cli directory before running the command above to start the command application. If you change into the target directory (i.e cli/target), then the client will not be able to locate to certificate needed to connect to the messaging network.  Once the command application starts successfully, enter a command name, payload and content-type of the command to send to the device.\n\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt; Enter name of command for device [DEFAULT_TENANT:4711] (prefix with 'ow:' to send one-way command): setBrightness \u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt; Enter command payload: some-payload \u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt; Enter content type: text/plain  After sending the command, the device (i.e. AMQP command client) will print out the command name and payload that it receives and automatically sends a command response to the application.\nReceived Command Message : [Command name: setBrightness, Command payload: some-payload] Command response sent [outcome: Accepted{}]  Downstream Meta Data The adapter includes the following meta data in the application properties of messages being sent downstream:\n   Name Type Description     device_id string The identifier of the device that the message originates from.   orig_adapter string Contains the adapter\u0026rsquo;s type name which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The AMQP adapter\u0026rsquo;s type name is hono-amqp.   orig_address string Contains the AMQP target address that the device has used to send the data.    The adapter also considers defaults registered for the device at either the tenant or the device level. The values of the default properties are determined as follows:\n If the message already contains a non-empty property of the same name, the value if unchanged. Otherwise, if a default property of the same name is defined in the device\u0026rsquo;s registration information, that value is used. Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.  Note that of the standard AMQP 1.0 message properties only the content-type and ttl can be set this way to a default value.\nEvent Message Time-to-live Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers. In most cases the AMQP Messaging Network can be configured with a maximum time-to-live to apply to the events so that the events will be removed from the persistent store if no consumer has attached to receive the event before the message expires.\nIn order to support environments where the AMQP Messaging Network cannot be configured accordingly, the protocol adapter supports setting a downstream event message\u0026rsquo;s ttl property based on the default ttl and max-ttl values configured for a tenant/device as described in the Tenant API.\nTenant specific Configuration The adapter uses the Tenant API to retrieve tenant specific configuration for adapter type hono-amqp. The following properties are (currently) supported:\n   Name Type Default Value Description     enabled boolean true If set to false the adapter will reject all data from devices belonging to the tenant and respond with a amqp:unauthorized-access as the error condition value for rejecting the message.   "
+	"content": "The AMQP protocol adapter allows clients (devices or gateway components) supporting the AMQP 1.0 protocol to publish messages to Eclipse Hono\u0026trade;\u0026rsquo;s Telemetry, Event and Command \u0026amp; Control endpoints.\nDevice Authentication By default, all Hono protocol adapters require clients (devices or gateway components) to authenticate during connection establishment. This is the preferred way for devices to publish data via protocol adapters. The AMQP adapter supports both the SASL PLAIN and SASL EXTERNAL authentication mechanisms. The former uses a username and password to authenticate to the adapter while the latter uses an X.509 client certificate.\nThis guide provides examples for publishing telemetry and events for authenticated (using SASL PLAIN) and unauthenticated clients.\nNB The AMQP adapter can be configured to allow unauthenticated devices to connect by setting configuration variable HONO_AMQP_AUTHENTICATION_REQUIRED to false.\nSASL PLAIN Authentication The AMQP adapter supports authenticating clients using a username and password. This means that clients need to provide a username and a password when connecting to the AMQP adapter. If the adapter is configured for multi-tenancy (i.e HONO_AMQP_SINGLE_TENANT is set to false), then the username must match the pattern [auth-id@tenant], e.g. sensor1@DEFAULT_TENANT. Otherwise, the tenant-id can be omitted from the username and the client is assumed to belong to the DEFAULT_TENANT.\nThe adapter verifies the credentials provided by the client against the credentials that the configured Credentials service has on record for the client. If the credentials match, the client device can proceed to publish messages to Hono.\nThe examples below refer to devices 4711 and gw-1 of tenant DEFAULT_TENANT using auth-ids sensor1 and gw1 and corresponding passwords. The example deployment as described in the Deployment Guide comes pre-configured with the corresponding entities in its device registry component.\nNB There is a subtle difference between the device identifier (device-id) and the auth-id a device uses for authentication. See Device Identity for a discussion of the concepts.\nSASL EXTERNAL Authentication When a device uses a client certificate for authentication, the TLS handshake is initiated during TCP connection establishment. If no trust anchor is configured for the AMQP adapter, the TLS handshake will succeed only if the certificate has not yet expired. Once the TLS handshake completes and a secure connection is established, the certificate\u0026rsquo;s signature is checked during the SASL handshake. To complete the SASL handshake and authenticate the client, the adapter performs the following steps:\n The adapter extracts the client certificate\u0026rsquo;s Issuer DN from the client certificate The adapter invokes the Tenant service to look up the tenant matching the DN. In order for the lookup to succeed, the tenant’s trust anchor needs to be configured by means of registering the trusted certificate authority. If the lookup succeeds, the tenant returned by the Tenant service is the tenant that the device belongs to. The adapter verifies the device’s client certificate\u0026rsquo;s signature using the trust anchor registered for the tenant. Finally, the adapter authenticates the client certificate using Hono\u0026rsquo;s credentials API. In this step, the adapter uses the client certificate’s Subject DN (as authentication identifier) and x509-cert (for the credentials type) in order to determine the device ID.  NB The AMQP adapter needs to be configured for TLS in order to support this mechanism.\nResource Limit Checks The adapter performs additional checks regarding resource limits when a client tries to connect and/or send a message to the adapter.\nConnection Limits The adapter immediately closes a newly established connection with an amqp:unauthorized-access error if\n the maximum number of connections per protocol adapter instance is reached, or if the maximum number of simultaneously connected devices for the client\u0026rsquo;s tenant is reached.  Please refer to resource-limits for details.\nConnection Duration Limits The adapter immediately closes a newly established connection with an amqp:unauthorized-access error if the connection duration limit that has been configured for the client\u0026rsquo;s tenant is exceeded.\nMessage Limits The adapter\n immediately closes a newly established connection with an amqp:unauthorized-access error and rejects any AMQP 1.0 message containing  telemetry data or an event uploaded by a client a command sent by a north bound application   if the message limit that has been configured for the device\u0026rsquo;s tenant is exceeded.\nConnection Events The adapter can emit Connection Events for client connections being established and/or terminated. Please refer to the common configuration options for details regarding how to enable this behavior.\nThe adapter includes the client\u0026rsquo;s AMQP container-id as the Connection Event\u0026rsquo;s remote-id.\nLink Establishment The AMQP adapter supports the Anonymous Terminus for Message Routing specification and requires clients to create a single sender link using the null target address for publishing all types of messages to the AMQP adapter.\nUsing AT MOST ONCE delivery semantics, the client will not wait for the message to be accepted and settled by the downstream consumer. However, with AT LEAST ONCE, the client sends the message and waits for the message to be delivered to and accepted by the downstream consumer. If the message cannot be delivered due to a failure, the client will be notified.\nThe client indicates its preferred message delivery mode by means of the snd-settle-mode and rcv-settle-mode fields of its attach frame during link establishment. Clients should use mixed as the snd-settle-mode and first as the rcv-settle-mode in order to be able to use the same link for sending all types of messages using different delivery semantics as described in the following sections.\nError Handling The AMQP adapter distinguishes between two types of errors when a message is published using at least once:\n An error caused by the client side, e.g invalid message address, content-type, adapter disabled for tenant etc. An error caused by the server side, e.g no downstream consumers registered, downstream connection loss etc.  For a client side error, the adapter settles the message transfer with the rejected outcome and provides an error description in the corresponding disposition frame. In the case of a server-side error, the adapter settles the message with the released outcome, indicating to the client that the message itself was OK but it cannot be delivered due to a failure beyond the control of the client. In the latter case, a client may attempt to re-send the message unaltered.\nAMQP Command-line Client For purposes of demonstrating the usage of the AMQP adapter, the Hono CLI Module contains an AMQP command-line client for interacting with the AMQP adapter. The client can be used to send telemetry or events and to receive/respond to command request messages.\nThe command-line client supports the following parameters (with default values):\n --spring.profiles.active=amqp-send: Profile for sending telemetry data or events to Hono. --spring.profiles.active=amqp-command: Profile for receiving and responding to command request messages. --message.address: The AMQP 1.0 message address (default: telemetry) --message.payload: The message payload body (default: '{\u0026quot;temp\u0026quot;: 5}') --hono.client.host: The host name that the AMQP adapter is running on (default: localhost) --hono.client.port: The port that the adapter is listening for incoming connections (default: 5672)  To run the client to send a telemetry message to Hono, open a terminal and execute the following:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=sensor1@DEFAULT_TENANT --hono.client.password=hono-secret Accepted{}  The client prints the outcome of the operation to standard out. The outcome above (Accepted) indicates that the request to upload the data has succeeded.\nNB There are two JAR files in the hono/cli/target directory. The JAR to use for the client is the hono-cli-$VERSION-exec.jar and not the hono-cli-$VERSION.jar file. Running the latter will not work and will output the message: no main manifest attribute, in hono-cli-$VERSION.jar\nPublishing Telemetry Data The client indicates the delivery mode to use when uploading telemetry messages by means of the settled and rcv-settle-mode properties of the AMQP transfer frame(s) it uses for uploading the message. The AMQP adapter will accept messages using a delivery mode according to the following table:\n   settled rcv-settle-mode Delivery semantics     false first The adapter will forward the message to the downstream AMQP 1.0 Messaging Network and will forward any AMQP disposition frame received from the AMQP 1.0 Messaging Network to the client as is. It is up to the client\u0026rsquo;s discretion if and how it processes the disposition frame. The adapter will accept any re-delivered message. Sending unsettled messages allows for clients to implement either AT LEAST ONCE or AT MOST ONCE delivery semantics, depending on whether a client actually waits for and considers the disposition frames it receives from the adapter or not. This is the recommended mode for uploading telemetry data.   true first The adapter will acknowledge and settle any received message spontaneously before forwarding it to the downstream AMQP 1.0 Messaging Network. The adapter will ignore any AMQP disposition frames it receives from the AMQP 1.0 Messaging Network. Sending pre-settled messages allows for clients to implement AT MOST ONCE delivery semantics only. This is the fastest mode of delivery but has the drawback of less reliable end-to-end flow control and potential loss of messages without notice.    All other combinations are not supported by the adapter and will result in the message being ignored (pre-settled) or rejected (unsettled).\nPublish Telemetry Data (authenticated Device) The AMQP adapter supports publishing of telemetry data to Hono\u0026rsquo;s Telemetry API. Telemetry messages can be published using either AT LEAST ONCE or AT MOST ONCE delivery semantics.\n Message Address: telemetry or t  This refers to the to property of the message.  Settlement Mode: presettled (AT MOST ONCE) or unsettled (AT LEAST ONCE) Authentication: SASL PLAIN or SASL EXTERNAL Message Body:  (optional) Arbitrary payload  Message properties:  (optional) Arbitrary properties (content-type, correlation-id, \u0026hellip;)  Disposition Frames:  Accepted: Message successfully processed by the adapter. Released: Message cannot be processed and should be redelivered. Rejected: Adapter rejects the message due to one of the following:  (hono:bad-request): Request rejected due to a bad client request. (amqp:unauthorized-access): Request rejected because the adapter is disabled for tenant. (amqp:precondition-failed): Request does not fulfill certain requirements e.g adapter cannot assert device registration etc. (amqp:resource-limit-exceeded): Request rejected because the message limit for the given tenant is exceeded.    When a device publishes data to the telemetry address, the AMQP adapter automatically determines the device\u0026rsquo;s identity and tenant during the authentication process.\nExample\nPublish some JSON data for device 4711:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=sensor1@DEFAULT_TENANT --hono.client.password=hono-secret  Notice that we only supplied a new value for the message address, leaving the other default values.\nPublish some JSON data for device 4711 using a client certificate for authentication:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.port=5671 --hono.client.certPath=config/hono-demo-certs-jar/device-4711-cert.pem --hono.client.keyPath=config/hono-demo-certs-jar/device-4711-key.pem --hono.client.trustStorePath=config/hono-demo-certs-jar/trusted-certs.pem --hono.client.hostnameVerificationRequired=false  Publish Telemetry Data (unauthenticated Device)  Message Address: telemetry/${tenant-id}/${device-id} or t/${tenant-id}/${device-id} Settlement Mode: presettled (AT MOST ONCE) or unsettled (AT LEAST ONCE) Authentication: none Message Body:  (optional) Arbitrary payload  Message properties:  (optional) Arbitrary properties (content-type, correlation-id, \u0026hellip;)  Disposition Frames:  Accepted: Message successfully processed by the adapter. Released: Message cannot be processed and should be redelivered. Rejected: Adapter rejects the message due to:  (hono:bad-request): A bad client request (e.g invalid content-type). (amqp:unauthorized-access): The adapter is disabled for tenant. (amqp:precondition-failed): Request not fulfilling certain requirements. (amqp:resource-limit-exceeded): Request rejected because the message limit for the given tenant is exceeded.    Note how verbose the address is for unauthenticated devices. This address can be used by devices that have not authenticated to the protocol adapter. This requires the HONO_AMQP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false before starting the protocol adapter.\nExamples\nPublish some JSON data for device 4711:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --message.address=t/DEFAULT_TENANT/4711  Publish Telemetry Data (authenticated Gateway) A device that publishes data on behalf of another device is called a gateway device. The message address is used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the message address is used to identify the device that the gateway publishes data for.\nExamples\nA gateway connecting to the adapter using gw@DEFAULT_TENANT as username and gw-secret as password and then publishing some JSON data for device 4711:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=gw@DEFAULT_TENANT --hono.client.password=gw-secret --message.address=t/DEFAULT_TENANT/4711  In this example, we are using message address t/DEFAULT_TENANT/4711 which contains the device that the gateway is publishing the message for.\nPublishing Events The adapter supports AT LEAST ONCE delivery of Event messages only. A client therefore MUST set the settled property to false and the rcv-settle-mode property to first in all transfer frame(s) it uses for uploading events. All other combinations are not supported by the adapter and result in the message being rejected.\nPublish an Event (authenticated Device)  Message Address: event or e Settlement Mode: unsettled (AT LEAST ONCE) Authentication: SASL PLAIN or SASL EXTERNAL Message Body:  (optional) Arbitrary payload  Message properties:  (optional) Arbitrary properties (content-type, correlation-id, \u0026hellip;)  Disposition Frames:  Accepted: Message successfully processed by the adapter. Released: Message cannot be processed and should be redelivered. Rejected: Adapter rejects the message due to:  (hono:bad-request): A bad client request (e.g invalid content-type). (amqp:unauthorized-access): The adapter is disabled for tenant. (amqp:precondition-failed): Request not fulfilling certain requirements. (amqp:resource-limit-exceeded): Request rejected because the message limit for the given tenant is exceeded.    This is the preferred way for devices to publish events. It is available only if the protocol adapter has been configured to require devices to authenticate (which is the default).\nExample\nUpload a JSON string for device 4711:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=sensor1@DEFAULT_TENANT --hono.client.password=hono-secret --message.address=event --message.payload='{\u0026quot;alarm\u0026quot;: 1}'  Publish an Event (unauthenticated Device)  Message Address: event/${tenant-id}/${device-id} or e/${tenant-id}/${device-id} Settlement Mode: unsettled (AT LEAST ONCE) Message Body:  (optional) Arbitrary payload  Message properties:  (optional) Arbitrary properties (content-type, correlation-id, \u0026hellip;)  Disposition Frames:  Accepted: Message successfully processed by the adapter. Released: Message cannot be processed and should be redelivered. Rejected: Adapter rejects the message due to:  (hono:bad-request): A bad client request (e.g invalid content-type). (amqp:unauthorized-access): The adapter is disabled for tenant. (amqp:precondition-failed): Request not fulfilling certain requirements. (amqp:resource-limit-exceeded): Request rejected because the message limit for the given tenant is exceeded.    This address format is used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_AMQP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --message.address=e/DEFAULT_TENANT/4711 --message.payload='{\u0026quot;alarm\u0026quot;: 1}'  Publish an Event (authenticated Gateway) Examples\nA gateway connecting to the adapter using gw@DEFAULT_TENANT as username and gw-secret as password and then publishing some JSON data for device 4711:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-send --hono.client.username=gw@DEFAULT_TENANT --hono.client.password=gw-secret --message.address=e/DEFAULT_TENANT/4711  In this example, we are using message address e/DEFAULT_TENANT/4711 which contains the device that the gateway is publishing the message for.\nCommand \u0026amp; Control The AMQP adapter enables devices to receive commands that have been sent by business applications by means of opening a receiver link using a device specific source address as described below. When a device no longer wants to receive commands anymore, it can simply close the link.\nWhen a device has successfully opened a receiver link for commands, the adapter sends an empty notification on behalf of the device to the downstream AMQP 1.0 Messaging Network with the ttd header set to -1, indicating that the device will be ready to receive commands until further notice. Analogously, the adapter sends an empty notification with the ttd header set to 0 when a device closes the link or disconnects.\nDevices send their responses to commands by means of sending an AMQP message with properties specific to the command that has been executed. The AMQP adapter accepts responses being published using either at most once (QoS 0) or at least once (QoS 1) delivery semantics. The device must send the command response messages using the same (sender) link that it uses for sending telemetry data and events.\nThe AMQP adapter checks the configured message limit before accepting any command requests and responses. In case of incoming command requests from business applications or the command responses from devices, if the message limit is exceeded, the Adapter rejects the message with the reason amqp:resource-limit-exceeded.\nReceiving Commands A device MUST use the following source address in its attach frame to open a link for receiving commands:\n command (authenticated device) command (authenticated gateway receiving commands for all devices it acts on behalf of) command/${tenant}/${device-id} (unauthenticated device) command/${tenant}/${device-id} (authenticated gateway receiving commands for a specific device it acts on behalf of)  The adapter supports AT LEAST ONCE delivery of command messages only. A client therefore MUST use unsettled for the snd-settle-mode and first for the rcv-settle-mode fields of its attach frame during link establishment. All other combinations are not supported and result in the termination of the link.\nOnce the link has been established, the adapter will send command messages having the following properties:\n   Name Mandatory Location Type Description     subject yes properties string Contains the name of the command to be executed.   reply-to no properties string Contains the address to which the command response should be sent. This property will be empty for one-way commands.   correlation-id no properties string This property will be empty for one-way commands, otherwise it will contain the identifier used to correlate the response with the command request.   device_id no application-properties string This property will only be set if an authenticated gateway has connected to the adapter. It will contain the id of the device (connected to the gateway) that the command is targeted at.    Authenticated gateways will receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway. Corresponding devices have to be configured so that they can be used with a gateway. See Configuring Gateway Devices for details.\nA gateway can open a link to receive commands for all devices it acts on behalf of. An authenticated gateway can also open a receiver link for commands targeted at a specific device.\nWhen processing an incoming command message, the protocol adapter will give precedence to a device-specific command consumer matching the command target device, whether it was created by a gateway or by the device itself. If multiple such consumer links have been created, by multiple gateways and/or from the device itself, the gateway or device that last created the consumer link will get the command messages.\nIf no device-specific command consumer exists for a command target device, but one gateway, that may act on behalf of the device, has opened a generic, device-unspecific command consumer link, then the command message is sent to that gateway.\nIf multiple gateways have opened a generic command consumer link, the protocol adapter may have to decide to which gateway a particular command message will be sent to. In case the command target device has already sent a telemetry, event or command response message via a gateway and if that gateway has opened a command consumer link, that gateway will be chosen. Otherwise one gateway that may act on behalf of the command target device and that has opened a command consumer link will be chosen randomly to receive the command message.\nSending a Response to a Command A device only needs to respond to commands that contain a reply-to address and a correlation-id. However, if the application expects a response, then devices must publish a response back to the application. Devices may use the same anonymous sender link for this purpose that they also use for sending telemetry data and events.\nThe adapter supports AT LEAST ONCE delivery of command response messages only. A client therefore MUST set the settled property to true and the rcv-settle-mode property to first in all transfer frame(s) it uses for uploading command responses. All other combinations are not supported by the adapter and result in the message being rejected.\nThe table below provides an overview of the properties that must be set on a command response message:\n   Name Mandatory Location Type Description     to yes properties string MUST contain the value of the reply-to property of the command request message.   correlation-id yes properties string MUST contain the value of the correlation-id property of the command request message.   status yes application-properties integer MUST contain a status code indicating the outcome of processing the command at the device (see Command \u0026amp; Control API for details).    Examples The AMQP adapter client can be used to simulate a device which receives commands and sends responses back to the application. The command line client is used to simulate an application sending commands to devices and receiving command responses from devices.\nStart the AMQP adapter client, as follows:\n# in directory: hono/cli/target/ java -jar hono-cli-*-exec.jar --spring.profiles.active=amqp-command --hono.client.username=sensor1@DEFAULT_TENANT --hono.client.password=hono-secret  After successfully starting the client, a message indicating that the device is ready to receive commands will be printed to standard output. The device is now waiting to receive commands from applications.\nTo send a command to the device, open a new terminal shell and start the command application, as shown below:\n# in directory: hono/cli/ java -jar target/hono-cli-*-exec.jar --hono.client.host=localhost --hono.client.username=consumer@HONO --hono.client.password=verysecret --spring.profiles.active=command,ssl   Note Change into the cli directory before running the command above to start the command application. If you change into the target directory (i.e cli/target), then the client will not be able to locate to certificate needed to connect to the messaging network.  Once the command application starts successfully, enter a command name, payload and content-type of the command to send to the device.\n\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt; Enter name of command for device [DEFAULT_TENANT:4711] (prefix with 'ow:' to send one-way command): setBrightness \u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt; Enter command payload: some-payload \u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt;\u0026gt; Enter content type: text/plain  After sending the command, the device (i.e. AMQP command client) will print out the command name and payload that it receives and automatically sends a command response to the application.\nReceived Command Message : [Command name: setBrightness, Command payload: some-payload] Command response sent [outcome: Accepted{}]  Downstream Meta Data The adapter includes the following meta data in the application properties of messages being sent downstream:\n   Name Type Description     device_id string The identifier of the device that the message originates from.   orig_adapter string Contains the adapter\u0026rsquo;s type name which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The AMQP adapter\u0026rsquo;s type name is hono-amqp.   orig_address string Contains the AMQP target address that the device has used to send the data.    The adapter also considers defaults registered for the device at either the tenant or the device level. The values of the default properties are determined as follows:\n If the message already contains a non-empty property of the same name, the value if unchanged. Otherwise, if a default property of the same name is defined in the device\u0026rsquo;s registration information, that value is used. Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.  Note that of the standard AMQP 1.0 message properties only the content-type and ttl can be set this way to a default value.\nEvent Message Time-to-live Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers. In most cases the AMQP Messaging Network can be configured with a maximum time-to-live to apply to the events so that the events will be removed from the persistent store if no consumer has attached to receive the event before the message expires.\nIn order to support environments where the AMQP Messaging Network cannot be configured accordingly, the protocol adapter supports setting a downstream event message\u0026rsquo;s ttl property based on the default ttl and max-ttl values configured for a tenant/device as described in the Tenant API.\nTenant specific Configuration The adapter uses the Tenant API to retrieve tenant specific configuration for adapter type hono-amqp. The following properties are (currently) supported:\n   Name Type Default Value Description     enabled boolean true If set to false the adapter will reject all data from devices belonging to the tenant and respond with a amqp:unauthorized-access as the error condition value for rejecting the message.   "
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/user-guide/coap-adapter/",
 	"title": "CoAP Adapter",
 	"tags": [],
 	"description": "",
-	"content": "The CoAP protocol adapter exposes CoAP based endpoints for Eclipse Hono\u0026trade;\u0026rsquo;s south bound Telemetry, Event and Command \u0026amp; Control APIs.\n Experimental The CoAP adapter has not yet reached the level of maturity of the other standard adapters. In particular, the resources implemented by the adapter might still be subject to change.  Device Authentication The CoAP adapter by default requires clients (devices or gateway components) to authenticate during connection establishment. The adapter (currently) only supports PSK as part of a DTLS handshake for that purpose. Additional variants mentioned in Securing CoAP might be added in the future.\nThe adapter tries to authenticate the device using these mechanisms in the following order\nPSK The identity provided in the ClientKeyExchange must have the form auth-id@tenant, e.g. sensor1@DEFAULT_TENANT. The adapter performs the handshake using the credentials the configured Credentials service has on record for the client. The adapter uses the Credentials API\u0026rsquo;s get operation to retrieve the credentials on record with the tenant and auth-id provided by the device in the identity and psk as the type of secret as query parameters.\nThe examples below refer to devices 4711 and gw-1 of tenant DEFAULT_TENANT using auth-ids sensor1 and gw1 and corresponding secrets. The example deployment as described in the Deployment Guides comes pre-configured with the corresponding entities in its device registry component. Please refer to the Credentials API for details regarding the different types of secrets.\nNB There is a subtle difference between the device identifier (device-id) and the auth-id a device uses for authentication. See Device Identity for a discussion of the concepts.\nMessage Limits Before accepting any telemetry or event or command messages, the CoAP adapter verifies that the configured message limit is not exceeded. For CoAP currently only the messages limit is verified, the connections limit is not available. If the limit is exceeded then the incoming message is discarded with the status code 429 Too Many Requests.\nCoAP Content Format Codes CoAP doesn\u0026rsquo;t use a textual identifier for content types. Instead numbers are used, which are maintained by the IANA. The IANA - CoAP Content Formats page lists all (currently) registered codes and the corresponding media types.\nPublish Telemetry Data (authenticated Device) The device is authenticated using PSK.\n URI: /telemetry Method: POST Type:  CON: at least once delivery semantics NON: at most once delivery semantics  Request Options:  (optional) content-format: The type of payload contained in the request body. Required, if request contains payload.  Query Parameters:  (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) empty: Marks the request as an empty notification.  Request Body:  (optional) Arbitrary payload encoded according to the given content type. Maybe empty, if URI-query: empty is provided.  Response Options:  (optional) content-format: A media type describing the semantics and format of payload contained in the response body. This option will only be present if the response contains a command to be executed by the device which requires input data. Note that this option will be empty if the media type contained in the command (AMQP) message\u0026rsquo;s content-type property cannot be mapped to one of the registered CoAP content-format codes. (optional) location-query: The hono-command query parameter contains the name of the command to execute. This option will only be present if the response contains a command to be executed by the device. (optional) location-path: The location path is command for one-way-commands and command_response/\u0026lt;command-request-id\u0026gt; for commands expecting a response. In the latter case, the location-path option contains exactly the URI-path that the device must use when sending its response to the command. This option will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device. (optional) Error details, if status code is \u0026gt;= 4.00.  Response Codes:  2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for the device to execute. Note that if the message type is NON (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer (yet). However, if the message type is CON (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 4.00 (Bad Request): The request cannot be processed. Possible reasons include:  the request body is empty and the URI-query option doesn\u0026rsquo;t contain the empty parameter  4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This is the preferred way for devices to publish telemetry data. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).\nExamples\nThe examples provided below make use of the coap-client command line tool which is part of the libcoap project. Precompiled packages should be available for different Linux variants.\nPublish some JSON data for device 4711 using default message type CON (at least once):\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret -m POST coaps://hono.eclipseprojects.io/telemetry -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'   Note coap-client only reports error response-codes, so the expected 2.04 response code will not be printed to the terminal.  Publish some JSON data for device 4711 using message type NON (at most once):\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret -N -m POST coaps://hono.eclipseprojects.io/telemetry -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4711, indicating that the device will wait for 10 seconds to receive the response:\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret -m POST coaps://hono.eclipseprojects.io/telemetry?hono-ttd=10 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}' { \u0026quot;brightness\u0026quot;: 87 }   Note In the example above the response actually contains payload that should be used as input to a command to be executed by the device. This is just for illustrative purposes. You will usually get an empty response because there is no downstream application attached which could send any commands to the device.  Publish Telemetry Data (unauthenticated Device)  URI: /telemetry/${tenantId}/${deviceId} Method: PUT Type:  CON: at least once delivery semantics NON: at most once delivery semantics  Request Options:  (optional) content-format: The type of payload contained in the request body. Required, if request contains payload.  Query Parameters:  (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) empty: Marks the request as an empty notification.  Request Body:  (optional) Arbitrary payload encoded according to the given content type. Maybe empty, if URI-query: empty is provided.  Response Options:  (optional) content-format: A media type describing the semantics and format of payload contained in the response body. This option will only be present if the response contains a command to be executed by the device which requires input data. Note that this option will be empty if the media type contained in the command (AMQP) message\u0026rsquo;s content-type property cannot be mapped to one of the registered CoAP content-format codes. (optional) location-query: The hono-command query parameter contains the name of the command to execute. This option will only be present if the response contains a command to be executed by the device. (optional) location-path: The location path is command for one-way-commands and command_response/\u0026lt;command-request-id\u0026gt; for commands expecting a response. In the latter case, the location-path option contains exactly the URI-path that the device must use when sending its response to the command. This option will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content). (optional) Error details, if status code is \u0026gt;= 4.00.  Response Codes:  2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for the device to execute. Note that if the message type is NON (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer (yet). However, if the message type is CON (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 4.00 (Bad Request): The request cannot be processed. Possible reasons include:  the request body is empty and the URI-query option doesn\u0026rsquo;t contain the empty parameter  4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_COAP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711 using default message type CON (at least once):\ncoap-client -m PUT coap://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4711 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4711 using message type NON (at most once):\ncoap-client -N -m PUT coap://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4711 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4711, indicating that the device will wait for 10 seconds to receive the response:\ncoap-client -m PUT coap://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4711?hono-ttd=10 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}' { \u0026quot;brightness\u0026quot;: 87 }  Publish Telemetry Data (authenticated Gateway)  URI: /telemetry/${tenantId}/${deviceId} Method: PUT Type:  CON: at least once delivery semantics NON: at most once delivery semantics  Request Options:  (optional) content-format: The type of payload contained in the request body. Required, if request contains payload.  Query Parameters:  (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) empty: Marks the request as an empty notification.  Request Body:  (optional) Arbitrary payload encoded according to the given content type. Maybe empty, if URI-query: empty is provided.  Response Options:  (optional) content-format: A media type describing the semantics and format of payload contained in the response body. This option will only be present if the response contains a command to be executed by the device which requires input data. Note that this option will be empty if the media type contained in the command (AMQP) message\u0026rsquo;s content-type property cannot be mapped to one of the registered CoAP content-format codes. (optional) location-query: The hono-command query parameter contains the name of the command to execute. This option will only be present if the response contains a command to be executed by the device. (optional) location-path: The location path is command/${tenantId}/${deviceId} for one-way-commands and command_response/${tenantId}/${deviceId}/\u0026lt;command-request-id\u0026gt; for commands expecting a response. In the latter case, the location-path option contains exactly the URI-path that the device must use when sending its response to the command. Note that in both cases the ${tenantId}/${deviceId} path segments indicate the device that the command is targeted at. This option will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content). (optional) Error details, if status code is \u0026gt;= 4.00.  Response Codes:  2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for a device to execute. Note that if the message type is NON (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer (yet). However, if the message type is CON (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 4.00 (Bad Request): The request cannot be processed. Possible reasons include:  the request body is empty and the URI-query option doesn\u0026rsquo;t contain the empty parameter  4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The tenant that the gateway belongs to is not allowed to use this protocol adapter. The device belongs to another tenant than the gateway. The gateway is not authorized to act on behalf of the device. The gateway associated with the device is not registered or disabled.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This resource can be used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nPublish some JSON data for device 4712 using default message type CON (at least once):\ncoap-client -u gw@DEFAULT_TENANT -k gw-secret -m PUT coaps://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4712 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4712 using message type NON (at most once):\ncoap-client -u gw@DEFAULT_TENANT -k gw-secret -N -m PUT coaps://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4712 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4712, indicating that the gateway will wait for 10 seconds to receive the response:\ncoap-client -u gw@DEFAULT_TENANT -k gw-secret -m PUT coaps://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4712?hono-ttd=10 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}' { \u0026quot;brightness\u0026quot;: 87 }  NB The examples above assume that a gateway device has been registered with psk credentials with auth-id gw and secret gw-secret which is authorized to publish data on behalf of device 4712.\nPublish an Event (authenticated Device) The device is authenticated using PSK.\n URI: /event Method: POST Type:CON Request Options:  (optional) content-format: The type of payload contained in the request body. Required, if request contains payload.  Query Parameters:  (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) empty: Marks the request as an empty notification.  Request Body:  (optional) Arbitrary payload encoded according to the given content type. Maybe empty, if URI-query: empty is provided.  Response Options:  (optional) content-format: A media type describing the semantics and format of payload contained in the response body. This option will only be present if the response contains a command to be executed by the device which requires input data. Note that this option will be empty if the media type contained in the command (AMQP) message\u0026rsquo;s content-type property cannot be mapped to one of the registered CoAP content-format codes. (optional) location-query: The hono-command query parameter contains the name of the command to execute. This option will only be present if the response contains a command to be executed by the device. (optional) location-path: The location path is command for one-way-commands and command_response/\u0026lt;command-request-id\u0026gt; for commands expecting a response. In the latter case, the location-path option contains exactly the URI-path that the device must use when sending its response to the command. This option will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content). (optional) Error details, if status code is \u0026gt;= 4.00.  Response Codes:  2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for the device to execute. Note that if the message type is NON (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer (yet). However, if the message type is CON (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 4.00 (Bad Request): The request cannot be processed. Possible reasons include:  the request body is empty and the URI-query option doesn\u0026rsquo;t contain the empty parameter  4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This is the preferred way for devices to publish events. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).\nExamples\nThe examples provided below make use of the coap-client command line tool which is part of the libcoap project. Precompiled packages should be available for different Linux variants.\nPublish some JSON data for device 4711 using default message type CON (at least once):\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret -m POST coaps://hono.eclipseprojects.io/event -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'   Note coap-client only reports error response-codes, so the expected 2.04 response code will not be printed to the terminal.  Publish some JSON data for device 4711, indicating that the device will wait for 10 seconds to receive the response:\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret -m POST coaps://hono.eclipseprojects.io/event?hono-ttd=10 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}' { \u0026quot;brightness\u0026quot;: 87 }   Note In the example above the response actually contains payload that should be used as input to a command to be executed by the device. This is just for illustrative purposes. You will usually get an empty response because there is no downstream application attached which could send any commands to the device.  Publish an Event (unauthenticated Device)  URI: /event/${tenantId}/${deviceId} Method: PUT Type:CON Request Options:  (optional) content-format: The type of payload contained in the request body. Required, if request contains payload.  Query Parameters:  (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) empty: Marks the request as an empty notification.  Request Body:  (optional) Arbitrary payload encoded according to the given content type. Maybe empty, if URI-query: empty is provided.  Response Options:  (optional) content-format: A media type describing the semantics and format of payload contained in the response body. This option will only be present if the response contains a command to be executed by the device which requires input data. Note that this option will be empty if the media type contained in the command (AMQP) message\u0026rsquo;s content-type property cannot be mapped to one of the registered CoAP content-format codes. (optional) location-query: The hono-command query parameter contains the name of the command to execute. This option will only be present if the response contains a command to be executed by the device. (optional) location-path: The location path is command for one-way-commands and command_response/\u0026lt;command-request-id\u0026gt; for commands expecting a response. In the latter case, the location-path option contains exactly the URI-path that the device must use when sending its response to the command. This option will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content). (optional) Error details, if status code is \u0026gt;= 4.00.  Response Codes:  2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for the device to execute. Note that if the message type is NON (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer (yet). However, if the message type is CON (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 4.00 (Bad Request): The request cannot be processed. Possible reasons include:  the request body is empty and the URI-query option doesn\u0026rsquo;t contain the empty parameter  4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_COAP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711 using default message type CON (at least once):\ncoap-client -m PUT coap://hono.eclipseprojects.io/event/DEFAULT_TENANT/4711 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4711, indicating that the device will wait for 10 seconds to receive the response:\ncoap-client -m PUT coap://hono.eclipseprojects.io/event/DEFAULT_TENANT/4711?hono-ttd=10 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}' { \u0026quot;brightness\u0026quot;: 87 }  Publish an Event (authenticated Gateway)  URI: /event/${tenantId}/${deviceId} Method: PUT Type:CON Request Options:  (optional) content-format: The type of payload contained in the request body. Required, if request contains payload.  Query Parameters:  (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) empty: Marks the request as an empty notification.  Request Body:  (optional) Arbitrary payload encoded according to the given content type. Maybe empty, if URI-query: empty is provided.  Response Options:  (optional) content-format: A media type describing the semantics and format of payload contained in the response body. This option will only be present if the response contains a command to be executed by the device which requires input data. Note that this option will be empty if the media type contained in the command (AMQP) message\u0026rsquo;s content-type property cannot be mapped to one of the registered CoAP content-format codes. (optional) location-query: The hono-command query parameter contains the name of the command to execute. This option will only be present if the response contains a command to be executed by the device. (optional) location-path: The location path is command/${tenantId}/${deviceId} for one-way-commands and command_response/${tenantId}/${deviceId}/\u0026lt;command-request-id\u0026gt; for commands expecting a response. In the latter case, the location-path option contains exactly the URI-path that the device must use when sending its response to the command. Note that in both cases the ${tenantId}/${deviceId} path segments indicate the device that the command is targeted at. This option will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content). (optional) Error details, if status code is \u0026gt;= 4.00.  Response Codes:  2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for a device to execute. Note that if the message type is NON (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer (yet). However, if the message type is CON (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 4.00 (Bad Request): The request cannot be processed. Possible reasons include:  the request body is empty and the URI-query option doesn\u0026rsquo;t contain the empty parameter  4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The tenant that the gateway belongs to is not allowed to use this protocol adapter. The device belongs to another tenant than the gateway. The gateway is not authorized to act on behalf of the device. The gateway associated with the device is not registered or disabled.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This resource can be used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nPublish some JSON data for device 4712 using default message type CON (at least once):\ncoap-client -u gw@DEFAULT_TENANT -k gw-secret -m PUT coaps://hono.eclipseprojects.io/event/DEFAULT_TENANT/4712 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4712, indicating that the gateway will wait for 10 seconds to receive the response:\ncoap-client -u gw@DEFAULT_TENANT -k gw-secret -m PUT coaps://hono.eclipseprojects.io/event/DEFAULT_TENANT/4712?hono-ttd=10 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}' { \u0026quot;brightness\u0026quot;: 87 }  NB The examples above assume that a gateway device has been registered with psk credentials with auth-id gw and secret gw-secret which is authorized to publish data on behalf of device 4712.\nCommand \u0026amp; Control The CoAP adapter enables devices to receive commands that have been sent by business applications. Commands are delivered to the device by means of a response message. That means a device first has to send a request, indicating how long it will wait for the response. That request can either be a telemetry or event message, with a hono-ttd query parameter (ttd for time till disconnect) specifying the number of seconds the device will wait for the response. The business application can react on that message by sending a command message, targeted at the device. The CoAP adapter will then send the command message as part of the response message to the device.\nCommands handled by gateways Authenticated gateways will receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway. Corresponding devices have to be configured so that they can be used with a gateway. See Configuring Gateway Devices for details.\nA gateway can send a request with the hono-ttd query parameter on the /event or /telemetry URI, indicating its readiness to receive a command for any device it acts on behalf of. Note that in this case, the business application will be notified with the gateway id in the device_id property of the downstream message.\nAn authenticated gateway can also indicate its readiness to receive a command targeted at a specific device. For that, the /event/${tenantId}/${deviceId} or /telemetry/${tenantId}/${deviceId} URI is to be used, containing the id of the device to receive a command for. The business application will receive a notification with that device id.\nIf there are multiple concurrent requests with a hono-ttd query parameter, sent by the command target device and/or one or more of its potential gateways, the CoAP adapter will choose the device or gateway to send the command to as follows:\n A request done by the command target device or by a gateway specifically done for that device, has precedence. If there are multiple, concurrent such requests, the last one will get the command message (if received) in its response. Note that the other requests won\u0026rsquo;t be answered with a command message in their response event if the business application sent multiple command messages. That means commands for a single device can only be requested sequentially, not in parallel. If the above doesn\u0026rsquo;t apply, a single hono-ttd request on the /event or /telemetry URI, sent by a gateway that the command target device is configured for, will get the command message in its response. If there are multiple, concurrent such requests by different gateways, all configured for the command target device, the request by the gateway will be chosen, through which the target device has last sent a telemetry or event message. If the target device hasn\u0026rsquo;t sent a message yet and it is thereby unknown via which gateway the device communicates, then one of the requests will be chosen randomly to set the command in its response.  Sending a Response to a Command (authenticated Device) The device is authenticated using PSK.\n URI: /command_response/${commandRequestId} Method: POST Type: CON Request Options:  (optional) content-type: A media type describing the semantics and format of the payload contained in the request body. This option must be set if the result of processing the command on the device is non-empty. In this case the result data is contained in the request body.  Query Parameters:  (required) hono-cmd-status: An HTTP status code indicating the outcome of processing the command.  Request Body:  (optional) Arbitrary data representing the result of processing the command on the device.  Response Codes:  2.04 (Changed): The response has been successfully delivered to the application that has sent the command. 4.00 (Bad Request): The request cannot be processed because the command status or command request ID are missing/malformed. 4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed. Possible reasons for this include:  There is no application listening for a reply to the given commandRequestId. The application has already given up on waiting for a response.    This is the preferred way for devices to respond to commands. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).\nExample\nSend a response to a previously received command with the command-request-id req-id-uuid for device 4711:\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret coaps://hono.eclipseprojects.io/command_response/req-id-uuid?hono-cmd-status=200  Sending a Response to a Command (unauthenticated Device)  URI: /command_response/${tenantId}/${deviceId}/${commandRequestId} Method: PUT Type: CON Request Options:  (optional) content-type: A media type describing the semantics and format of the payload contained in the request body. This option must be set if the result of processing the command on the device is non-empty. In this case the result data is contained in the request body.  Query Parameters:  (required) hono-cmd-status: An HTTP status code indicating the outcome of processing the command.  Request Body:  (optional) Arbitrary data representing the result of processing the command on the device.  Response Codes:  2.04 (Changed): The response has been successfully delivered to the application that has sent the command. 4.00 (Bad Request): The request cannot be processed because the command status or command request ID are missing/malformed. 4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed. Possible reasons for this include:  There is no application listening for a reply to the given commandRequestId. The application has already given up on waiting for a response.    This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_HTTP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nSend a response to a previously received command with the command-request-id req-id-uuid for the unauthenticated device 4711:\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret coaps://hono.eclipseprojects.io/command_response/DEFAULT_TENANT/4711/req-id-uuid?hono-cmd-status=200 -e '{\u0026quot;brightness-changed\u0026quot;: true}'  Sending a Response to a Command (authenticated Gateway)  URI: /command_response/${tenantId}/${deviceId}/${commandRequestId} Method: PUT Type: CON Request Options:  (optional) content-type: A media type describing the semantics and format of the payload contained in the request body. This option must be set if the result of processing the command on the device is non-empty. In this case the result data is contained in the request body.  Query Parameters:  (required) hono-cmd-status: An HTTP status code indicating the outcome of processing the command.  Request Body:  (optional) Arbitrary data representing the result of processing the command on the device.  Response Codes:  2.04 (Changed): The response has been successfully delivered to the application that has sent the command. 4.00 (Bad Request): The request cannot be processed because the command status or command request ID are missing/malformed. 4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant. The gateway is not authorized to act on behalf of the device. The gateway associated with the device is not registered or disabled.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed. Possible reasons for this include:  There is no application listening for a reply to the given commandRequestId. The application has already given up on waiting for a response.    This resource can be used by gateway components to send the response to a command on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to send responses to a command on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nSend a response to a previously received command with the command-request-id req-id-uuid for device 4712:\ncoap-client -u gw@DEFAULT_TENANT -k gw-secret coaps://hono.eclipseprojects.io/command_response/DEFAULT_TENANT/4712/req-id-uuid?hono-cmd-status=200 -e '{\u0026quot;brightness-changed\u0026quot;: true}'  NB The example above assumes that a gateway device has been registered with psk credentials with auth-id gw and secret gw-secret which is authorized to publish data on behalf of device 4712.\nDownstream Meta Data The adapter includes the following meta data in the application properties of messages being sent downstream:\n   Name Type Description     device_id string The identifier of the device that the message originates from.   orig_adapter string Contains the adapter\u0026rsquo;s type name which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The CoAP adapter\u0026rsquo;s type name is hono-coap.   orig_address string Contains the (relative) URI that the device has originally posted the data to.   ttd integer Contains the effective number of seconds that the device will wait for a response. This property is only set if the request contains the hono-ttd URI-query option.    The adapter also considers defaults registered for the device at either the tenant or the device level. The values of the default properties are determined as follows:\n If the message already contains a non-empty property of the same name, the value if unchanged. Otherwise, if a default property of the same name is defined in the device\u0026rsquo;s registration information, that value is used. Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.  Note that of the standard AMQP 1.0 message properties only the content-type and ttl can be set this way to a default value.\nEvent Message Time-to-live Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers. In most cases the AMQP Messaging Network can be configured with a maximum time-to-live to apply to the events so that the events will be removed from the persistent store if no consumer has attached to receive the event before the message expires.\nIn order to support environments where the AMQP Messaging Network cannot be configured accordingly, the protocol adapter supports setting a downstream event message\u0026rsquo;s ttl property based on the hono-ttl property set as a query parameter in the event requests by the devices. Also the default ttl and max-ttl values can be configured for a tenant/device as described in the Tenant API.\nTenant specific Configuration The adapter uses the Tenant API to retrieve tenant specific configuration for adapter type hono-coap. The following properties are (currently) supported:\n   Name Type Default Value Description     enabled boolean true If set to false the adapter will reject all data from devices belonging to the tenant.   max-ttd integer 60 Defines a tenant specific upper limit for the time until disconnect property that devices may include in requests for uploading telemetry data or events. Please refer to the Command \u0026amp; Control concept page for a discussion of this parameter\u0026rsquo;s purpose and usage.\nThis property can be set for the hono-coap adapter type as an extension property in the adapter section of the tenant configuration.\nIf it is not set, then the default value of 60 seconds is used.   "
+	"content": "The CoAP protocol adapter exposes CoAP based endpoints for Eclipse Hono\u0026trade;\u0026rsquo;s south bound Telemetry, Event and Command \u0026amp; Control APIs.\n Experimental The CoAP adapter has not yet reached the level of maturity of the other standard adapters. In particular, the resources implemented by the adapter might still be subject to change.  Device Authentication The CoAP adapter by default requires clients (devices or gateway components) to authenticate during connection establishment. The adapter (currently) only supports PSK as part of a DTLS handshake for that purpose. Additional variants mentioned in Securing CoAP might be added in the future.\nThe adapter tries to authenticate the device using these mechanisms in the following order\nPSK The identity provided in the ClientKeyExchange must have the form auth-id@tenant, e.g. sensor1@DEFAULT_TENANT. The adapter performs the handshake using the credentials the configured Credentials service has on record for the client. The adapter uses the Credentials API\u0026rsquo;s get operation to retrieve the credentials on record with the tenant and auth-id provided by the device in the identity and psk as the type of secret as query parameters.\nThe examples below refer to devices 4711 and gw-1 of tenant DEFAULT_TENANT using auth-ids sensor1 and gw1 and corresponding secrets. The example deployment as described in the Deployment Guides comes pre-configured with the corresponding entities in its device registry component. Please refer to the Credentials API for details regarding the different types of secrets.\nNB There is a subtle difference between the device identifier (device-id) and the auth-id a device uses for authentication. See Device Identity for a discussion of the concepts.\nMessage Limits The adapter rejects\n a client\u0026rsquo;s request to upload data with status code 429 Too Many Requests and any AMQP 1.0 message containing a command sent by a north bound application  if the message limit that has been configured for the device\u0026rsquo;s tenant is exceeded.\nCoAP Content Format Codes CoAP doesn\u0026rsquo;t use a textual identifier for content types. Instead numbers are used, which are maintained by the IANA. The IANA - CoAP Content Formats page lists all (currently) registered codes and the corresponding media types.\nPublish Telemetry Data (authenticated Device) The device is authenticated using PSK.\n URI: /telemetry Method: POST Type:  CON: at least once delivery semantics NON: at most once delivery semantics  Request Options:  (optional) content-format: The type of payload contained in the request body. Required, if request contains payload.  Query Parameters:  (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) empty: Marks the request as an empty notification.  Request Body:  (optional) Arbitrary payload encoded according to the given content type. Maybe empty, if URI-query: empty is provided.  Response Options:  (optional) content-format: A media type describing the semantics and format of payload contained in the response body. This option will only be present if the response contains a command to be executed by the device which requires input data. Note that this option will be empty if the media type contained in the command (AMQP) message\u0026rsquo;s content-type property cannot be mapped to one of the registered CoAP content-format codes. (optional) location-query: The hono-command query parameter contains the name of the command to execute. This option will only be present if the response contains a command to be executed by the device. (optional) location-path: The location path is command for one-way-commands and command_response/\u0026lt;command-request-id\u0026gt; for commands expecting a response. In the latter case, the location-path option contains exactly the URI-path that the device must use when sending its response to the command. This option will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device. (optional) Error details, if status code is \u0026gt;= 4.00.  Response Codes:  2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for the device to execute. Note that if the message type is NON (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer (yet). However, if the message type is CON (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 4.00 (Bad Request): The request cannot be processed. Possible reasons include:  the request body is empty and the URI-query option doesn\u0026rsquo;t contain the empty parameter  4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This is the preferred way for devices to publish telemetry data. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).\nExamples\nThe examples provided below make use of the coap-client command line tool which is part of the libcoap project. Precompiled packages should be available for different Linux variants.\nPublish some JSON data for device 4711 using default message type CON (at least once):\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret -m POST coaps://hono.eclipseprojects.io/telemetry -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'   Note coap-client only reports error response-codes, so the expected 2.04 response code will not be printed to the terminal.  Publish some JSON data for device 4711 using message type NON (at most once):\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret -N -m POST coaps://hono.eclipseprojects.io/telemetry -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4711, indicating that the device will wait for 10 seconds to receive the response:\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret -m POST coaps://hono.eclipseprojects.io/telemetry?hono-ttd=10 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}' { \u0026quot;brightness\u0026quot;: 87 }   Note In the example above the response actually contains payload that should be used as input to a command to be executed by the device. This is just for illustrative purposes. You will usually get an empty response because there is no downstream application attached which could send any commands to the device.  Publish Telemetry Data (unauthenticated Device)  URI: /telemetry/${tenantId}/${deviceId} Method: PUT Type:  CON: at least once delivery semantics NON: at most once delivery semantics  Request Options:  (optional) content-format: The type of payload contained in the request body. Required, if request contains payload.  Query Parameters:  (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) empty: Marks the request as an empty notification.  Request Body:  (optional) Arbitrary payload encoded according to the given content type. Maybe empty, if URI-query: empty is provided.  Response Options:  (optional) content-format: A media type describing the semantics and format of payload contained in the response body. This option will only be present if the response contains a command to be executed by the device which requires input data. Note that this option will be empty if the media type contained in the command (AMQP) message\u0026rsquo;s content-type property cannot be mapped to one of the registered CoAP content-format codes. (optional) location-query: The hono-command query parameter contains the name of the command to execute. This option will only be present if the response contains a command to be executed by the device. (optional) location-path: The location path is command for one-way-commands and command_response/\u0026lt;command-request-id\u0026gt; for commands expecting a response. In the latter case, the location-path option contains exactly the URI-path that the device must use when sending its response to the command. This option will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content). (optional) Error details, if status code is \u0026gt;= 4.00.  Response Codes:  2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for the device to execute. Note that if the message type is NON (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer (yet). However, if the message type is CON (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 4.00 (Bad Request): The request cannot be processed. Possible reasons include:  the request body is empty and the URI-query option doesn\u0026rsquo;t contain the empty parameter  4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_COAP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711 using default message type CON (at least once):\ncoap-client -m PUT coap://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4711 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4711 using message type NON (at most once):\ncoap-client -N -m PUT coap://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4711 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4711, indicating that the device will wait for 10 seconds to receive the response:\ncoap-client -m PUT coap://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4711?hono-ttd=10 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}' { \u0026quot;brightness\u0026quot;: 87 }  Publish Telemetry Data (authenticated Gateway)  URI: /telemetry/${tenantId}/${deviceId} Method: PUT Type:  CON: at least once delivery semantics NON: at most once delivery semantics  Request Options:  (optional) content-format: The type of payload contained in the request body. Required, if request contains payload.  Query Parameters:  (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) empty: Marks the request as an empty notification.  Request Body:  (optional) Arbitrary payload encoded according to the given content type. Maybe empty, if URI-query: empty is provided.  Response Options:  (optional) content-format: A media type describing the semantics and format of payload contained in the response body. This option will only be present if the response contains a command to be executed by the device which requires input data. Note that this option will be empty if the media type contained in the command (AMQP) message\u0026rsquo;s content-type property cannot be mapped to one of the registered CoAP content-format codes. (optional) location-query: The hono-command query parameter contains the name of the command to execute. This option will only be present if the response contains a command to be executed by the device. (optional) location-path: The location path is command/${tenantId}/${deviceId} for one-way-commands and command_response/${tenantId}/${deviceId}/\u0026lt;command-request-id\u0026gt; for commands expecting a response. In the latter case, the location-path option contains exactly the URI-path that the device must use when sending its response to the command. Note that in both cases the ${tenantId}/${deviceId} path segments indicate the device that the command is targeted at. This option will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content). (optional) Error details, if status code is \u0026gt;= 4.00.  Response Codes:  2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for a device to execute. Note that if the message type is NON (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer (yet). However, if the message type is CON (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 4.00 (Bad Request): The request cannot be processed. Possible reasons include:  the request body is empty and the URI-query option doesn\u0026rsquo;t contain the empty parameter  4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The tenant that the gateway belongs to is not allowed to use this protocol adapter. The device belongs to another tenant than the gateway. The gateway is not authorized to act on behalf of the device. The gateway associated with the device is not registered or disabled.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This resource can be used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nPublish some JSON data for device 4712 using default message type CON (at least once):\ncoap-client -u gw@DEFAULT_TENANT -k gw-secret -m PUT coaps://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4712 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4712 using message type NON (at most once):\ncoap-client -u gw@DEFAULT_TENANT -k gw-secret -N -m PUT coaps://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4712 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4712, indicating that the gateway will wait for 10 seconds to receive the response:\ncoap-client -u gw@DEFAULT_TENANT -k gw-secret -m PUT coaps://hono.eclipseprojects.io/telemetry/DEFAULT_TENANT/4712?hono-ttd=10 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}' { \u0026quot;brightness\u0026quot;: 87 }  NB The examples above assume that a gateway device has been registered with psk credentials with auth-id gw and secret gw-secret which is authorized to publish data on behalf of device 4712.\nPublish an Event (authenticated Device) The device is authenticated using PSK.\n URI: /event Method: POST Type:CON Request Options:  (optional) content-format: The type of payload contained in the request body. Required, if request contains payload.  Query Parameters:  (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) empty: Marks the request as an empty notification.  Request Body:  (optional) Arbitrary payload encoded according to the given content type. Maybe empty, if URI-query: empty is provided.  Response Options:  (optional) content-format: A media type describing the semantics and format of payload contained in the response body. This option will only be present if the response contains a command to be executed by the device which requires input data. Note that this option will be empty if the media type contained in the command (AMQP) message\u0026rsquo;s content-type property cannot be mapped to one of the registered CoAP content-format codes. (optional) location-query: The hono-command query parameter contains the name of the command to execute. This option will only be present if the response contains a command to be executed by the device. (optional) location-path: The location path is command for one-way-commands and command_response/\u0026lt;command-request-id\u0026gt; for commands expecting a response. In the latter case, the location-path option contains exactly the URI-path that the device must use when sending its response to the command. This option will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content). (optional) Error details, if status code is \u0026gt;= 4.00.  Response Codes:  2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for the device to execute. Note that if the message type is NON (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer (yet). However, if the message type is CON (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 4.00 (Bad Request): The request cannot be processed. Possible reasons include:  the request body is empty and the URI-query option doesn\u0026rsquo;t contain the empty parameter  4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This is the preferred way for devices to publish events. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).\nExamples\nThe examples provided below make use of the coap-client command line tool which is part of the libcoap project. Precompiled packages should be available for different Linux variants.\nPublish some JSON data for device 4711 using default message type CON (at least once):\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret -m POST coaps://hono.eclipseprojects.io/event -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'   Note coap-client only reports error response-codes, so the expected 2.04 response code will not be printed to the terminal.  Publish some JSON data for device 4711, indicating that the device will wait for 10 seconds to receive the response:\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret -m POST coaps://hono.eclipseprojects.io/event?hono-ttd=10 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}' { \u0026quot;brightness\u0026quot;: 87 }   Note In the example above the response actually contains payload that should be used as input to a command to be executed by the device. This is just for illustrative purposes. You will usually get an empty response because there is no downstream application attached which could send any commands to the device.  Publish an Event (unauthenticated Device)  URI: /event/${tenantId}/${deviceId} Method: PUT Type:CON Request Options:  (optional) content-format: The type of payload contained in the request body. Required, if request contains payload.  Query Parameters:  (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) empty: Marks the request as an empty notification.  Request Body:  (optional) Arbitrary payload encoded according to the given content type. Maybe empty, if URI-query: empty is provided.  Response Options:  (optional) content-format: A media type describing the semantics and format of payload contained in the response body. This option will only be present if the response contains a command to be executed by the device which requires input data. Note that this option will be empty if the media type contained in the command (AMQP) message\u0026rsquo;s content-type property cannot be mapped to one of the registered CoAP content-format codes. (optional) location-query: The hono-command query parameter contains the name of the command to execute. This option will only be present if the response contains a command to be executed by the device. (optional) location-path: The location path is command for one-way-commands and command_response/\u0026lt;command-request-id\u0026gt; for commands expecting a response. In the latter case, the location-path option contains exactly the URI-path that the device must use when sending its response to the command. This option will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content). (optional) Error details, if status code is \u0026gt;= 4.00.  Response Codes:  2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for the device to execute. Note that if the message type is NON (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer (yet). However, if the message type is CON (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 4.00 (Bad Request): The request cannot be processed. Possible reasons include:  the request body is empty and the URI-query option doesn\u0026rsquo;t contain the empty parameter  4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_COAP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nPublish some JSON data for device 4711 using default message type CON (at least once):\ncoap-client -m PUT coap://hono.eclipseprojects.io/event/DEFAULT_TENANT/4711 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4711, indicating that the device will wait for 10 seconds to receive the response:\ncoap-client -m PUT coap://hono.eclipseprojects.io/event/DEFAULT_TENANT/4711?hono-ttd=10 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}' { \u0026quot;brightness\u0026quot;: 87 }  Publish an Event (authenticated Gateway)  URI: /event/${tenantId}/${deviceId} Method: PUT Type:CON Request Options:  (optional) content-format: The type of payload contained in the request body. Required, if request contains payload.  Query Parameters:  (optional) hono-ttd: The number of seconds the device will wait for the response. (optional) empty: Marks the request as an empty notification.  Request Body:  (optional) Arbitrary payload encoded according to the given content type. Maybe empty, if URI-query: empty is provided.  Response Options:  (optional) content-format: A media type describing the semantics and format of payload contained in the response body. This option will only be present if the response contains a command to be executed by the device which requires input data. Note that this option will be empty if the media type contained in the command (AMQP) message\u0026rsquo;s content-type property cannot be mapped to one of the registered CoAP content-format codes. (optional) location-query: The hono-command query parameter contains the name of the command to execute. This option will only be present if the response contains a command to be executed by the device. (optional) location-path: The location path is command/${tenantId}/${deviceId} for one-way-commands and command_response/${tenantId}/${deviceId}/\u0026lt;command-request-id\u0026gt; for commands expecting a response. In the latter case, the location-path option contains exactly the URI-path that the device must use when sending its response to the command. Note that in both cases the ${tenantId}/${deviceId} path segments indicate the device that the command is targeted at. This option will only be present if the response contains a command to be executed by the device.  Response Body:  (optional) Arbitrary data serving as input to a command to be executed by the device, if status code is 2.05 (Content). (optional) Error details, if status code is \u0026gt;= 4.00.  Response Codes:  2.04 (Changed): The data in the request body has been accepted for processing. The response may contain a command for a device to execute. Note that if the message type is NON (at most once semantics), this status code does not mean that the message has been delivered to any potential consumer (yet). However, if the message type is CON (at least once semantics), then the adapter waits for the message to be delivered and accepted by a downstream consumer before responding with this status code. 4.00 (Bad Request): The request cannot be processed. Possible reasons include:  the request body is empty and the URI-query option doesn\u0026rsquo;t contain the empty parameter  4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The tenant that the gateway belongs to is not allowed to use this protocol adapter. The device belongs to another tenant than the gateway. The gateway is not authorized to act on behalf of the device. The gateway associated with the device is not registered or disabled.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed because there is no consumer of telemetry data for the given tenant connected to Hono.   This resource can be used by gateway components to publish data on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to publish data on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nPublish some JSON data for device 4712 using default message type CON (at least once):\ncoap-client -u gw@DEFAULT_TENANT -k gw-secret -m PUT coaps://hono.eclipseprojects.io/event/DEFAULT_TENANT/4712 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}'  Publish some JSON data for device 4712, indicating that the gateway will wait for 10 seconds to receive the response:\ncoap-client -u gw@DEFAULT_TENANT -k gw-secret -m PUT coaps://hono.eclipseprojects.io/event/DEFAULT_TENANT/4712?hono-ttd=10 -t application/json -e '{\u0026quot;temp\u0026quot;: 5}' { \u0026quot;brightness\u0026quot;: 87 }  NB The examples above assume that a gateway device has been registered with psk credentials with auth-id gw and secret gw-secret which is authorized to publish data on behalf of device 4712.\nCommand \u0026amp; Control The CoAP adapter enables devices to receive commands that have been sent by business applications. Commands are delivered to the device by means of a response message. That means a device first has to send a request, indicating how long it will wait for the response. That request can either be a telemetry or event message, with a hono-ttd query parameter (ttd for time till disconnect) specifying the number of seconds the device will wait for the response. The business application can react on that message by sending a command message, targeted at the device. The CoAP adapter will then send the command message as part of the response message to the device.\nCommands handled by gateways Authenticated gateways will receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway. Corresponding devices have to be configured so that they can be used with a gateway. See Configuring Gateway Devices for details.\nA gateway can send a request with the hono-ttd query parameter on the /event or /telemetry URI, indicating its readiness to receive a command for any device it acts on behalf of. Note that in this case, the business application will be notified with the gateway id in the device_id property of the downstream message.\nAn authenticated gateway can also indicate its readiness to receive a command targeted at a specific device. For that, the /event/${tenantId}/${deviceId} or /telemetry/${tenantId}/${deviceId} URI is to be used, containing the id of the device to receive a command for. The business application will receive a notification with that device id.\nIf there are multiple concurrent requests with a hono-ttd query parameter, sent by the command target device and/or one or more of its potential gateways, the CoAP adapter will choose the device or gateway to send the command to as follows:\n A request done by the command target device or by a gateway specifically done for that device, has precedence. If there are multiple, concurrent such requests, the last one will get the command message (if received) in its response. Note that the other requests won\u0026rsquo;t be answered with a command message in their response event if the business application sent multiple command messages. That means commands for a single device can only be requested sequentially, not in parallel. If the above doesn\u0026rsquo;t apply, a single hono-ttd request on the /event or /telemetry URI, sent by a gateway that the command target device is configured for, will get the command message in its response. If there are multiple, concurrent such requests by different gateways, all configured for the command target device, the request by the gateway will be chosen, through which the target device has last sent a telemetry or event message. If the target device hasn\u0026rsquo;t sent a message yet and it is thereby unknown via which gateway the device communicates, then one of the requests will be chosen randomly to set the command in its response.  Sending a Response to a Command (authenticated Device) The device is authenticated using PSK.\n URI: /command_response/${commandRequestId} Method: POST Type: CON Request Options:  (optional) content-type: A media type describing the semantics and format of the payload contained in the request body. This option must be set if the result of processing the command on the device is non-empty. In this case the result data is contained in the request body.  Query Parameters:  (required) hono-cmd-status: An HTTP status code indicating the outcome of processing the command.  Request Body:  (optional) Arbitrary data representing the result of processing the command on the device.  Response Codes:  2.04 (Changed): The response has been successfully delivered to the application that has sent the command. 4.00 (Bad Request): The request cannot be processed because the command status or command request ID are missing/malformed. 4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed. Possible reasons for this include:  There is no application listening for a reply to the given commandRequestId. The application has already given up on waiting for a response.    This is the preferred way for devices to respond to commands. It is available only if the protocol adapter is configured to require devices to authenticate (which is the default).\nExample\nSend a response to a previously received command with the command-request-id req-id-uuid for device 4711:\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret coaps://hono.eclipseprojects.io/command_response/req-id-uuid?hono-cmd-status=200  Sending a Response to a Command (unauthenticated Device)  URI: /command_response/${tenantId}/${deviceId}/${commandRequestId} Method: PUT Type: CON Request Options:  (optional) content-type: A media type describing the semantics and format of the payload contained in the request body. This option must be set if the result of processing the command on the device is non-empty. In this case the result data is contained in the request body.  Query Parameters:  (required) hono-cmd-status: An HTTP status code indicating the outcome of processing the command.  Request Body:  (optional) Arbitrary data representing the result of processing the command on the device.  Response Codes:  2.04 (Changed): The response has been successfully delivered to the application that has sent the command. 4.00 (Bad Request): The request cannot be processed because the command status or command request ID are missing/malformed. 4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed. Possible reasons for this include:  There is no application listening for a reply to the given commandRequestId. The application has already given up on waiting for a response.    This resource MUST be used by devices that have not authenticated to the protocol adapter. Note that this requires the HONO_HTTP_AUTHENTICATION_REQUIRED configuration property to be explicitly set to false.\nExamples\nSend a response to a previously received command with the command-request-id req-id-uuid for the unauthenticated device 4711:\ncoap-client -u sensor1@DEFAULT_TENANT -k hono-secret coaps://hono.eclipseprojects.io/command_response/DEFAULT_TENANT/4711/req-id-uuid?hono-cmd-status=200 -e '{\u0026quot;brightness-changed\u0026quot;: true}'  Sending a Response to a Command (authenticated Gateway)  URI: /command_response/${tenantId}/${deviceId}/${commandRequestId} Method: PUT Type: CON Request Options:  (optional) content-type: A media type describing the semantics and format of the payload contained in the request body. This option must be set if the result of processing the command on the device is non-empty. In this case the result data is contained in the request body.  Query Parameters:  (required) hono-cmd-status: An HTTP status code indicating the outcome of processing the command.  Request Body:  (optional) Arbitrary data representing the result of processing the command on the device.  Response Codes:  2.04 (Changed): The response has been successfully delivered to the application that has sent the command. 4.00 (Bad Request): The request cannot be processed because the command status or command request ID are missing/malformed. 4.03 (Forbidden): The request cannot be processed because the device\u0026rsquo;s registration status cannot be asserted. Possible reasons for this include:  The given tenant is not allowed to use this protocol adapter. The given device does not belong to the given tenant. The gateway is not authorized to act on behalf of the device. The gateway associated with the device is not registered or disabled.  4.04 (Not Found): The request cannot be processed because the device is disabled or does not exist. 4.13 (Request Entity Too Large): The request cannot be processed because the request body exceeds the maximum supported size. 4.29 (Too Many Requests): The request cannot be processed because the tenant\u0026rsquo;s message limit for the current period is exceeded. 5.03 (Service Unavailable): The request cannot be processed. Possible reasons for this include:  There is no application listening for a reply to the given commandRequestId. The application has already given up on waiting for a response.    This resource can be used by gateway components to send the response to a command on behalf of other devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like SigFox or LoRa. In this case the credentials provided by the gateway during connection establishment with the protocol adapter are used to authenticate the gateway whereas the parameters from the URI are used to identify the device that the gateway publishes data for.\nThe protocol adapter checks the gateway\u0026rsquo;s authority to send responses to a command on behalf of the device implicitly by means of retrieving a registration assertion for the device from the configured Device Registration service.\nExamples\nSend a response to a previously received command with the command-request-id req-id-uuid for device 4712:\ncoap-client -u gw@DEFAULT_TENANT -k gw-secret coaps://hono.eclipseprojects.io/command_response/DEFAULT_TENANT/4712/req-id-uuid?hono-cmd-status=200 -e '{\u0026quot;brightness-changed\u0026quot;: true}'  NB The example above assumes that a gateway device has been registered with psk credentials with auth-id gw and secret gw-secret which is authorized to publish data on behalf of device 4712.\nDownstream Meta Data The adapter includes the following meta data in the application properties of messages being sent downstream:\n   Name Type Description     device_id string The identifier of the device that the message originates from.   orig_adapter string Contains the adapter\u0026rsquo;s type name which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The CoAP adapter\u0026rsquo;s type name is hono-coap.   orig_address string Contains the (relative) URI that the device has originally posted the data to.   ttd integer Contains the effective number of seconds that the device will wait for a response. This property is only set if the request contains the hono-ttd URI-query option.    The adapter also considers defaults registered for the device at either the tenant or the device level. The values of the default properties are determined as follows:\n If the message already contains a non-empty property of the same name, the value if unchanged. Otherwise, if a default property of the same name is defined in the device\u0026rsquo;s registration information, that value is used. Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.  Note that of the standard AMQP 1.0 message properties only the content-type and ttl can be set this way to a default value.\nEvent Message Time-to-live Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers. In most cases the AMQP Messaging Network can be configured with a maximum time-to-live to apply to the events so that the events will be removed from the persistent store if no consumer has attached to receive the event before the message expires.\nIn order to support environments where the AMQP Messaging Network cannot be configured accordingly, the protocol adapter supports setting a downstream event message\u0026rsquo;s ttl property based on the hono-ttl property set as a query parameter in the event requests by the devices. Also the default ttl and max-ttl values can be configured for a tenant/device as described in the Tenant API.\nTenant specific Configuration The adapter uses the Tenant API to retrieve tenant specific configuration for adapter type hono-coap. The following properties are (currently) supported:\n   Name Type Default Value Description     enabled boolean true If set to false the adapter will reject all data from devices belonging to the tenant.   max-ttd integer 60 Defines a tenant specific upper limit for the time until disconnect property that devices may include in requests for uploading telemetry data or events. Please refer to the Command \u0026amp; Control concept page for a discussion of this parameter\u0026rsquo;s purpose and usage.\nThis property can be set for the hono-coap adapter type as an extension property in the adapter section of the tenant configuration.\nIf it is not set, then the default value of 60 seconds is used.   "
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/user-guide/kura-adapter/",
 	"title": "Kura Adapter",
 	"tags": [],
 	"description": "",
-	"content": "The Kura protocol adapter exposes an MQTT topic hierarchy allowing Eclipse Kura\u0026trade; based gateways to publish control and data messages to Eclipse Hono\u0026trade;\u0026rsquo;s Telemetry and Event endpoints.\n Note The Kura adapter is supposed to be used with gateways running Kura version 3.x. Gateways running Kura version 4 and later should connect to the MQTT adapter instead.  The Kura adapter by default requires devices (gateways) to authenticate during connection establishment. In order to do so, gateways need to provide a username and a password in the MQTT CONNECT packet. The username must have the form auth-id@tenant, e.g. sensor1@DEFAULT_TENANT. The adapter verifies the credentials provided by the gateway against the credentials the configured Credentials service has on record for the gateway. The adapter uses the Credentials API\u0026rsquo;s get operation to retrieve the credentials-on-record with the tenant and auth-id provided by the device in the username and hashed-password as the type of secret as query parameters.\nPlease refer to the Eclipse Kura documentation on how to configure the gateway\u0026rsquo;s cloud service connection accordingly. It is important to set the gateway\u0026rsquo;s topic.context.account-name to the ID of the Hono tenant that the gateway has been registered with whereas the gateway\u0026rsquo;s client-id needs to be set to the corresponding Hono device ID. The auth-id used as part of the gateway\u0026rsquo;s username property needs to match the authentication identifier of a set of credentials registered for the device ID in Hono\u0026rsquo;s Credentials service. In other words, the credentials configured on the gateway need to belong to the corresponding device ID.\nAfter verifying the credentials, the number of existing connections and the overall amount of time that the devices have already been connected are checked against the configured resource-limits by the Kura adapter. If the limit is exceeded then a return code 0x05 indicating Connection Refused: not authorised is sent back.\nOnce the gateway has established a connection to the Kura adapter, all control and data messages published by applications running on the gateway are sent to the adapter and mapped to Hono\u0026rsquo;s Telemetry and Event API endpoints as follows:\n The adapter treats all messages that are published to a topic starting with the configured HONO_KURA_CONTROL_PREFIX as control messages. All other messages are considered to be data messages. control messages with QoS 0 are forwarded to Hono\u0026rsquo;s telemetry endpoint whereas messages with QoS 1 are forwarded to the event endpoint. The corresponding AMQP 1.0 messages that are sent downstream have a content type of application/vnd.eclipse.kura-control. data messages with QoS 0 are forwarded to the telemetry endpoint whereas messages with QoS 1 are forwarded to the event endpoint. The corresponding AMQP 1.0 messages that are sent downstream have a content type of application/vnd.eclipse.kura-data.  Downstream Meta Data The adapter includes the following meta data in messages being sent downstream:\n   Name Location Type Description     device_id application string The identifier of the device that the message originates from.   orig_adapter application string Contains the adapter\u0026rsquo;s type name which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The Kura adapter\u0026rsquo;s type name is hono-kura-mqtt.   orig_address application string Contains the name of the MQTT topic that the Kura gateway has originally published the data to.    The adapter also considers defaults registered for the device at either the tenant or the device level. The values of the default properties are determined as follows:\n If the message already contains a non-empty property of the same name, the value if unchanged. Otherwise, if a default property of the same name is defined in the device\u0026rsquo;s registration information, that value is used. Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.  Note that of the standard AMQP 1.0 message properties only the content-type and ttl can be set this way to a default value.\nEvent Message Time-to-live Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers. In most cases the AMQP Messaging Network can be configured with a maximum time-to-live to apply to the events so that the events will be removed from the persistent store if no consumer has attached to receive the event before the message expires.\nIn order to support environments where the AMQP Messaging Network cannot be configured accordingly, the protocol adapter supports setting a downstream event message\u0026rsquo;s ttl property based on the default ttl and max-ttl values configured for a tenant/device as described in the Tenant API.\nTenant specific Configuration The adapter uses the Tenant API to retrieve tenant specific configuration for adapter type hono-kura-mqtt. The following properties are (currently) supported:\n   Name Type Default Value Description     enabled boolean true If set to false the adapter will reject all data from devices belonging to the tenant.   "
+	"content": "The Kura protocol adapter exposes an MQTT topic hierarchy allowing Eclipse Kura\u0026trade; based gateways to publish control and data messages to Eclipse Hono\u0026trade;\u0026rsquo;s Telemetry and Event endpoints.\n Note The Kura adapter is supposed to be used with gateways running Kura version 3.x. Gateways running Kura version 4 and later should connect to the MQTT adapter instead.  Authentication The Kura adapter by default requires devices (gateways) to authenticate during connection establishment. The adapter supports both the authentication based on the username/password provided in an MQTT CONNECT packet as well as client certificate based authentication as part of a TLS handshake for that purpose.\nThe adapter tries to authenticate the device using these mechanisms in the following order\nClient Certificate When a device uses a client certificate for authentication during the TLS handshake, the adapter tries to determine the tenant that the device belongs to based on the issuer DN contained in the certificate. In order for the lookup to succeed, the tenant\u0026rsquo;s trust anchor needs to be configured by means of registering the trusted certificate authority. The device\u0026rsquo;s client certificate will then be validated using the registered trust anchor, thus implicitly establishing the tenant that the device belongs to. In a second step, the adapter uses the Credentials API\u0026rsquo;s get operation to retrieve the credentials on record, including the client certificate\u0026rsquo;s subject DN as the auth-id, x509-cert as the type of secret and the MQTT client identifier as client-id in the request payload.\nNB The adapter needs to be configured for TLS in order to support this mechanism.\nUsername/Password When a device wants to authenticate using this mechanism, it needs to provide a username and a password in the MQTT CONNECT packet it sends in order to initiate the connection. The username must have the form auth-id@tenant, e.g. sensor1@DEFAULT_TENANT. The adapter verifies the credentials provided by the client against the credentials that the configured Credentials service has on record for the client. The adapter uses the Credentials API\u0026rsquo;s get operation to retrieve the credentials on record, including the tenant and auth-id provided by the client in the username, hashed-password as the type of secret and the MQTT client identifier as client-id in the request payload.\nPlease refer to the Eclipse Kura documentation on how to configure the gateway\u0026rsquo;s cloud service connection accordingly. It is important to set the gateway\u0026rsquo;s topic.context.account-name to the ID of the Hono tenant that the gateway has been registered with whereas the gateway\u0026rsquo;s client-id needs to be set to the corresponding Hono device ID. The auth-id used as part of the gateway\u0026rsquo;s username property needs to match the authentication identifier of a set of credentials registered for the device ID in Hono\u0026rsquo;s Credentials service. In other words, the credentials configured on the gateway need to belong to the corresponding device ID.\nNB There is a subtle difference between the device identifier (device-id) and the auth-id a device uses for authentication. See Device Identity for a discussion of the concepts.\nResource Limit Checks The adapter performs additional checks regarding resource limits when a client tries to connect and/or send a message to the adapter.\nConnection Limits The adapter rejects a client\u0026rsquo;s connection attempt with return code 0x05, indicating Connection Refused: not authorized, if * the maximum number of connections per protocol adapter instance is reached, or * if the maximum number of simultaneously connected devices for the tenant is reached.\nPlease refer to resource-limits for details.\nConnection Duration Limits The adapter rejects a client\u0026rsquo;s connection attempt with return code 0x05, indicating Connection Refused: not authorized, if the connection duration limit that has been configured for the client\u0026rsquo;s tenant is exceeded.\nMessage Limits The adapter\n discards any MQTT PUBLISH packet containing telemetry data or an event that is sent by a client and rejects any AMQP 1.0 message containing a command sent by a north bound application  if the message limit that has been configured for the device\u0026rsquo;s tenant is exceeded.\nConnection Events The adapter can emit Connection Events for client connections being established and/or terminated. Please refer to the common configuration options for details regarding how to enable this behavior.\nThe adapter includes the client identifier from the client\u0026rsquo;s MQTT CONNECT packet as the Connection Event\u0026rsquo;s remote-id.\nPublishing Data Once the gateway has established a connection to the Kura adapter, all control and data messages published by applications running on the gateway are sent to the adapter and mapped to Hono\u0026rsquo;s Telemetry and Event API endpoints as follows:\n The adapter treats all messages that are published to a topic starting with the configured HONO_KURA_CONTROL_PREFIX as control messages. All other messages are considered to be data messages. control messages with QoS 0 are forwarded to Hono\u0026rsquo;s telemetry endpoint whereas messages with QoS 1 are forwarded to the event endpoint. The corresponding AMQP 1.0 messages that are sent downstream have a content type of application/vnd.eclipse.kura-control. data messages with QoS 0 are forwarded to the telemetry endpoint whereas messages with QoS 1 are forwarded to the event endpoint. The corresponding AMQP 1.0 messages that are sent downstream have a content type of application/vnd.eclipse.kura-data.  Downstream Meta Data The adapter includes the following meta data in messages being sent downstream:\n   Name Location Type Description     device_id application string The identifier of the device that the message originates from.   orig_adapter application string Contains the adapter\u0026rsquo;s type name which can be used by downstream consumers to determine the protocol adapter that the message has been received over. The Kura adapter\u0026rsquo;s type name is hono-kura-mqtt.   orig_address application string Contains the name of the MQTT topic that the Kura gateway has originally published the data to.    The adapter also considers defaults registered for the device at either the tenant or the device level. The values of the default properties are determined as follows:\n If the message already contains a non-empty property of the same name, the value if unchanged. Otherwise, if a default property of the same name is defined in the device\u0026rsquo;s registration information, that value is used. Otherwise, if a default property of the same name is defined for the tenant that the device belongs to, that value is used.  Note that of the standard AMQP 1.0 message properties only the content-type and ttl can be set this way to a default value.\nEvent Message Time-to-live Events published by devices will usually be persisted by the AMQP Messaging Network in order to support deferred delivery to downstream consumers. In most cases the AMQP Messaging Network can be configured with a maximum time-to-live to apply to the events so that the events will be removed from the persistent store if no consumer has attached to receive the event before the message expires.\nIn order to support environments where the AMQP Messaging Network cannot be configured accordingly, the protocol adapter supports setting a downstream event message\u0026rsquo;s ttl property based on the default ttl and max-ttl values configured for a tenant/device as described in the Tenant API.\nTenant specific Configuration The adapter uses the Tenant API to retrieve tenant specific configuration for adapter type hono-kura-mqtt. The following properties are (currently) supported:\n   Name Type Default Value Description     enabled boolean true If set to false the adapter will reject all data from devices belonging to the tenant.   "
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/user-guide/sigfox-adapter/",
@@ -144,7 +151,7 @@
 	"title": "Common Configuration",
 	"tags": [],
 	"description": "",
-	"content": "Many Hono components support a common set of configuration options. This section describes those options.\nEach component which supports the following options explicitly states so. If it doesn\u0026rsquo;t, then these options are not supported by this component.\nJava VM Options The Java VM started in Hono\u0026rsquo;s components can be configured with arbitrary command line options by means of setting the JDK_JAVA_OPTIONS environment variable.\n   Environment Variable Mandatory Default Description     JDK_JAVA_OPTIONS no - Any options that should be passed to the Java VM on the command line, e.g. -Xmx128m    Vert.x Options The vert.x framework instance used to run Hono\u0026rsquo;s components on can be configured using the following environment variables or corresponding command line options:\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_VERTX_DNS_QUERY_TIMEOUT\n--hono.vertx.dnsQueryTimeout no 5000 The amount of time (in milliseconds) after which a DNS query is considered to be failed. Setting this variable to a smaller value may help to reduce the time required to establish connections to the services this adapter depends on. However, setting it to a value that is too small for any DNS query to succeed will effectively prevent any connections to be established at all.   HONO_VERTX_MAX_EVENT_LOOP_EXECUTE_TIME_MILLIS\n--hono.vertx.maxEventLoopExecuteTimeMillis no 2000 The maximum number of milliseconds that a task on the event loop may run without being considered to block the event loop.   HONO_VERTX_PREFER_NATIVE\n--hono.vertx.preferNative no false Tries to enable epoll() support on Linux (if available). See the notes below for an explanation of the benefits of enabling epoll.    \nUsing epoll() on Linux Using epoll() on Linux may provide better performance for applications which have a high I/O throughput. Especially when the application supports an asynchronous I/O model. This is true for most Hono components and applications using Hono.\nThe Netty framework supports using epoll() on Linux x86_64 based systems. Hono provides the a Maven build profile for enabling support for epoll during the build process.\nIn order to use epoll\n Hono needs to be built with the netty-native-linux-x86_64 Maven profile enabled and the HONO_VERTX_PREFER_NATIVE environment variable needs to be set to true on startup.  Protocol Adapter Options AMQP 1.0 Messaging Network Connection Configuration Protocol adapters require a connection to the AMQP 1.0 Messaging Network in order to forward telemetry data and events received from devices to downstream consumers.\nThe connection to the messaging network is configured according to Hono Client Configuration with HONO_MESSAGING being used as ${PREFIX}. Since there are no responses being received, the properties for configuring response caching can be ignored.\nCommand \u0026amp; Control Connection Configuration Protocol adapters require an additional connection to the AMQP 1.0 Messaging Network in order to receive commands from downstream applications and send responses to commands back to applications.\nThe connection is configured according to Hono Client Configuration with HONO_COMMAND being used as ${PREFIX}. The properties for configuring response caching can be ignored.\nTenant Service Connection Configuration Protocol adapters require a connection to an implementation of Hono\u0026rsquo;s Tenant API in order to retrieve information for a tenant.\nThe connection to the Tenant Service is configured according to Hono Client Configuration where the ${PREFIX} is set to HONO_TENANT and the additional values for response caching apply.\nThe adapter caches the responses from the service according to the cache directive included in the response. If the response doesn\u0026rsquo;t contain a cache directive no data will be cached.\nDevice Registration Service Connection Configuration Protocol adapters require a connection to an implementation of Hono\u0026rsquo;s Device Registration API in order to retrieve registration status assertions for connected devices.\nThe connection to the Device Registration Service is configured according to Hono Client Configuration where the ${PREFIX} is set to HONO_REGISTRATION.\nThe adapter caches the responses from the service according to the cache directive included in the response. If the response doesn\u0026rsquo;t contain a cache directive no data will be cached.\nCredentials Service Connection Configuration Protocol adapters require a connection to an implementation of Hono\u0026rsquo;s Credentials API in order to retrieve credentials stored for devices that needs to be authenticated. During connection establishment, the adapter uses the Credentials API to retrieve the credentials on record for the device and matches that with the credentials provided by a device.\nThe connection to the Credentials Service is configured according to Hono Client Configuration where the ${PREFIX} is set to HONO_CREDENTIALS.\nThe adapter caches the responses from the service according to the cache directive included in the response. If the response doesn\u0026rsquo;t contain a cache directive no data will be cached.\nDevice Connection Service Connection Configuration Protocol adapters require a connection to an implementation of Hono\u0026rsquo;s Device Connection API in order to determine the gateway that a device is connected via to a protocol adapter. This information is required in order to forward commands issued by applications to the protocol adapter instance that the gateway is connected to.\nThe connection to the Device Connection service is configured according to Hono Client Configuration where the ${PREFIX} is set to HONO_DEVICECONNECTION.\nResponses from the Device Connection service are never cached, so the properties for configuring the cache are ignored.\nDirect Connection to Data Grid Protocol adapters can alternatively be configured to directly access an data grid for storing and retrieving device connection information using Infinispan\u0026rsquo;s Hotrod protocol. This has the advantage of saving the network hop to the Device Connection service. However, this is only beneficial if the Device Connection service implementation itself uses a remote service (like a data grid) for storing the data.\nThe following table provides an overview of the configuration variables and corresponding command line options for configuring the connection to the data grid:\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_DEVICECONNECTION_SERVER_LIST\n--hono.deviceConnection.serverList yes - A list of remote servers in the form: host1[:port][;host2[:port]].....   HONO_DEVICECONNECTION_AUTH_SERVER_NAME\n--hono.deviceConnection.authServerName yes - The server name to indicate in the SASL handshake when authenticating to the server.   HONO_DEVICECONNECTION_AUTH_USERNAME\n--hono.deviceConnection.authUsername yes - The username to use for authenticating to the server.   HONO_DEVICECONNECTION_AUTH_PASSWORD\n--hono.deviceConnection.authPassword yes - The password to use for authenticating to the server.    In general, the service supports all configuration properties of the Infinispan Hotrod client using hono.deviceConnection instead of the infinispan.client.hotrod prefix.\nResource Limits Checker Configuration The adapter can use metrics collected by a Prometheus server to enforce certain limits set at the tenant level like the overall number of connected devices allowed per tenant.\nThe following table provides an overview of the configuration variables and corresponding command line options for configuring the checker.\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     HONO_RESOURCELIMITS_PROMETHEUSBASED_HOST\n--hono.resourceLimits.prometheusBased.host no localhost The host name or IP address of the Prometheus server to retrieve the metrics data from. This property needs to be set in order to enable the Prometheus based checks.   HONO_RESOURCELIMITS_PROMETHEUSBASED_PORT\n--hono.resourceLimits.prometheusBased.port no 9090 The port of the Prometheus server to retrieve metrics data from.   HONO_RESOURCELIMITS_PROMETHEUSBASED_CACHE_MIN_SIZE\n--hono.resourceLimits.prometheusBased.cacheMinSize no 20 The minimum size of the cache to store the metrics data retrieved from the Prometheus server. The cache is used for storing the current amount of data exchanged with devices of tenants.   HONO_RESOURCELIMITS_PROMETHEUSBASED_CACHE_MAX_SIZE\n--hono.resourceLimits.prometheusBased.cacheMaxSize no 1000 The maximum size of the cache to store the metrics data retrieved from the Prometheus server.   HONO_RESOURCELIMITS_PROMETHEUSBASED_CACHE_TIMEOUT\n--hono.resourceLimits.prometheusBased.cacheTimeout no 600 The number of seconds after which the cached metrics data should be considered invalid.    In addition to the properties listed above, the resource limit checker also supports the properties listed below as documented in the Hono Client Configuration. These properties might be useful if a reverse proxy in front of the Prometheus server requires the client to use TLS and/or provide credentials for authentication.\n HONO_RESOURCELIMITS_PROMETHEUSBASED_CREDENTIALSPATH HONO_RESOURCELIMITS_PROMETHEUSBASED_HOSTNAMEVERIFICATIONREQUIRED HONO_RESOURCELIMITS_PROMETHEUSBASED_KEYPATH HONO_RESOURCELIMITS_PROMETHEUSBASED_KEYSTOREPASSWORD HONO_RESOURCELIMITS_PROMETHEUSBASED_KEYSTOREPATH HONO_RESOURCELIMITS_PROMETHEUSBASED_PASSWORD HONO_RESOURCELIMITS_PROMETHEUSBASED_SECUREPROTOCOLS HONO_RESOURCELIMITS_PROMETHEUSBASED_TLSENABLED HONO_RESOURCELIMITS_PROMETHEUSBASED_TRUSTSTOREPATH HONO_RESOURCELIMITS_PROMETHEUSBASED_TRUSTSTOREPASSWORD HONO_RESOURCELIMITS_PROMETHEUSBASED_USERNAME "
+	"content": "Many Hono components support a common set of configuration options. This section describes those options.\nEach component which supports the following options explicitly states so. If it doesn\u0026rsquo;t, then these options are not supported by this component.\nJava VM Options The Java VM started in Hono\u0026rsquo;s components can be configured with arbitrary command line options by means of setting the JDK_JAVA_OPTIONS environment variable.\n   Environment Variable Mandatory Default Description     JDK_JAVA_OPTIONS no - Any options that should be passed to the Java VM on the command line, e.g. -Xmx128m    Vert.x Options The vert.x framework instance used to run Hono\u0026rsquo;s components on can be configured using the following environment variables or corresponding command line options:\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_VERTX_DNS_QUERY_TIMEOUT\n--hono.vertx.dnsQueryTimeout no 5000 The amount of time (in milliseconds) after which a DNS query is considered to be failed. Setting this variable to a smaller value may help to reduce the time required to establish connections to the services this adapter depends on. However, setting it to a value that is too small for any DNS query to succeed will effectively prevent any connections to be established at all.   HONO_VERTX_MAX_EVENT_LOOP_EXECUTE_TIME_MILLIS\n--hono.vertx.maxEventLoopExecuteTimeMillis no 2000 The maximum number of milliseconds that a task on the event loop may run without being considered to block the event loop.   HONO_VERTX_PREFER_NATIVE\n--hono.vertx.preferNative no false Tries to enable epoll() support on Linux (if available). See the notes below for an explanation of the benefits of enabling epoll.    \nUsing epoll() on Linux Using epoll() on Linux may provide better performance for applications which have a high I/O throughput. Especially when the application supports an asynchronous I/O model. This is true for most Hono components and applications using Hono.\nThe Netty framework supports using epoll() on Linux x86_64 based systems. Hono provides the a Maven build profile for enabling support for epoll during the build process.\nIn order to use epoll\n Hono needs to be built with the netty-native-linux-x86_64 Maven profile enabled and the HONO_VERTX_PREFER_NATIVE environment variable needs to be set to true on startup.  Protocol Adapter Options AMQP 1.0 Messaging Network Connection Configuration Protocol adapters require a connection to the AMQP 1.0 Messaging Network in order to forward telemetry data and events received from devices to downstream consumers.\nThe connection to the messaging network is configured according to Hono Client Configuration with HONO_MESSAGING being used as ${PREFIX}. Since there are no responses being received, the properties for configuring response caching can be ignored.\nCommand \u0026amp; Control Connection Configuration Protocol adapters require an additional connection to the AMQP 1.0 Messaging Network in order to receive commands from downstream applications and send responses to commands back to applications.\nThe connection is configured according to Hono Client Configuration with HONO_COMMAND being used as ${PREFIX}. The properties for configuring response caching can be ignored.\nTenant Service Connection Configuration Protocol adapters require a connection to an implementation of Hono\u0026rsquo;s Tenant API in order to retrieve information for a tenant.\nThe connection to the Tenant Service is configured according to Hono Client Configuration where the ${PREFIX} is set to HONO_TENANT and the additional values for response caching apply.\nThe adapter caches the responses from the service according to the cache directive included in the response. If the response doesn\u0026rsquo;t contain a cache directive no data will be cached.\nDevice Registration Service Connection Configuration Protocol adapters require a connection to an implementation of Hono\u0026rsquo;s Device Registration API in order to retrieve registration status assertions for connected devices.\nThe connection to the Device Registration Service is configured according to Hono Client Configuration where the ${PREFIX} is set to HONO_REGISTRATION.\nThe adapter caches the responses from the service according to the cache directive included in the response. If the response doesn\u0026rsquo;t contain a cache directive no data will be cached.\nCredentials Service Connection Configuration Protocol adapters require a connection to an implementation of Hono\u0026rsquo;s Credentials API in order to retrieve credentials stored for devices that needs to be authenticated. During connection establishment, the adapter uses the Credentials API to retrieve the credentials on record for the device and matches that with the credentials provided by a device.\nThe connection to the Credentials Service is configured according to Hono Client Configuration where the ${PREFIX} is set to HONO_CREDENTIALS.\nThe adapter caches the responses from the service according to the cache directive included in the response. If the response doesn\u0026rsquo;t contain a cache directive no data will be cached.\nDevice Connection Service Connection Configuration Protocol adapters require a connection to an implementation of Hono\u0026rsquo;s Device Connection API in order to determine the gateway that a device is connected via to a protocol adapter. This information is required in order to forward commands issued by applications to the protocol adapter instance that the gateway is connected to.\nThe connection to the Device Connection service is configured according to Hono Client Configuration where the ${PREFIX} is set to HONO_DEVICECONNECTION.\nResponses from the Device Connection service are never cached, so the properties for configuring the cache are ignored.\nDirect Connection to Data Grid Protocol adapters can alternatively be configured to directly access a data grid for storing and retrieving device connection information using Infinispan\u0026rsquo;s Hotrod protocol. This has the advantage of saving the network hop to the Device Connection service. However, this is only beneficial if the Device Connection service implementation itself uses a remote service (like a data grid) for storing the data.\nThe following table provides an overview of the configuration variables and corresponding command line options for configuring the connection to the data grid:\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_DEVICECONNECTION_SERVER_LIST\n--hono.deviceConnection.serverList yes - A list of remote servers in the form: host1[:port][;host2[:port]].....   HONO_DEVICECONNECTION_AUTH_SERVER_NAME\n--hono.deviceConnection.authServerName yes - The server name to indicate in the SASL handshake when authenticating to the server.   HONO_DEVICECONNECTION_AUTH_USERNAME\n--hono.deviceConnection.authUsername yes - The username to use for authenticating to the server.   HONO_DEVICECONNECTION_AUTH_PASSWORD\n--hono.deviceConnection.authPassword yes - The password to use for authenticating to the server.    In general, the service supports all configuration properties of the Infinispan Hotrod client using hono.deviceConnection instead of the infinispan.client.hotrod prefix.\nResource Limits Checker Configuration The adapter can use metrics collected by a Prometheus server to enforce certain limits set at the tenant level like the overall number of connected devices allowed per tenant.\nThe following table provides an overview of the configuration variables and corresponding command line options for configuring the checker.\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     HONO_RESOURCELIMITS_PROMETHEUSBASED_HOST\n--hono.resourceLimits.prometheusBased.host no localhost The host name or IP address of the Prometheus server to retrieve the metrics data from. This property needs to be set in order to enable the Prometheus based checks.   HONO_RESOURCELIMITS_PROMETHEUSBASED_PORT\n--hono.resourceLimits.prometheusBased.port no 9090 The port of the Prometheus server to retrieve metrics data from.   HONO_RESOURCELIMITS_PROMETHEUSBASED_CACHEMINSIZE\n--hono.resourceLimits.prometheusBased.cacheMinSize no 20 The minimum size of the cache to store the metrics data retrieved from the Prometheus server. The cache is used for storing the current amount of data exchanged with devices of tenants.   HONO_RESOURCELIMITS_PROMETHEUSBASED_CACHEMAXSIZE\n--hono.resourceLimits.prometheusBased.cacheMaxSize no 1000 The maximum size of the cache to store the metrics data retrieved from the Prometheus server.   HONO_RESOURCELIMITS_PROMETHEUSBASED_CACHETIMEOUT\n--hono.resourceLimits.prometheusBased.cacheTimeout no 15 The number of seconds after which the cached metrics data should be considered invalid.   HONO_RESOURCELIMITS_PROMETHEUSBASED_QUERYTIMEOUT\n--hono.resourceLimits.prometheusBased.queryTimeout no 500 The number of milliseconds after which a request to a Prometheus server is closed. Setting zero or a negative value disables the timeout.    In addition to the properties listed above, the resource limit checker also supports the properties listed below as documented in the Hono Client Configuration. These properties might be useful if a reverse proxy in front of the Prometheus server requires the client to use TLS and/or provide credentials for authentication.\n HONO_RESOURCELIMITS_PROMETHEUSBASED_CREDENTIALSPATH HONO_RESOURCELIMITS_PROMETHEUSBASED_HOSTNAMEVERIFICATIONREQUIRED HONO_RESOURCELIMITS_PROMETHEUSBASED_KEYPATH HONO_RESOURCELIMITS_PROMETHEUSBASED_KEYSTOREPASSWORD HONO_RESOURCELIMITS_PROMETHEUSBASED_KEYSTOREPATH HONO_RESOURCELIMITS_PROMETHEUSBASED_PASSWORD HONO_RESOURCELIMITS_PROMETHEUSBASED_SECUREPROTOCOLS HONO_RESOURCELIMITS_PROMETHEUSBASED_TLSENABLED HONO_RESOURCELIMITS_PROMETHEUSBASED_TRUSTSTOREPATH HONO_RESOURCELIMITS_PROMETHEUSBASED_TRUSTSTOREPASSWORD HONO_RESOURCELIMITS_PROMETHEUSBASED_USERNAME  Connection Event Producer Configuration Some of the protocol adapters report the establishment and termination of a connection with a device by means of a Connection Event Producer.\nThe producer being used by the adapter can be configured as follows:\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     HONO_CONNECTIONEVENTS_PRODUCER\n--hono.connectionEvents.producer no logging The type of connection event producer to use for reporting the establishment/termination of device connections. Supported values are\nnone - No information is reported at all.\nlogging - All information is reported at INFO level via the logging framework.\nevents - All information is being sent downstream as Connection Events.   HONO_CONNECTIONEVENTS_LOGLEVEL\n--hono.connectionEvents.logLevel no info The level to log connection information at. Supported values are debug and info.    The events based connection event producer sets the TTL of event messages that it emits to the max TTL configured at the tenant level.\n"
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/admin-guide/auth-server-config/",
@@ -154,53 +161,67 @@
 	"content": "The Auth Server component exposes a service endpoint implementing Eclipse Hono\u0026trade;\u0026rsquo;s Authentication API. Other services use this component for authenticating clients and retrieving a token asserting the client\u0026rsquo;s identity and corresponding authorities.\nThis component serves as a default implementation of the Authentication API only. On startup, it reads in all identities and their authorities from a JSON file from the file system. All data is then kept in memory and there are no remote service APIs for managing the identities and their authorities.\nThe Auth Server is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nService Configuration In addition to the following options, this component supports the options described in Common Configuration.\nThe server can be configured by means of environment variables or corresponding command line options. The following table provides an overview of the configuration variables and corresponding command line options that the server supports:\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_APP_MAX_INSTANCES\n--hono.app.maxInstances no #CPU cores The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.   HONO_AUTH_AMQP_BIND_ADDRESS\n--hono.auth.amqp.bindAddress no 127.0.0.1 The IP address of the network interface that the secure port should be bound to.\nSee Port Configuration below for details.   HONO_AUTH_AMQP_CERT_PATH\n--hono.auth.amqp.certPath no - The absolute path to the PEM file containing the certificate that the server should use for authenticating to clients. This option must be used in conjunction with HONO_AUTH_AMQP_KEY_PATH.\nAlternatively, the HONO_AUTH_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_AUTH_AMQP_INSECURE_PORT\n--hono.auth.amqp.insecurePort no - The insecure port the server should listen on.\nSee Port Configuration below for details.   HONO_AUTH_AMQP_INSECURE_PORT_BIND_ADDRESS\n--hono.auth.amqp.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure port should be bound to.\nSee Port Configuration below for details.   HONO_AUTH_AMQP_INSECURE_PORT_ENABLED\n--hono.auth.amqp.insecurePortEnabled no false If set to true the server will open an insecure port (not secured by TLS) using either the port number set via HONO_AUTH_AMQP_INSECURE_PORT or the default AMQP port number (5672) if not set explicitly.\nSee Port Configuration below for details.   HONO_AUTH_AMQP_KEY_PATH\n--hono.auth.amqp.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the server should use for authenticating to clients. Note that the private key is not protected by a password. You should therefore make sure that the key file can only be read by the user that the server process is running under. This option must be used in conjunction with HONO_AUTH_CERT_PATH.\nAlternatively, the HONO_AUTH_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_AUTH_AMQP_KEY_STORE_PASSWORD\n--hono.auth.amqp.keyStorePassword no - The password required to read the contents of the key store.   HONO_AUTH_AMQP_KEY_STORE_PATH\n--hono.auth.amqp.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the server should use for authenticating to clients. Either this option or the HONO_AUTH_AMQP_KEY_PATH and HONO_AUTH_AMQP_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_AUTH_AMQP_NATIVE_TLS_REQUIRED\n--hono.auth.amqp.nativeTlsRequired no false The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_AUTH_AMQP_PORT\n--hono.auth.amqp.port no 5671 The secure port that the server should listen on.\nSee Port Configuration below for details.   HONO_AUTH_AMQP_SECURE_PROTOCOLS\n--hono.auth.amqp.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   HONO_AUTH_AMQP_TRUST_STORE_PASSWORD\n--hono.auth.amqp.trustStorePassword no - The password required to read the contents of the trust store.   HONO_AUTH_AMQP_TRUST_STORE_PATH\n--hono.auth.amqp.trustStorePath no - The absolute path to the Java key store containing the CA certificates the service uses for authenticating clients. The key store format can be either JKS, PKCS12 or PEM indicated by a .jks, .p12 or .pem file suffix respectively.   HONO_AUTH_SVC_PERMISSIONS_PATH\n--hono.auth.svc.permissionsPath no classpath:/\npermissions.json The Spring resource URI of the JSON file defining the identities and corresponding authorities on Hono\u0026rsquo;s endpoint resources. The default file bundled with the Auth Server defines authorities required by protocol adapters and downstream consumer. The default permissions file should only be used for evaluation purposes.   HONO_AUTH_SVC_SIGNING_KEY_PATH\n--hono.auth.svc.signing.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the server should use for signing tokens asserting an authenticated client\u0026rsquo;s identity and authorities. When using this variable, other services that need to validate the tokens issued by this service need to be configured with the corresponding certificate/public key. Alternatively, a symmetric key can be used for signing (and validating) by setting the HONO_AUTH_SVC_SIGNING_SHARED_SECRET variable. If none of these variables is set, the server falls back to the key indicated by the HONO_AUTH_AMQP_KEY_PATH variable. If that variable is also not set, startup of the server fails.   HONO_AUTH_SVC_SIGNING_SHARED_SECRET\n--hono.auth.svc.signing.sharedSecret no - A string to derive a symmetric key from that is used for signing tokens asserting an authenticated client\u0026rsquo;s identity and authorities. The key is derived from the string by using the bytes of the String\u0026rsquo;s UTF8 encoding. When setting the signing key using this variable, other services that need to validate the tokens issued by this service need to be configured with the same key. Alternatively, an asymmetric key pair can be used for signing (and validating) by setting the HONO_AUTH_SVC_SIGNING_KEY_PATH variable. If none of these variables is set, startup of the server fails.   HONO_AUTH_SVC_SIGNING_TOKEN_EXPIRATION\n--hono.auth.svc.signing.tokenExpiration no 600 The number of seconds after which the tokens created by this service for asserting an authenticated client\u0026rsquo;s identity should be considered invalid. Other Hono components will close AMQP connections with clients after this period in order to force the client to authenticate again and create a new token. In closed environments it should be save to set this value to a much higher value, e.g. several hours.   HONO_AUTH_SVC_SUPPORTED_SASL_MECHANISMS\n--hono.auth.svc.supportedSaslMechanisms no EXTERNAL, PLAIN A (comma separated) list of the supported SASL mechanisms to be advertised to clients. This option may be set to specify only one of EXTERNAL or PLAIN, or to use a different order.    The variables only need to be set if the default value does not match your environment.\nPort Configuration The Auth Server can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The server will fail to start if none of the ports is configured properly.\nSecure Port Only The server needs to be configured with a private key, a certificate holding the public key and a trust store in order to open a TLS secured port.\nThere are two alternative ways for setting the private key and certificate:\n Setting the HONO_AUTH_AMQP_KEY_STORE_PATH and the HONO_AUTH_AMQP_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_AUTH_AMQP_KEY_PATH and HONO_AUTH_AMQP_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  In order to set the trust store, the HONO_AUTH_AMQP_TRUST_STORE_PATH variable needs to be set to a key store containing the trusted root CA certificates. The HONO_AUTH_AMQP_TRUST_STORE_PASSWORD variable needs to be set if the key store requires a pass phrase for reading its contents.\nWhen starting up, the server will bind a TLS secured socket to the default secure AMQP port 5671. The port number can also be set explicitly using the HONO_AUTH_AMQP_PORT variable.\nThe HONO_AUTH_AMQP_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_AUTH_AMQP_INSECURE_PORT to a valid port number, or by implicitly configuring the default AMQP port (5672) by simply setting HONO_AUTH_AMQP_INSECURE_PORT_ENABLED to true.  The server issues a warning on the console if HONO_AUTH_AMQP_INSECURE_PORT is set to the default secure AMQP port (5671).\nThe HONO_AUTH_AMQP_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port In test setups and some production scenarios Hono server may be configured to open one secure and one insecure port at the same time.\nThis is achieved by configuring both ports correctly (see above). The server will fail to start if both ports are configured to use the same port number.\nSince the secure port may need different visibility in the network setup compared to the secure port, it has it\u0026rsquo;s own binding address HONO_AUTH_AMQP_INSECURE_PORT_BIND_ADDRESS. This can be used to narrow the visibility of the insecure port to a local network e.g., while the secure port may be visible worldwide.\nEphemeral Ports The server may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nMetrics Configuration See Monitoring \u0026amp; Tracing Admin Guide for details on how to configure the reporting of metrics.\n"
 },
 {
-	"uri": "https://www.eclipse.org/hono/docs/admin-guide/device-registry-config/",
-	"title": "Device Registry Configuration",
+	"uri": "https://www.eclipse.org/hono/docs/admin-guide/mongodb-device-registry-config/",
+	"title": "MongoDB Based Device Registry Configuration",
 	"tags": [],
 	"description": "",
-	"content": "The Device Registry component provides an exemplary implementation of Eclipse Hono\u0026trade;\u0026rsquo;s Device Registration, Credentials, Tenant and Device Connection APIs.\nProtocol adapters use these APIs to determine a device\u0026rsquo;s registration status, e.g. if it is enabled and if it is registered with a particular tenant, and to authenticate a device before accepting any data for processing from it.\nThere is no particular technical reason to implement these three APIs in one component, so for production scenarios there might be up to three different components each implementing one of the API\u0026rsquo;s.\nThe Device Registry component also exposes HTTP based resources for managing tenants and the registration information and credentials of devices.\nThe Device Registry is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nService Configuration In addition to the following options, this component supports the options described in Common Configuration.\nThe following table provides an overview of the configuration variables and corresponding command line options for configuring the Device Registry.\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_APP_TYPE\n--hono.app.type no file The device registry implementation to use. This may be either file or dummy. In the case of dummy a dummy implementation will be used which will consider all devices queried for as valid devices, having the access credentials hono-secret. Of course this shouldn\u0026rsquo;t be used for productive use.   HONO_CREDENTIALS_SVC_CACHE_MAX_AGE\n--hono.credentials.svc.cacheMaxAge no 180 The maximum period of time (seconds) that information returned by the service\u0026rsquo;s operations may be cached for.   HONO_CREDENTIALS_SVC_FILENAME\n--hono.credentials.svc.filename no /var/lib/hono/device-registry/\ncredentials.json The path to the file where the server stores credentials of devices. Hono tries to read credentials from this file during start-up and writes out all identities to this file periodically if property HONO_CREDENTIALS_SVC_SAVE_TO_FILE is set to true.\nPlease refer to Credentials File Format for details regarding the file\u0026rsquo;s format.   HONO_CREDENTIALS_SVC_HASH_ALGORITHMS_WHITELIST\n--hono.credentials.svc.hashAlgorithmsWhitelist no empty An array of supported hashing algorithms to be used with the hashed-password type of credentials. When not set, all values will be accepted.   HONO_CREDENTIALS_SVC_MAX_BCRYPT_ITERATIONS\n--hono.credentials.svc.maxBcryptIterations no 10 The maximum number of iterations that are supported in password hashes using the BCrypt hash function. This limit is enforced by the device registry when adding or updating corresponding credentials. Increasing this number allows for potentially more secure password hashes to be used. However, the time required to compute the hash increases exponentially with the number of iterations.   HONO_CREDENTIALS_SVC_MODIFICATION_ENABLED\n--hono.credentials.svc.modificationEnabled no true When set to false the credentials contained in the registry cannot be updated nor removed.   HONO_CREDENTIALS_SVC_RECEIVER_LINK_CREDIT\n--hono.credentials.svc.receiverLinkCredit no 100 The number of credits to flow to a client connecting to the Credentials endpoint.   HONO_CREDENTIALS_SVC_SAVE_TO_FILE\n--hono.credentials.svc.saveToFile no false When set to true the server will periodically write out the registered credentials to the file specified by the HONO_CREDENTIALS_SVC_FILENAME property.   HONO_CREDENTIALS_SVC_STARTEMPTY\n--hono.credentials.svc.startEmpty no false When set to true the server will not try to load credentials from the file specified by the HONO_CREDENTIALS_SVC_FILENAME property during startup.   HONO_DEVICE_CONNECTION_SVC_MAX_DEVICES_PER_TENANT\n--hono.deviceConnection.svc.maxDevicesPerTenant no 100 The number of devices per tenant for which connection related data is stored. It is an error to set this property to a value \u0026lt;= 0.   HONO_REGISTRY_AMQP_BIND_ADDRESS\n--hono.registry.amqp.bindAddress no 127.0.0.1 The IP address of the network interface that the secure AMQP port should be bound to.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_CERT_PATH\n--hono.registry.amqp.certPath no - The absolute path to the PEM file containing the certificate that the server should use for authenticating to clients. This option must be used in conjunction with HONO_REGISTRY_AMQP_KEY_PATH.\nAlternatively, the HONO_REGISTRY_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_REGISTRY_AMQP_INSECURE_PORT\n--hono.registry.amqp.insecurePort no - The insecure port the server should listen on for AMQP 1.0 connections.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_INSECURE_PORT_BIND_ADDRESS\n--hono.registry.amqp.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure AMQP port should be bound to.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_INSECURE_PORT_ENABLED\n--hono.registry.amqp.insecurePortEnabled no false If set to true the server will open an insecure port (not secured by TLS) using either the port number set via HONO_REGISTRY_AMQP_INSECURE_PORT or the default AMQP port number (5672) if not set explicitly.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_KEY_PATH\n--hono.registry.amqp.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the server should use for authenticating to clients. This option must be used in conjunction with HONO_REGISTRY_AMQP_CERT_PATH. Alternatively, the HONO_REGISTRY_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_REGISTRY_AMQP_KEY_STORE_PASSWORD\n--hono.registry.amqp.keyStorePassword no - The password required to read the contents of the key store.   HONO_REGISTRY_AMQP_KEY_STORE_PATH\n--hono.registry.amqp.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the server should use for authenticating to clients. Either this option or the HONO_REGISTRY_AMQP_KEY_PATH and HONO_REGISTRY_AMQP_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_REGISTRY_AMQP_NATIVE_TLS_REQUIRED\n--hono.registry.amqp.nativeTlsRequired no false The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_REGISTRY_AMQP_PORT\n--hono.registry.amqp.port no 5671 The secure port that the server should listen on for AMQP 1.0 connections.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_SECURE_PROTOCOLS\n--hono.registry.amqp.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   HONO_REGISTRY_REST_BIND_ADDRESS\n--hono.registry.rest.bindAddress no 127.0.0.1 The IP address of the network interface that the secure HTTP port should be bound to.\nSee Port Configuration below for details.   HONO_REGISTRY_REST_CERT_PATH\n--hono.registry.rest.certPath no - The absolute path to the PEM file containing the certificate that the server should use for authenticating to clients. This option must be used in conjunction with HONO_REGISTRY_REST_KEY_PATH.\nAlternatively, the HONO_REGISTRY_REST_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_REGISTRY_REST_INSECURE_PORT\n--hono.registry.rest.insecurePort no - The insecure port the server should listen on for HTTP requests.\nSee Port Configuration below for details.   HONO_REGISTRY_REST_INSECURE_PORT_BIND_ADDRESS\n--hono.registry.rest.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure HTTP port should be bound to.\nSee Port Configuration below for details.   HONO_REGISTRY_REST_INSECURE_PORT_ENABLED\n--hono.registry.rest.insecurePortEnabled no false If set to true the server will open an insecure port (not secured by TLS) using either the port number set via HONO_REGISTRY_REST_INSECURE_PORT or the default AMQP port number (5672) if not set explicitly.\nSee Port Configuration below for details.   HONO_REGISTRY_REST_KEY_PATH\n--hono.registry.rest.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the server should use for authenticating to clients. This option must be used in conjunction with HONO_REGISTRY_REST_CERT_PATH. Alternatively, the HONO_REGISTRY_REST_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_REGISTRY_REST_KEY_STORE_PASSWORD\n--hono.registry.rest.keyStorePassword no - The password required to read the contents of the key store.   HONO_REGISTRY_REST_KEY_STORE_PATH\n--hono.registry.rest.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the server should use for authenticating to clients. Either this option or the HONO_REGISTRY_REST_KEY_PATH and HONO_REGISTRY_REST_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_REGISTRY_REST_PORT\n--hono.registry.rest.port no 5671 The secure port that the server should listen on for HTTP requests.\nSee Port Configuration below for details.   HONO_REGISTRY_SVC_CACHE_MAX_AGE\n--hono.registry.svc.cacheMaxAge no 180 The maximum period of time (seconds) that information returned by the service\u0026rsquo;s operations may be cached for.   HONO_REGISTRY_SVC_FILENAME\n--hono.registry.svc.filename no /var/lib/hono/device-registry/\ndevice-identities.json The path to the file where the server stores identities of registered devices. Hono tries to read device identities from this file during start-up and writes out all identities to this file periodically if property HONO_REGISTRY_SVC_SAVE_TO_FILE is set to true.\nPlease refer to Device Identities File Format for details regarding the file\u0026rsquo;s format.   HONO_REGISTRY_SVC_MAX_DEVICES_PER_TENANT\n--hono.registry.svc.maxDevicesPerTenant no 100 The number of devices that can be registered for each tenant. It is an error to set this property to a value \u0026lt;= 0.   HONO_REGISTRY_SVC_MODIFICATION_ENABLED\n--hono.registry.svc.modificationEnabled no true When set to false the device information contained in the registry cannot be updated nor removed from the registry.   HONO_REGISTRY_SVC_RECEIVER_LINK_CREDIT\n--hono.registry.svc.receiverLinkCredit no 100 The number of credits to flow to a client connecting to the Device Registration endpoint.   HONO_REGISTRY_SVC_SAVE_TO_FILE\n--hono.registry.svc.saveToFile no false When set to true the server will periodically write out the registered device information to the file specified by the HONO_REGISTRY_SVC_FILENAME property.   HONO_REGISTRY_SVC_SIGNING_KEY_PATH\n--hono.registry.svc.signing.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the server should use for signing tokens asserting a device\u0026rsquo;s registration status. When using this variable, other services that need to validate the tokens issued by this service need to be configured with the corresponding certificate/public key. Alternatively, a symmetric key can be used for signing (and validating) by setting the HONO_REGISTRY_SVC_SIGNING_SHARED_SECRET variable. If none of these variables is set, the server falls back to the key indicated by the HONO_REGISTRY_AMP_KEY_PATH variable. If that variable is also not set, startup of the server fails.   HONO_REGISTRY_SVC_SIGNING_SHARED_SECRET\n--hono.registry.svc.signing.sharedSecret no - A string to derive a symmetric key from that is used for signing tokens asserting a device\u0026rsquo;s registration status. The key is derived from the string by using the bytes of the String\u0026rsquo;s UTF8 encoding. When setting the signing key using this variable, other services that need to validate the tokens issued by this service need to be configured with the same key. Alternatively, an asymmetric key pair can be used for signing (and validating) by setting the HONO_REGISTRY_SVC_SIGNING_KEY_PATH variable. If none of these variables is set, startup of the server fails.   HONO_REGISTRY_SVC_SIGNING_TOKEN_EXPIRATION\n--hono.registry.svc.signing.tokenExpiration no 10 The expiration period to use for the tokens asserting the registration status of devices.   HONO_REGISTRY_SVC_STARTEMPTY\n--hono.registry.svc.startEmpty no false When set to true the server will not try to load device identities from the file specified by the HONO_REGISTRY_SVC_FILENAME property during startup.   HONO_TENANT_SVC_CACHE_MAX_AGE\n--hono.tenant.svc.cacheMaxAge no 180 The maximum period of time (seconds) that information returned by the service\u0026rsquo;s operations may be cached for.   HONO_TENANT_SVC_FILENAME\n--hono.tenant.svc.filename no /var/lib/hono/device-registry/\ntenants.json The path to the file where the server stores tenants. Hono tries to read tenants from this file during start-up and writes out all identities to this file periodically if property HONO_TENANT_SVC_SAVE_TO_FILE is set to true.\nPlease refer to Tenants File Format for details regarding the file\u0026rsquo;s format.   HONO_TENANT_SVC_MODIFICATION_ENABLED\n--hono.tenant.svc.modificationEnabled no true When set to false the tenants contained in the registry cannot be updated nor removed.   HONO_TENANT_SVC_RECEIVER_LINK_CREDIT\n--hono.tenant.svc.receiverLinkCredit no 100 The number of credits to flow to a client connecting to the Tenant endpoint.   HONO_TENANT_SVC_SAVE_TO_FILE\n--hono.tenant.svc.saveToFile no false When set to true the server will periodically write out the registered tenants to the file specified by the HONO_TENANTS_SVC_TENANT_FILENAME property.   HONO_TENANT_SVC_STARTEMPTY\n--hono.tenant.svc.startEmpty no false When set to true the server will not try to load tenants from the file specified by the HONO_TENANT_SVC_FILENAME property during startup.    The variables only need to be set if the default value does not match your environment.\nPort Configuration The Device Registry supports configuration of both, an AMQP based endpoint as well as an HTTP based endpoint proving RESTful resources for managing registration information and credentials. Both endpoints can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The server will fail to start if none of the ports is configured properly.\nThe following sections apply to configuring both, the AMQP endpoint as well as the REST endpoint. The environment variables to use for configuring the REST endpoint are the same as the ones for the AMQP endpoint, substituting _AMQP_ with _REST_, e.g. HONO_REGISTRY_REST_KEY_PATH instead of HONO_REGISTRY_AMQP_KEY_PATH.\nSecure Port Only The server needs to be configured with a private key and certificate in order to open a TLS secured port.\nThere are two alternative ways for doing so:\n Setting the HONO_REGISTRY_AMQP_KEY_STORE_PATH and the HONO_REGISTRY_AMQP_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_REGISTRY_AMQP_KEY_PATH and HONO_REGISTRY_AMQP_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  When starting up, the server will bind a TLS secured socket to the default secure AMQP port 5671. The port number can also be set explicitly using the HONO_REGISTRY_AMQP_PORT variable.\nThe HONO_REGISTRY_AMQP_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_REGISTRY_AMQP_INSECURE_PORT to a valid port number, or by implicitly configuring the default AMQP port (5672) by simply setting HONO_REGISTRY_AMQP_INSECURE_PORT_ENABLED to true.  The server issues a warning on the console if HONO_REGISTRY_AMQP_INSECURE_PORT is set to the default secure AMQP port (5671).\nThe HONO_REGISTRY_AMQP_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port In test setups and some production scenarios Hono server may be configured to open one secure and one insecure port at the same time.\nThis is achieved by configuring both ports correctly (see above). The server will fail to start if both ports are configured to use the same port number.\nSince the secure port may need different visibility in the network setup compared to the secure port, it has it\u0026rsquo;s own binding address HONO_REGISTRY_AMQP_INSECURE_PORT_BIND_ADDRESS. This can be used to narrow the visibility of the insecure port to a local network e.g., while the secure port may be visible worldwide.\nEphemeral Ports The server may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nAuthentication Service Connection Configuration The Device Registry requires a connection to an implementation of Hono\u0026rsquo;s Authentication API in order to authenticate and authorize client requests.\nThe connection is configured according to Hono Client Configuration where the ${PREFIX} is set to HONO_AUTH. Since Hono\u0026rsquo;s Authentication Service does not allow caching of the responses, the cache properties can be ignored.\nIn addition to the standard client configuration properties, following properties may be set for the connection:\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_AUTH_VALIDATION_CERT_PATH\n--hono.auth.validation.certPath no - The absolute path to the PEM file containing the an X.509 certificate that the service should use for validating tokens issued by the Authentication service. Alternatively, a symmetric key can be used for validating tokens by setting the HONO_AUTH_VALIDATION_SHARED_SECRET variable. If none of these variables is set, startup of the service fails.   HONO_AUTH_VALIDATION_SHARED_SECRET\n--hono.auth.validation.sharedSecret no - A string to derive a symmetric key from which is used for validating tokens issued by the Authentication service. The key is derived from the string by using the bytes of the String\u0026rsquo;s UTF8 encoding. When setting the validation key using this variable, the Authentication service must be configured with the same key. Alternatively, an X.509 certificate can be used for validating tokens by setting the HONO_AUTH_VALIDATION_CERT_PATH variable. If none of these variables is set, startup of the service fails.   HONO_AUTH_SUPPORTED_SASL_MECHANISMS\n--hono.auth.supportedSaslMechanisms no EXTERNAL, PLAIN A (comma separated) list of the SASL mechanisms that the device registry should offer to clients for authentication. This option may be set to specify only one of EXTERNAL or PLAIN, or to use a different order.    Metrics Configuration See Monitoring \u0026amp; Tracing Admin Guide for details on how to configure the reporting of metrics.\nDevice Identities File Format The Device Registry supports persisting the device identities and their registration information to a JSON file in the local file system. The Getting started Guide includes an example configuration which illustrates the file format used. The configuration file\u0026rsquo;s location is /deploy/src/main/deploy/example-device-identities.json.\nCredentials File Format The Device Registry supports persisting the devices\u0026rsquo; credentials to a JSON file in the local file system. The Getting started Guide includes an example configuration which illustrates the file format used. The configuration file\u0026rsquo;s location is /deploy/src/main/deploy/example-credentials.json.\nTenants File Format The Device Registry supports persisting tenants to a JSON file in the local file system. The configuration file\u0026rsquo;s location is /deploy/src/main/deploy/example-tenants.json.\nConfiguring Gateway Devices The Device Registry supports devices to act on behalf of other devices. This is particularly useful for cases where a device does not connect directly to a Hono protocol adapter but is connected to a gateway component that is usually specific to the device\u0026rsquo;s communication protocol. It is the gateway component which then connects to a Hono protocol adapter and publishes data on behalf of the device(s). Examples of such a set up include devices using SigFox or LoRa for communication.\nIn these cases the protocol adapter will authenticate the gateway component instead of the device for which it wants to publish data. In order to verify that the gateway is authorized to publish data on behalf of the particular device, the protocol adapter should include the gateway\u0026rsquo;s device identifier (as determined during the authentication process) in its invocation of the Device Registration API\u0026rsquo;s assert Device Registration operation.\nThe Device Registry will then do the following: 1. Verify that the device exists and is enabled. 2. Verify that the gateway exists and is enabled. 3. Verify that the device\u0026rsquo;s registration information contains a property called via and that its value is either the gateway\u0026rsquo;s device identifier or a JSON array which contains the gateway\u0026rsquo;s device identifier as one of its values.\nOnly if all conditions are met, the Device Registry returns an assertion of the device\u0026rsquo;s registration status. The protocol adapter can then forward the published data to the AMQP Messaging Network in the same way as for any device that connects directly to the adapter.\nThe example configuration file (located at /deploy/src/main/deploy/example-device-identities.json) includes a device and a corresponding gateway configured in this way.\n"
+	"content": " The MongoDB based Device Registry component provides an implementation of Eclipse Hono\u0026trade;\u0026rsquo;s Device Registration, Credentials and Tenant APIs. Protocol adapters use these APIs to determine a device\u0026rsquo;s registration status, e.g. if it is enabled and if it is registered with a particular tenant, and to authenticate a device before accepting any data for processing from it. In addition to the above, this Device Registry also provides an implementation of Device Registry Management APIs for managing tenants, registration information and credentials of devices.\nThe Device Registry is implemented as a Spring Boot application, and the data is persisted in a MongoDB database. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nService Configuration The following table provides an overview of the configuration variables and corresponding command line options for configuring the MongoDB based Device Registry. In addition to the following options, this component also supports the options described in Common Configuration.\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_CREDENTIALS_SVC_CACHE_MAX_AGE\n--hono.credentials.svc.cacheMaxAge no 180 The maximum period of time (seconds) that information returned by the service\u0026rsquo;s operations may be cached for.   HONO_CREDENTIALS_SVC_COLLECTION_NAME\n--hono.credentials.svc.collectionName no credentials The name of the MongoDB collection where the server stores credentials of devices.   HONO_CREDENTIALS_SVC_HASH_ALGORITHMS_WHITELIST\n--hono.credentials.svc.hashAlgorithmsWhitelist no empty An array of supported hashing algorithms to be used with the hashed-password type of credentials. When not set, all values will be accepted.   HONO_CREDENTIALS_SVC_MAX_BCRYPT_ITERATIONS\n--hono.credentials.svc.maxBcryptIterations no 10 The maximum number of iterations that are supported in password hashes using the BCrypt hash function. This limit is enforced by the device registry when adding or updating corresponding credentials. Increasing this number allows for potentially more secure password hashes to be used. However, the time required to compute the hash increases exponentially with the number of iterations.   HONO_CREDENTIALS_SVC_MODIFICATION_ENABLED\n--hono.credentials.svc.modificationEnabled no true When set to false the credentials contained in the registry cannot be updated nor removed.   HONO_CREDENTIALS_SVC_RECEIVER_LINK_CREDIT\n--hono.credentials.svc.receiverLinkCredit no 100 The number of credits to flow to a client connecting to the Credentials endpoint.   HONO_MONGODB_CONNECTION_STRING\n--hono.mongodb.connectionString no - The connection string used by the Device Registry application to connect to the MongoDB database. If HONO_MONGODB_CONNECTION_STRING is set, it overrides the other MongoDB connection settings.\nSee Connection String URI Format for more information.   HONO_MONGODB_CONNECTION_TIMEOUT_IN_MS\n--hono.mongodb.connectionTimeoutInMs no 10000 The time in milliseconds to attempt a connection before timing out.   HONO_MONGODB_DB_NAME\n--hono.mongodb.dbName no - The name of the MongoDB database that should be used by the Device Registry application.   HONO_MONGODB_HOST\n--hono.mongodb.host no localhost The host name or IP address of the MongoDB instance.   HONO_MONGODB_PORT\n--hono.mongodb.port no 27017 The port that the MongoDB instance is listening on.   HONO_MONGODB_PASSWORD\n--hono.mongodb.password no - The password to use for authenticating to the MongoDB instance.   HONO_MONGODB_SERVER_SELECTION_TIMEOUT_IN_MS\n--hono.mongodb.serverSelectionTimeoutInMs no 1000 The time in milliseconds that the mongo driver will wait to select a server for an operation before raising an error.   HONO_MONGODB_USERNAME\n--hono.mongodb.username no - The user name to use for authenticating to the MongoDB instance.   HONO_REGISTRY_AMQP_BIND_ADDRESS\n--hono.registry.amqp.bindAddress no 127.0.0.1 The IP address of the network interface that the secure AMQP port should be bound to.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_CERT_PATH\n--hono.registry.amqp.certPath no - The absolute path to the PEM file containing the certificate that the server should use for authenticating to clients. This option must be used in conjunction with HONO_REGISTRY_AMQP_KEY_PATH.\nAlternatively, the HONO_REGISTRY_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_REGISTRY_AMQP_INSECURE_PORT\n--hono.registry.amqp.insecurePort no - The insecure port the server should listen on for AMQP 1.0 connections.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_INSECURE_PORT_BIND_ADDRESS\n--hono.registry.amqp.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure AMQP port should be bound to.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_INSECURE_PORT_ENABLED\n--hono.registry.amqp.insecurePortEnabled no false If set to true the server will open an insecure port (not secured by TLS) using either the port number set via HONO_REGISTRY_AMQP_INSECURE_PORT or the default AMQP port number (5672) if not set explicitly.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_KEY_PATH\n--hono.registry.amqp.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the server should use for authenticating to clients. This option must be used in conjunction with HONO_REGISTRY_AMQP_CERT_PATH. Alternatively, the HONO_REGISTRY_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_REGISTRY_AMQP_KEY_STORE_PASSWORD\n--hono.registry.amqp.keyStorePassword no - The password required to read the contents of the key store.   HONO_REGISTRY_AMQP_KEY_STORE_PATH\n--hono.registry.amqp.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the server should use for authenticating to clients. Either this option or the HONO_REGISTRY_AMQP_KEY_PATH and HONO_REGISTRY_AMQP_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_REGISTRY_AMQP_NATIVE_TLS_REQUIRED\n--hono.registry.amqp.nativeTlsRequired no false The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_REGISTRY_AMQP_PORT\n--hono.registry.amqp.port no 5671 The secure port that the server should listen on for AMQP 1.0 connections.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_SECURE_PROTOCOLS\n--hono.registry.amqp.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   HONO_REGISTRY_HTTP_AUTHENTICATION_REQUIRED\n--hono.registry.http.authenticationRequired no true If set to true the HTTP endpoint of the Device Registry requires clients to authenticate when connecting to the Device Registry. The MongoDB based Device Registry currently supports basic authentication and the user credentials are to be stored in a MongoDB collection with name user. For more information on how to manage users please refer to Mongo Auth Provider.   HONO_REGISTRY_HTTP_BIND_ADDRESS\n--hono.registry.http.bindAddress no 127.0.0.1 The IP address of the network interface that the secure HTTP port should be bound to.\nSee Port Configuration below for details.   HONO_REGISTRY_HTTP_CERT_PATH\n--hono.registry.http.certPath no - The absolute path to the PEM file containing the certificate that the server should use for authenticating to clients. This option must be used in conjunction with HONO_REGISTRY_HTTP_KEY_PATH.\nAlternatively, the HONO_REGISTRY_HTTP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_REGISTRY_HTTP_DEVICE_ID_REGEX\n--hono.registry.http.deviceIdRegex no ^[a-zA-Z0-9-_]+$ The regular expression to use to validate device ID. Please refer to the java pattern documentation.   HONO_REGISTRY_HTTP_INSECURE_PORT\n--hono.registry.http.insecurePort no - The insecure port the server should listen on for HTTP requests.\nSee Port Configuration below for details.   HONO_REGISTRY_HTTP_INSECURE_PORT_BIND_ADDRESS\n--hono.registry.http.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure HTTP port should be bound to.\nSee Port Configuration below for details.   HONO_REGISTRY_HTTP_INSECURE_PORT_ENABLED\n--hono.registry.http.insecurePortEnabled no false If set to true the server will open an insecure port (not secured by TLS) using either the port number set via HONO_REGISTRY_HTTP_INSECURE_PORT or the default AMQP port number (5672) if not set explicitly.\nSee Port Configuration below for details.   HONO_REGISTRY_HTTP_KEY_PATH\n--hono.registry.http.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the server should use for authenticating to clients. This option must be used in conjunction with HONO_REGISTRY_HTTP_CERT_PATH. Alternatively, the HONO_REGISTRY_HTTP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_REGISTRY_HTTP_KEY_STORE_PASSWORD\n--hono.registry.http.keyStorePassword no - The password required to read the contents of the key store.   HONO_REGISTRY_HTTP_KEY_STORE_PATH\n--hono.registry.http.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the server should use for authenticating to clients. Either this option or the HONO_REGISTRY_HTTP_KEY_PATH and HONO_REGISTRY_HTTP_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_REGISTRY_HTTP_PORT\n--hono.registry.http.port no 5671 The secure port that the server should listen on for HTTP requests.\nSee Port Configuration below for details.   HONO_REGISTRY_HTTP_TENANT_ID_REGEX\n--hono.registry.http.tenantIdRegex no ^[a-zA-Z0-9-_.]+$ The regular expression to use to validate tenant ID. Please refer to the java pattern documentation.   HONO_REGISTRY_SVC_CACHE_MAX_AGE\n--hono.registry.svc.cacheMaxAge no 180 The maximum period of time (seconds) that information returned by the service\u0026rsquo;s operations may be cached for.   HONO_REGISTRY_SVC_COLLECTION_NAME\n--hono.registry.svc.collectionName no devices The name of the MongoDB collection where the server stores registered device information.   HONO_REGISTRY_SVC_MAX_DEVICES_PER_TENANT\n--hono.registry.svc.maxDevicesPerTenant no -1 The number of devices that can be registered for each tenant. It is an error to set this property to a value \u0026lt; -1. The value -1 indicates that no limit is set.   HONO_REGISTRY_SVC_MODIFICATION_ENABLED\n--hono.registry.svc.modificationEnabled no true When set to false the device information contained in the registry cannot be updated nor removed from the registry.   HONO_REGISTRY_SVC_RECEIVER_LINK_CREDIT\n--hono.registry.svc.receiverLinkCredit no 100 The number of credits to flow to a client connecting to the Device Registration endpoint.   HONO_TENANT_SVC_CACHE_MAX_AGE\n--hono.tenant.svc.cacheMaxAge no 180 The maximum period of time (seconds) that information returned by the service\u0026rsquo;s operations may be cached for.   HONO_TENANT_SVC_COLLECTION_NAME\n--hono.tenant.svc.collectionName no tenants The name of the MongoDB collection where the server stores tenants information.   HONO_TENANT_SVC_MODIFICATION_ENABLED\n--hono.tenant.svc.modificationEnabled no true When set to false the tenants contained in the registry cannot be updated nor removed.   HONO_TENANT_SVC_RECEIVER_LINK_CREDIT\n--hono.tenant.svc.receiverLinkCredit no 100 The number of credits to flow to a client connecting to the Tenant endpoint.    The variables only need to be set if the default value does not match your environment.\nPort Configuration The Device Registry supports configuration of both, an AMQP based endpoint as well as an HTTP based endpoint proving RESTful resources for managing registration information and credentials. Both endpoints can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  See Port Configuration for more information.\n Note The environment variables to use for configuring the REST endpoint are the same as the ones for the AMQP endpoint, substituting _AMQP_ with _HTTP_.  Authentication Service Connection Configuration See Authentication Service Connection Configuration for more information.\nMetrics Configuration See Monitoring \u0026amp; Tracing Admin Guide for details on how to configure the reporting of metrics.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/admin-guide/file-based-device-registry-config/",
+	"title": "File Based Device Registry Configuration",
+	"tags": [],
+	"description": "",
+	"content": "The File based Device Registry component provides an exemplary implementation of Eclipse Hono\u0026trade;\u0026rsquo;s Device Registration, Credentials, Tenant and Device Connection APIs.\nProtocol adapters use these APIs to determine a device\u0026rsquo;s registration status, e.g. if it is enabled and if it is registered with a particular tenant, and to authenticate a device before accepting any data for processing from it.\nThere is no particular technical reason to implement these three APIs in one component, so for production scenarios there might be up to three different components each implementing one of the API\u0026rsquo;s.\nThe Device Registry component also exposes HTTP based resources for managing tenants and the registration information and credentials of devices.\nThe Device Registry is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nService Configuration In addition to the following options, this component supports the options described in Common Configuration.\nThe following table provides an overview of the configuration variables and corresponding command line options for configuring the Device Registry.\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_APP_TYPE\n--hono.app.type no file The device registry implementation to use. This may be either file or dummy. In the case of dummy a dummy implementation will be used which will consider all devices queried for as valid devices, having the access credentials hono-secret. Of course this shouldn\u0026rsquo;t be used for productive use.   HONO_CREDENTIALS_SVC_CACHE_MAX_AGE\n--hono.credentials.svc.cacheMaxAge no 180 The maximum period of time (seconds) that information returned by the service\u0026rsquo;s operations may be cached for.   HONO_CREDENTIALS_SVC_FILENAME\n--hono.credentials.svc.filename no /var/lib/hono/device-registry/\ncredentials.json The path to the file where the server stores credentials of devices. Hono tries to read credentials from this file during start-up and writes out all identities to this file periodically if property HONO_CREDENTIALS_SVC_SAVE_TO_FILE is set to true.\nPlease refer to Credentials File Format for details regarding the file\u0026rsquo;s format.   HONO_CREDENTIALS_SVC_HASH_ALGORITHMS_WHITELIST\n--hono.credentials.svc.hashAlgorithmsWhitelist no empty An array of supported hashing algorithms to be used with the hashed-password type of credentials. When not set, all values will be accepted.   HONO_CREDENTIALS_SVC_MAX_BCRYPT_ITERATIONS\n--hono.credentials.svc.maxBcryptIterations no 10 The maximum number of iterations that are supported in password hashes using the BCrypt hash function. This limit is enforced by the device registry when adding or updating corresponding credentials. Increasing this number allows for potentially more secure password hashes to be used. However, the time required to compute the hash increases exponentially with the number of iterations.   HONO_CREDENTIALS_SVC_MODIFICATION_ENABLED\n--hono.credentials.svc.modificationEnabled no true When set to false the credentials contained in the registry cannot be updated nor removed.   HONO_CREDENTIALS_SVC_RECEIVER_LINK_CREDIT\n--hono.credentials.svc.receiverLinkCredit no 100 The number of credits to flow to a client connecting to the Credentials endpoint.   HONO_CREDENTIALS_SVC_SAVE_TO_FILE\n--hono.credentials.svc.saveToFile no false When set to true the server will periodically write out the registered credentials to the file specified by the HONO_CREDENTIALS_SVC_FILENAME property.   HONO_CREDENTIALS_SVC_STARTEMPTY\n--hono.credentials.svc.startEmpty no false When set to true the server will not try to load credentials from the file specified by the HONO_CREDENTIALS_SVC_FILENAME property during startup.   HONO_DEVICE_CONNECTION_SVC_MAX_DEVICES_PER_TENANT\n--hono.deviceConnection.svc.maxDevicesPerTenant no 100 The number of devices per tenant for which connection related data is stored. It is an error to set this property to a value \u0026lt;= 0.   HONO_REGISTRY_AMQP_BIND_ADDRESS\n--hono.registry.amqp.bindAddress no 127.0.0.1 The IP address of the network interface that the secure AMQP port should be bound to.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_CERT_PATH\n--hono.registry.amqp.certPath no - The absolute path to the PEM file containing the certificate that the server should use for authenticating to clients. This option must be used in conjunction with HONO_REGISTRY_AMQP_KEY_PATH.\nAlternatively, the HONO_REGISTRY_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_REGISTRY_AMQP_INSECURE_PORT\n--hono.registry.amqp.insecurePort no - The insecure port the server should listen on for AMQP 1.0 connections.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_INSECURE_PORT_BIND_ADDRESS\n--hono.registry.amqp.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure AMQP port should be bound to.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_INSECURE_PORT_ENABLED\n--hono.registry.amqp.insecurePortEnabled no false If set to true the server will open an insecure port (not secured by TLS) using either the port number set via HONO_REGISTRY_AMQP_INSECURE_PORT or the default AMQP port number (5672) if not set explicitly.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_KEY_PATH\n--hono.registry.amqp.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the server should use for authenticating to clients. This option must be used in conjunction with HONO_REGISTRY_AMQP_CERT_PATH. Alternatively, the HONO_REGISTRY_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_REGISTRY_AMQP_KEY_STORE_PASSWORD\n--hono.registry.amqp.keyStorePassword no - The password required to read the contents of the key store.   HONO_REGISTRY_AMQP_KEY_STORE_PATH\n--hono.registry.amqp.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the server should use for authenticating to clients. Either this option or the HONO_REGISTRY_AMQP_KEY_PATH and HONO_REGISTRY_AMQP_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_REGISTRY_AMQP_NATIVE_TLS_REQUIRED\n--hono.registry.amqp.nativeTlsRequired no false The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_REGISTRY_AMQP_PORT\n--hono.registry.amqp.port no 5671 The secure port that the server should listen on for AMQP 1.0 connections.\nSee Port Configuration below for details.   HONO_REGISTRY_AMQP_SECURE_PROTOCOLS\n--hono.registry.amqp.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   HONO_REGISTRY_REST_TENANT_ID_REGEX\n--hono.registry.rest.tenantIdRegex no ^[a-zA-Z0-9-_.]+$ The regular expression to use to validate tenant ID. Please refer to the java pattern documentation.   HONO_REGISTRY_REST_DEVICE_ID_REGEX\n--hono.registry.rest.deviceIdRegex no ^[a-zA-Z0-9-_]+$ The regular expression to use to validate device ID. Please refer to the java pattern documentation.   HONO_REGISTRY_REST_BIND_ADDRESS\n--hono.registry.rest.bindAddress no 127.0.0.1 The IP address of the network interface that the secure HTTP port should be bound to.\nSee Port Configuration below for details.   HONO_REGISTRY_REST_CERT_PATH\n--hono.registry.rest.certPath no - The absolute path to the PEM file containing the certificate that the server should use for authenticating to clients. This option must be used in conjunction with HONO_REGISTRY_REST_KEY_PATH.\nAlternatively, the HONO_REGISTRY_REST_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_REGISTRY_REST_INSECURE_PORT\n--hono.registry.rest.insecurePort no - The insecure port the server should listen on for HTTP requests.\nSee Port Configuration below for details.   HONO_REGISTRY_REST_INSECURE_PORT_BIND_ADDRESS\n--hono.registry.rest.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure HTTP port should be bound to.\nSee Port Configuration below for details.   HONO_REGISTRY_REST_INSECURE_PORT_ENABLED\n--hono.registry.rest.insecurePortEnabled no false If set to true the server will open an insecure port (not secured by TLS) using either the port number set via HONO_REGISTRY_REST_INSECURE_PORT or the default AMQP port number (5672) if not set explicitly.\nSee Port Configuration below for details.   HONO_REGISTRY_REST_KEY_PATH\n--hono.registry.rest.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the server should use for authenticating to clients. This option must be used in conjunction with HONO_REGISTRY_REST_CERT_PATH. Alternatively, the HONO_REGISTRY_REST_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_REGISTRY_REST_KEY_STORE_PASSWORD\n--hono.registry.rest.keyStorePassword no - The password required to read the contents of the key store.   HONO_REGISTRY_REST_KEY_STORE_PATH\n--hono.registry.rest.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the server should use for authenticating to clients. Either this option or the HONO_REGISTRY_REST_KEY_PATH and HONO_REGISTRY_REST_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_REGISTRY_REST_PORT\n--hono.registry.rest.port no 5671 The secure port that the server should listen on for HTTP requests.\nSee Port Configuration below for details.   HONO_REGISTRY_SVC_CACHE_MAX_AGE\n--hono.registry.svc.cacheMaxAge no 180 The maximum period of time (seconds) that information returned by the service\u0026rsquo;s operations may be cached for.   HONO_REGISTRY_SVC_FILENAME\n--hono.registry.svc.filename no /var/lib/hono/device-registry/\ndevice-identities.json The path to the file where the server stores identities of registered devices. Hono tries to read device identities from this file during start-up and writes out all identities to this file periodically if property HONO_REGISTRY_SVC_SAVE_TO_FILE is set to true.\nPlease refer to Device Identities File Format for details regarding the file\u0026rsquo;s format.   HONO_REGISTRY_SVC_MAX_DEVICES_PER_TENANT\n--hono.registry.svc.maxDevicesPerTenant no 100 The number of devices that can be registered for each tenant. It is an error to set this property to a value \u0026lt;= 0.   HONO_REGISTRY_SVC_MODIFICATION_ENABLED\n--hono.registry.svc.modificationEnabled no true When set to false the device information contained in the registry cannot be updated nor removed from the registry.   HONO_REGISTRY_SVC_RECEIVER_LINK_CREDIT\n--hono.registry.svc.receiverLinkCredit no 100 The number of credits to flow to a client connecting to the Device Registration endpoint.   HONO_REGISTRY_SVC_SAVE_TO_FILE\n--hono.registry.svc.saveToFile no false When set to true the server will periodically write out the registered device information to the file specified by the HONO_REGISTRY_SVC_FILENAME property.   HONO_REGISTRY_SVC_SIGNING_KEY_PATH\n--hono.registry.svc.signing.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the server should use for signing tokens asserting a device\u0026rsquo;s registration status. When using this variable, other services that need to validate the tokens issued by this service need to be configured with the corresponding certificate/public key. Alternatively, a symmetric key can be used for signing (and validating) by setting the HONO_REGISTRY_SVC_SIGNING_SHARED_SECRET variable. If none of these variables is set, the server falls back to the key indicated by the HONO_REGISTRY_AMP_KEY_PATH variable. If that variable is also not set, startup of the server fails.   HONO_REGISTRY_SVC_SIGNING_SHARED_SECRET\n--hono.registry.svc.signing.sharedSecret no - A string to derive a symmetric key from that is used for signing tokens asserting a device\u0026rsquo;s registration status. The key is derived from the string by using the bytes of the String\u0026rsquo;s UTF8 encoding. When setting the signing key using this variable, other services that need to validate the tokens issued by this service need to be configured with the same key. Alternatively, an asymmetric key pair can be used for signing (and validating) by setting the HONO_REGISTRY_SVC_SIGNING_KEY_PATH variable. If none of these variables is set, startup of the server fails.   HONO_REGISTRY_SVC_SIGNING_TOKEN_EXPIRATION\n--hono.registry.svc.signing.tokenExpiration no 10 The expiration period to use for the tokens asserting the registration status of devices.   HONO_REGISTRY_SVC_STARTEMPTY\n--hono.registry.svc.startEmpty no false When set to true the server will not try to load device identities from the file specified by the HONO_REGISTRY_SVC_FILENAME property during startup.   HONO_TENANT_SVC_CACHE_MAX_AGE\n--hono.tenant.svc.cacheMaxAge no 180 The maximum period of time (seconds) that information returned by the service\u0026rsquo;s operations may be cached for.   HONO_TENANT_SVC_FILENAME\n--hono.tenant.svc.filename no /var/lib/hono/device-registry/\ntenants.json The path to the file where the server stores tenants. Hono tries to read tenants from this file during start-up and writes out all identities to this file periodically if property HONO_TENANT_SVC_SAVE_TO_FILE is set to true.\nPlease refer to Tenants File Format for details regarding the file\u0026rsquo;s format.   HONO_TENANT_SVC_MODIFICATION_ENABLED\n--hono.tenant.svc.modificationEnabled no true When set to false the tenants contained in the registry cannot be updated nor removed.   HONO_TENANT_SVC_RECEIVER_LINK_CREDIT\n--hono.tenant.svc.receiverLinkCredit no 100 The number of credits to flow to a client connecting to the Tenant endpoint.   HONO_TENANT_SVC_SAVE_TO_FILE\n--hono.tenant.svc.saveToFile no false When set to true the server will periodically write out the registered tenants to the file specified by the HONO_TENANTS_SVC_TENANT_FILENAME property.   HONO_TENANT_SVC_STARTEMPTY\n--hono.tenant.svc.startEmpty no false When set to true the server will not try to load tenants from the file specified by the HONO_TENANT_SVC_FILENAME property during startup.    The variables only need to be set if the default value does not match your environment.\nPort Configuration The Device Registry supports configuration of both, an AMQP based endpoint as well as an HTTP based endpoint proving RESTful resources for managing registration information and credentials. Both endpoints can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The server will fail to start if none of the ports is configured properly.\nThe following sections apply to configuring both, the AMQP endpoint as well as the REST endpoint. The environment variables to use for configuring the REST endpoint are the same as the ones for the AMQP endpoint, substituting _AMQP_ with _REST_, e.g. HONO_REGISTRY_REST_KEY_PATH instead of HONO_REGISTRY_AMQP_KEY_PATH.\nSecure Port Only The server needs to be configured with a private key and certificate in order to open a TLS secured port.\nThere are two alternative ways for doing so:\n Setting the HONO_REGISTRY_AMQP_KEY_STORE_PATH and the HONO_REGISTRY_AMQP_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_REGISTRY_AMQP_KEY_PATH and HONO_REGISTRY_AMQP_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  When starting up, the server will bind a TLS secured socket to the default secure AMQP port 5671. The port number can also be set explicitly using the HONO_REGISTRY_AMQP_PORT variable.\nThe HONO_REGISTRY_AMQP_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_REGISTRY_AMQP_INSECURE_PORT to a valid port number, or by implicitly configuring the default AMQP port (5672) by simply setting HONO_REGISTRY_AMQP_INSECURE_PORT_ENABLED to true.  The server issues a warning on the console if HONO_REGISTRY_AMQP_INSECURE_PORT is set to the default secure AMQP port (5671).\nThe HONO_REGISTRY_AMQP_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port In test setups and some production scenarios Hono server may be configured to open one secure and one insecure port at the same time.\nThis is achieved by configuring both ports correctly (see above). The server will fail to start if both ports are configured to use the same port number.\nSince the secure port may need different visibility in the network setup compared to the secure port, it has it\u0026rsquo;s own binding address HONO_REGISTRY_AMQP_INSECURE_PORT_BIND_ADDRESS. This can be used to narrow the visibility of the insecure port to a local network e.g., while the secure port may be visible worldwide.\nEphemeral Ports The server may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nAuthentication Service Connection Configuration The Device Registry requires a connection to an implementation of Hono\u0026rsquo;s Authentication API in order to authenticate and authorize client requests.\nThe connection is configured according to Hono Client Configuration where the ${PREFIX} is set to HONO_AUTH. Since Hono\u0026rsquo;s Authentication Service does not allow caching of the responses, the cache properties can be ignored.\nIn addition to the standard client configuration properties, following properties may be set for the connection:\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_AUTH_VALIDATION_CERT_PATH\n--hono.auth.validation.certPath no - The absolute path to the PEM file containing the an X.509 certificate that the service should use for validating tokens issued by the Authentication service. Alternatively, a symmetric key can be used for validating tokens by setting the HONO_AUTH_VALIDATION_SHARED_SECRET variable. If none of these variables is set, startup of the service fails.   HONO_AUTH_VALIDATION_SHARED_SECRET\n--hono.auth.validation.sharedSecret no - A string to derive a symmetric key from which is used for validating tokens issued by the Authentication service. The key is derived from the string by using the bytes of the String\u0026rsquo;s UTF8 encoding. When setting the validation key using this variable, the Authentication service must be configured with the same key. Alternatively, an X.509 certificate can be used for validating tokens by setting the HONO_AUTH_VALIDATION_CERT_PATH variable. If none of these variables is set, startup of the service fails.   HONO_AUTH_SUPPORTED_SASL_MECHANISMS\n--hono.auth.supportedSaslMechanisms no EXTERNAL, PLAIN A (comma separated) list of the SASL mechanisms that the device registry should offer to clients for authentication. This option may be set to specify only one of EXTERNAL or PLAIN, or to use a different order.    Metrics Configuration See Monitoring \u0026amp; Tracing Admin Guide for details on how to configure the reporting of metrics.\nDevice Identities File Format The Device Registry supports persisting the device identities and their registration information to a JSON file in the local file system. The Getting started Guide includes an example configuration which illustrates the file format used. The configuration file\u0026rsquo;s location is /deploy/src/main/deploy/example-device-identities.json.\nCredentials File Format The Device Registry supports persisting the devices\u0026rsquo; credentials to a JSON file in the local file system. The Getting started Guide includes an example configuration which illustrates the file format used. The configuration file\u0026rsquo;s location is /deploy/src/main/deploy/example-credentials.json.\nTenants File Format The Device Registry supports persisting tenants to a JSON file in the local file system. The configuration file\u0026rsquo;s location is /deploy/src/main/deploy/example-tenants.json.\nConfiguring Gateway Devices The Device Registry supports devices to act on behalf of other devices. This is particularly useful for cases where a device does not connect directly to a Hono protocol adapter but is connected to a gateway component that is usually specific to the device\u0026rsquo;s communication protocol. It is the gateway component which then connects to a Hono protocol adapter and publishes data on behalf of the device(s). Examples of such a set up include devices using SigFox or LoRa for communication.\nIn these cases the protocol adapter will authenticate the gateway component instead of the device for which it wants to publish data. In order to verify that the gateway is authorized to publish data on behalf of the particular device, the protocol adapter should include the gateway\u0026rsquo;s device identifier (as determined during the authentication process) in its invocation of the Device Registration API\u0026rsquo;s assert Device Registration operation.\nThe Device Registry will then do the following: 1. Verify that the device exists and is enabled. 2. Verify that the gateway exists and is enabled. 3. Verify that the device\u0026rsquo;s registration information contains a property called via and that its value is either the gateway\u0026rsquo;s device identifier or a JSON array which contains the gateway\u0026rsquo;s device identifier as one of its values.\nOnly if all conditions are met, the Device Registry returns an assertion of the device\u0026rsquo;s registration status. The protocol adapter can then forward the published data to the AMQP Messaging Network in the same way as for any device that connects directly to the adapter.\nThe example configuration file (located at /deploy/src/main/deploy/example-device-identities.json) includes a device and a corresponding gateway configured in this way.\n"
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/admin-guide/device-connection-config/",
 	"title": "Configuring the Device Connection Service",
 	"tags": [],
 	"description": "",
-	"content": "The Device Connection service provides an implementation of Eclipse Hono\u0026trade;\u0026rsquo;s Device Connection API.\nProtocol adapters use this API to store and retrieve information about the gateway that a device is using to connect to Hono\u0026rsquo;s protocol adapters. This information is necessary for routing commands to the particular protocol adapter instance that the gateway used by the device is connected to.\nThe Device Connection component provides a production grade implementation of the Device Connection API which uses a remote data grid for storing information about device connections. The data grid can be scaled out independently from the Device Connection service components to meet the storage demands at hand.\nThe Device Connection component is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nService Configuration In addition to the following options, this component supports the options described in Common Configuration.\nThe following table provides an overview of the configuration variables and corresponding command line options for configuring the Device Connection component.\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_APP_MAX_INSTANCES\n--hono.app.maxInstances no #CPU cores The number of Verticle instances to deploy. If not set, one Verticle per processor core is deployed.   HONO_DEVICECONNECTION_AMQP_BIND_ADDRESS\n--hono.registry.amqp.bindAddress no 127.0.0.1 The IP address of the network interface that the secure AMQP port should be bound to.\nSee Port Configuration below for details.   HONO_DEVICECONNECTION_AMQP_CERT_PATH\n--hono.deviceConnection.amqp.certPath no - The absolute path to the PEM file containing the certificate that the server should use for authenticating to clients. This option must be used in conjunction with HONO_DEVICECONNECTION_AMQP_KEY_PATH.\nAlternatively, the HONO_DEVICECONNECTION_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_DEVICECONNECTION_AMQP_INSECURE_PORT\n--hono.deviceConnection.amqp.insecurePort no - The insecure port the server should listen on for AMQP 1.0 connections.\nSee Port Configuration below for details.   HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_BIND_ADDRESS\n--hono.deviceConnection.amqp.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure AMQP port should be bound to.\nSee Port Configuration below for details.   HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_ENABLED\n--hono.deviceConnection.amqp.insecurePortEnabled no false If set to true the server will open an insecure port (not secured by TLS) using either the port number set via HONO_REGISTRY_AMQP_INSECURE_PORT or the default AMQP port number (5672) if not set explicitly.\nSee Port Configuration below for details.   HONO_DEVICECONNECTION_AMQP_KEY_PATH\n--hono.deviceConnection.amqp.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the server should use for authenticating to clients. This option must be used in conjunction with HONO_DEVICECONNECTION_AMQP_CERT_PATH. Alternatively, the HONO_DEVICECONNECTION_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_DEVICECONNECTION_AMQP_KEY_STORE_PASSWORD\n--hono.deviceConnection.amqp.keyStorePassword no - The password required to read the contents of the key store.   HONO_DEVICECONNECTION_AMQP_KEY_STORE_PATH\n--hono.deviceConnection.amqp.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the server should use for authenticating to clients. Either this option or the HONO_DEVICECONNECTION_AMQP_KEY_PATH and HONO_DEVICECONNECTION_AMQP_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_DEVICECONNECTION_AMQP_NATIVE_TLS_REQUIRED\n--hono.deviceConnection.amqp.nativeTlsRequired no false The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_DEVICECONNECTION_AMQP_PORT\n--hono.deviceConnection.amqp.port no 5671 The secure port that the server should listen on for AMQP 1.0 connections.\nSee Port Configuration below for details.   HONO_DEVICECONNECTION_AMQP_RECEIVER_LINK_CREDIT\n--hono.deviceConnection.amqp.receiverLinkCredit no 100 The number of credits to flow to a client connecting to the service\u0026rsquo;s AMQP endpoint.   HONO_DEVICECONNECTION_AMQP_SECURE_PROTOCOLS\n--hono.deviceConnection.amqp.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.    The variables only need to be set if the default value does not match your environment.\nPort Configuration The Device Connection component supports configuration of both, an AMQP based endpoint as well as an HTTP based endpoint proving RESTful resources for managing registration information and credentials. Both endpoints can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The server will fail to start if none of the ports is configured properly.\nSecure Port Only The server needs to be configured with a private key and certificate in order to open a TLS secured port.\nThere are two alternative ways for doing so:\n Setting the HONO_DEVICECONNECTION_AMQP_KEY_STORE_PATH and the HONO_DEVICECONNECTION_AMQP_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_DEVICECONNECTION_AMQP_KEY_PATH and HONO_DEVICECONNECTION_AMQP_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  When starting up, the server will bind a TLS secured socket to the default secure AMQP port 5671. The port number can also be set explicitly using the HONO_DEVICECONNECTION_AMQP_PORT variable.\nThe HONO_DEVICECONNECTION_AMQP_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_DEVICECONNECTION_AMQP_INSECURE_PORT to a valid port number, or by implicitly configuring the default AMQP port (5672) by simply setting HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_ENABLED to true.  The server issues a warning on the console if HONO_DEVICECONNECTION_AMQP_INSECURE_PORT is set to the default secure AMQP port (5671).\nThe HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port In test setups and some production scenarios Hono server may be configured to open one secure and one insecure port at the same time.\nThis is achieved by configuring both ports correctly (see above). The server will fail to start if both ports are configured to use the same port number.\nSince the secure port may need different visibility in the network setup compared to the secure port, it has it\u0026rsquo;s own binding address HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_BIND_ADDRESS. This can be used to narrow the visibility of the insecure port to a local network e.g., while the secure port may be visible worldwide.\nEphemeral Ports The server may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nData Grid Connection Configuration The Device Connection component requires a connection to a remote data grid using the Infinispan Hotrod protocol to store device connection information in.\nThe following table provides an overview of the configuration variables and corresponding command line options for configuring the connection to the data grid:\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_DEVICECONNECTION_REMOTE_SERVER_LIST\n--hono.deviceConnection.remote.serverList yes - A list of remote servers in the form: host1[:port][;host2[:port]].....   HONO_DEVICECONNECTION_REMOTE_AUTH_SERVER_NAME\n--hono.deviceConnection.remote.authServerName yes - The server name to indicate in the SASL handshake when authenticating to the server.   HONO_DEVICECONNECTION_REMOTE_AUTH_USERNAME\n--hono.deviceConnection.remote.authUsername yes - The username to use for authenticating to the server.   HONO_DEVICECONNECTION_REMOTE_AUTH_PASSWORD\n--hono.deviceConnection.remote.authPassword yes - The password to use for authenticating to the server.    In general, the service supports all configuration properties of the Infinispan Hotrod client using hono.deviceConnection.remote instead of the infinispan.client.hotrod prefix.\nAuthentication Service Connection Configuration The Device Connection component requires a connection to an implementation of Hono\u0026rsquo;s Authentication API in order to authenticate and authorize client requests.\nThe connection is configured according to Hono Client Configuration where the ${PREFIX} is set to HONO_AUTH. Since Hono\u0026rsquo;s Authentication Service does not allow caching of the responses, the cache properties can be ignored.\nIn addition to the standard client configuration properties, following properties need to be set for the connection:\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_AUTH_VALIDATION_CERT_PATH\n--hono.auth.validation.certPath no - The absolute path to the PEM file containing the public key that the service should use for validating tokens issued by the Authentication service. Alternatively, a symmetric key can be used for validating tokens by setting the HONO_AUTH_VALIDATION_SHARED_SECRET variable. If none of these variables is set, the service falls back to the key indicated by the HONO_AUTH_CERT_PATH variable. If that variable is also not set, startup of the service fails.   HONO_AUTH_VALIDATION_SHARED_SECRET\n--hono.auth.validation.sharedSecret no - A string to derive a symmetric key from which is used for validating tokens issued by the Authentication service. The key is derived from the string by using the bytes of the String\u0026rsquo;s UTF8 encoding. When setting the validation key using this variable, the Authentication service must be configured with the same key. Alternatively, an asymmetric key pair can be used for validating (and signing) by setting the HONO_AUTH_SIGNING_CERT_PATH variable. If none of these variables is set, startup of the service fails.    Metrics Configuration See Monitoring \u0026amp; Tracing Admin Guide for details on how to configure the reporting of metrics.\n"
+	"content": "The Device Connection service provides an implementation of Eclipse Hono\u0026trade;\u0026rsquo;s Device Connection API.\nProtocol adapters use this API to store and retrieve information about the gateway that a device is using to connect to Hono\u0026rsquo;s protocol adapters. This information is necessary for routing commands to the particular protocol adapter instance that the gateway used by the device is connected to.\nThe Device Connection component provides a production grade implementation of the Device Connection API which uses a remote data grid for storing information about device connections. The data grid can be scaled out independently from the Device Connection service components to meet the storage demands at hand.\nThe Device Connection component is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nService Configuration In addition to the following options, this component supports the options described in Common Configuration.\nThe following table provides an overview of the configuration variables and corresponding command line options for configuring the Device Connection component.\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_APP_MAX_INSTANCES\n--hono.app.maxInstances no #CPU cores The number of Verticle instances to deploy. If not set, one Verticle per processor core is deployed.   HONO_DEVICECONNECTION_AMQP_BIND_ADDRESS\n--hono.registry.amqp.bindAddress no 127.0.0.1 The IP address of the network interface that the secure AMQP port should be bound to.\nSee Port Configuration below for details.   HONO_DEVICECONNECTION_AMQP_CERT_PATH\n--hono.deviceConnection.amqp.certPath no - The absolute path to the PEM file containing the certificate that the server should use for authenticating to clients. This option must be used in conjunction with HONO_DEVICECONNECTION_AMQP_KEY_PATH.\nAlternatively, the HONO_DEVICECONNECTION_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_DEVICECONNECTION_AMQP_INSECURE_PORT\n--hono.deviceConnection.amqp.insecurePort no - The insecure port the server should listen on for AMQP 1.0 connections.\nSee Port Configuration below for details.   HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_BIND_ADDRESS\n--hono.deviceConnection.amqp.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure AMQP port should be bound to.\nSee Port Configuration below for details.   HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_ENABLED\n--hono.deviceConnection.amqp.insecurePortEnabled no false If set to true the server will open an insecure port (not secured by TLS) using either the port number set via HONO_REGISTRY_AMQP_INSECURE_PORT or the default AMQP port number (5672) if not set explicitly.\nSee Port Configuration below for details.   HONO_DEVICECONNECTION_AMQP_KEY_PATH\n--hono.deviceConnection.amqp.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the server should use for authenticating to clients. This option must be used in conjunction with HONO_DEVICECONNECTION_AMQP_CERT_PATH. Alternatively, the HONO_DEVICECONNECTION_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_DEVICECONNECTION_AMQP_KEY_STORE_PASSWORD\n--hono.deviceConnection.amqp.keyStorePassword no - The password required to read the contents of the key store.   HONO_DEVICECONNECTION_AMQP_KEY_STORE_PATH\n--hono.deviceConnection.amqp.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the server should use for authenticating to clients. Either this option or the HONO_DEVICECONNECTION_AMQP_KEY_PATH and HONO_DEVICECONNECTION_AMQP_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_DEVICECONNECTION_AMQP_NATIVE_TLS_REQUIRED\n--hono.deviceConnection.amqp.nativeTlsRequired no false The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_DEVICECONNECTION_AMQP_PORT\n--hono.deviceConnection.amqp.port no 5671 The secure port that the server should listen on for AMQP 1.0 connections.\nSee Port Configuration below for details.   HONO_DEVICECONNECTION_AMQP_RECEIVER_LINK_CREDIT\n--hono.deviceConnection.amqp.receiverLinkCredit no 100 The number of credits to flow to a client connecting to the service\u0026rsquo;s AMQP endpoint.   HONO_DEVICECONNECTION_AMQP_SECURE_PROTOCOLS\n--hono.deviceConnection.amqp.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.    The variables only need to be set if the default value does not match your environment.\nPort Configuration The Device Connection component supports configuration of both, an AMQP based endpoint as well as an HTTP based endpoint proving RESTful resources for managing registration information and credentials. Both endpoints can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The server will fail to start if none of the ports is configured properly.\nSecure Port Only The server needs to be configured with a private key and certificate in order to open a TLS secured port.\nThere are two alternative ways for doing so:\n Setting the HONO_DEVICECONNECTION_AMQP_KEY_STORE_PATH and the HONO_DEVICECONNECTION_AMQP_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_DEVICECONNECTION_AMQP_KEY_PATH and HONO_DEVICECONNECTION_AMQP_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  When starting up, the server will bind a TLS secured socket to the default secure AMQP port 5671. The port number can also be set explicitly using the HONO_DEVICECONNECTION_AMQP_PORT variable.\nThe HONO_DEVICECONNECTION_AMQP_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_DEVICECONNECTION_AMQP_INSECURE_PORT to a valid port number, or by implicitly configuring the default AMQP port (5672) by simply setting HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_ENABLED to true.  The server issues a warning on the console if HONO_DEVICECONNECTION_AMQP_INSECURE_PORT is set to the default secure AMQP port (5671).\nThe HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port In test setups and some production scenarios Hono server may be configured to open one secure and one insecure port at the same time.\nThis is achieved by configuring both ports correctly (see above). The server will fail to start if both ports are configured to use the same port number.\nSince the secure port may need different visibility in the network setup compared to the secure port, it has it\u0026rsquo;s own binding address HONO_DEVICECONNECTION_AMQP_INSECURE_PORT_BIND_ADDRESS. This can be used to narrow the visibility of the insecure port to a local network e.g., while the secure port may be visible worldwide.\nEphemeral Ports The server may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nData Grid Connection Configuration The Device Connection component requires either an embedded cache or a remote data grid, using the Infinispan Hotrod protocol to store device information.\nThe following table provides an overview of the configuration variables and corresponding command line options for configuring the common aspects of the service:\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_DEVICECONNECTION_COMMON_CACHENAME\n--hono.deviceConnection.common.cacheName no device-connection The name of the cache   HONO_DEVICECONNECTION_COMMON_CHECKKEY\n--hono.deviceConnection.common.checkKey no KEY_CONNECTION_CHECK The key used to check the health of the cache.   HONO_DEVICECONNECTION_COMMON_CHECKVALUE\n--hono.deviceConnection.common.checkValue no VALUE_CONNECTION_CHECK The value used to check the health of the cache.    The type of the cache is selected on startup by enabling or disabling the profile embedded-cache. If the profile is enabled the embedded cache is used, otherwise the remote cache is being used. The remote cache is the default.\nRemote cache The following table provides an overview of the configuration variables and corresponding command line options for configuring the connection to the data grid:\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_DEVICECONNECTION_REMOTE_SERVERLIST\n--hono.deviceConnection.remote.serverList yes - A list of remote servers in the form: host1[:port][;host2[:port]].....   HONO_DEVICECONNECTION_REMOTE_AUTHSERVERNAME\n--hono.deviceConnection.remote.authServerName yes - The server name to indicate in the SASL handshake when authenticating to the server.   HONO_DEVICECONNECTION_REMOTE_AUTHREALM\n--hono.deviceConnection.remote.authRealm yes - The authentication realm for the SASL handshake when authenticating to the server.   HONO_DEVICECONNECTION_REMOTE_AUTHUSERNAME\n--hono.deviceConnection.remote.authUsername yes - The username to use for authenticating to the server.   HONO_DEVICECONNECTION_REMOTE_AUTHPASSWORD\n--hono.deviceConnection.remote.authPassword yes - The password to use for authenticating to the server.    In general, the service supports all configuration properties of the Infinispan Hotrod client using hono.deviceConnection.remote instead of the infinispan.client.hotrod prefix.\nEmbedded cache The following table provides an overview of the configuration variables and corresponding command line options for configuring the embedded cache:\nhono.device-connection.embedded.configuration-file\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_DEVICECONNECTION_EMBEDDED_CONFIGURATIONFILE\n--hono.deviceConnection.embedded.configurationFile yes - The absolute path to an Infinispan configuration file. Also see the Infinispan Configuration Schema.    Authentication Service Connection Configuration The Device Connection component requires a connection to an implementation of Hono\u0026rsquo;s Authentication API in order to authenticate and authorize client requests.\nThe connection is configured according to Hono Client Configuration where the ${PREFIX} is set to HONO_AUTH. Since Hono\u0026rsquo;s Authentication Service does not allow caching of the responses, the cache properties can be ignored.\nIn addition to the standard client configuration properties, following properties need to be set for the connection:\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_AUTH_VALIDATION_CERT_PATH\n--hono.auth.validation.certPath no - The absolute path to the PEM file containing the public key that the service should use for validating tokens issued by the Authentication service. Alternatively, a symmetric key can be used for validating tokens by setting the HONO_AUTH_VALIDATION_SHARED_SECRET variable. If none of these variables is set, the service falls back to the key indicated by the HONO_AUTH_CERT_PATH variable. If that variable is also not set, startup of the service fails.   HONO_AUTH_VALIDATION_SHARED_SECRET\n--hono.auth.validation.sharedSecret no - A string to derive a symmetric key from which is used for validating tokens issued by the Authentication service. The key is derived from the string by using the bytes of the String\u0026rsquo;s UTF8 encoding. When setting the validation key using this variable, the Authentication service must be configured with the same key. Alternatively, an asymmetric key pair can be used for validating (and signing) by setting the HONO_AUTH_SIGNING_CERT_PATH variable. If none of these variables is set, startup of the service fails.    Metrics Configuration See Monitoring \u0026amp; Tracing Admin Guide for details on how to configure the reporting of metrics.\n"
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/admin-guide/http-adapter-config/",
 	"title": "HTTP Adapter Configuration",
 	"tags": [],
 	"description": "",
-	"content": "The HTTP protocol adapter exposes a HTTP based API for Eclipse Hono\u0026trade;\u0026rsquo;s Telemetry and Event endpoints.\nThe adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nThe adapter supports the following standard configuration options:\n Common Java VM Options Common vert.x Options Common Protocol Adapter Options Monitoring Options  Service Configuration The following table provides an overview of the configuration variables and corresponding command line options for configuring the HTTP adapter.\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_APP_MAX_INSTANCES\n--hono.app.maxInstances no #CPU cores The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.   HONO_HTTP_AUTHENTICATION_REQUIRED\n--hono.http.authenticationRequired no true If set to true the protocol adapter requires devices to authenticate when connecting to the adapter. The credentials provided by the device are verified using the configured Credentials Service. Devices that have failed to authenticate are not allowed to publish any data.   HONO_HTTP_BIND_ADDRESS\n--hono.http.bindAddress no 127.0.0.1 The IP address of the network interface that the secure port should be bound to.\nSee Port Configuration below for details.   HONO_HTTP_CERT_PATH\n--hono.http.certPath no - The absolute path to the PEM file containing the certificate that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_HTTP_KEY_PATH.\nAlternatively, the HONO_HTTP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_HTTP_DEFAULTS_ENABLED\n--hono.http.defaultsEnabled no true If set to true the protocol adapter uses default values registered for a device to augment messages published by the device with missing information like a content type. In particular, the protocol adapter adds default values registered for the device as (application) properties with the same name to the AMQP 1.0 messages it sends downstream to the AMQP Messaging Network.   HONO_HTTP_INSECURE_PORT\n--hono.http.insecurePort no - The insecure port the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_HTTP_INSECURE_PORT_BIND_ADDRESS\n--hono.http.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure port should be bound to.\nSee Port Configuration below for details.   HONO_HTTP_INSECURE_PORT_ENABLED\n--hono.http.insecurePortEnabled no false If set to true the protocol adapter will open an insecure port (not secured by TLS) using either the port number set via HONO_HTTP_INSECURE_PORT or the default port number (8080) if not set explicitly.\nSee Port Configuration below for details.   HONO_HTTP_KEY_PATH\n--hono.http.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_HTTP_CERT_PATH. Alternatively, the HONO_HTTP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_HTTP_KEY_STORE_PASSWORD\n--hono.http.keyStorePassword no - The password required to read the contents of the key store.   HONO_HTTP_KEY_STORE_PATH\n--hono.http.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the protocol adapter should use for authenticating to clients. Either this option or the HONO_HTTP_KEY_PATH and HONO_HTTP_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_HTTP_SNI\n--hono.http.sni no false Set whether the server supports Server Name Indication. By default, the server will not support SNI and the option is false. However, if set to true then the key store format , HONO_HTTP_KEY_STORE_PATH, should be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_HTTP_NATIVE_TLS_REQUIRED\n--hono.http.nativeTlsRequired no false The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_HTTP_MAX_PAYLOAD_SIZE\n--hono.http.maxPayloadSize no 2048 The maximum allowed size of an incoming HTTP request\u0026rsquo;s body in bytes. Requests with a larger body size are rejected with a 413 Request entity too large response.   HONO_HTTP_PORT\n--hono.http.port no 8443 The secure port that the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_HTTP_REALM\n--hono.http.realm no Hono The name of the realm that unauthenticated devices are prompted to provide credentials for. The realm is used in the WWW-Authenticate header returned to devices in response to unauthenticated requests.   HONO_HTTP_SECURE_PROTOCOLS\n--hono.http.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   HONO_HTTP_TENANT_IDLE_TIMEOUT\n--hono.http.tenantIdleTimeout no 0ms The duration after which the protocol adapter removes local state of the tenant (e.g. open AMQP links) with an amount and a unit, e.g. 2h for 2 hours. See the Spring Boot documentation for an explanation of the format. The value 0ms disables the timeout.    The variables only need to be set if the default value does not match your environment.\nPort Configuration The HTTP protocol adapter can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The HTTP protocol adapter will fail to start if none of the ports is configured properly.\nSecure Port Only The protocol adapter needs to be configured with a private key and certificate in order to open a TLS secured port.\nThere are two alternative ways for doing so:\n Setting the HONO_HTTP_KEY_STORE_PATH and the HONO_HTTP_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_HTTP_KEY_PATH and HONO_HTTP_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  When starting up, the protocol adapter will bind a TLS secured socket to the default secure port 8443. The port number can also be set explicitly using the HONO_HTTP_PORT variable.\nThe HONO_HTTP_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_HTTP_INSECURE_PORT to a valid port number, or by implicitly configuring the default port (8080) by simply setting HONO_HTTP_INSECURE_PORT_ENABLED to true.  The protocol adapter issues a warning on the console if HONO_HTTP_INSECURE_PORT is set to the default secure HTTP port (8443).\nThe HONO_HTTP_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port The protocol adapter may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nEphemeral Ports Both the secure as well as the insecure port numbers may be explicitly set to 0. The protocol adapter will then use arbitrary (unused) port numbers determined by the operating system during startup.\n"
-},
-{
-	"uri": "https://www.eclipse.org/hono/docs/admin-guide/amqp-adapter-config/",
-	"title": "AMQP Adapter Configuration",
-	"tags": [],
-	"description": "",
-	"content": "The AMQP protocol adapter allows clients (devices and gateway components) that speaks AMQP 1.0 to publish telemetry messages and events to Eclipse Hono\u0026trade;\u0026rsquo;s Telemetry and Event endpoints.\nThe adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nThe adapter supports the following standard configuration options:\n Common Java VM Options Common vert.x Options Common Protocol Adapter Options Monitoring Options  Service Configuration The following table provides an overview of the configuration variables and corresponding command line options for configuring the AMQP adapter.\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     HONO_AMQP_AUTHENTICATION_REQUIRED\n--hono.amqp.authenticationRequired no true If set to true the protocol adapter requires devices to authenticate when connecting to the adapter. The credentials provided by the device are verified using the configured Credentials Service. Devices that have failed to authenticate are not allowed to publish any data.   HONO_AMQP_BIND_ADDRESS\n--hono.amqp.bindAddress no 127.0.0.1 The IP address of the network interface that the secure port should be bound to.\nSee Port Configuration below for details.   HONO_AMQP_CERT_PATH\n--hono.amqp.certPath no - The absolute path to the PEM file containing the certificate that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_AMQP_KEY_PATH.\nAlternatively, the HONO_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_AMQP_DEFAULTS_ENABLED\n--hono.amqp.defaultsEnabled no true If set to true the protocol adapter uses default values registered for a device to augment messages published by the device with missing information like a content type. In particular, the protocol adapter adds default values registered for the device as (application) properties with the same name to the AMQP 1.0 messages it sends downstream to the AMQP Messaging Network.   HONO_AMQP_IDLE_TIMEOUT\n--hono.amqp.idleTimeout no 60000 The time interval (milliseconds) to wait for incoming traffic from a device before the connection should be considered stale and thus be closed. Setting this property to 0 prevents the adapter from detecting and closing stale connections.   HONO_AMQP_INSECURE_PORT_BIND_ADDRESS\n--hono.amqp.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure port should be bound to.\nSee Port Configuration below for details.   HONO_AMQP_INSECURE_PORT\n--hono.amqp.insecurePort no 5672 The port number that the protocol adapter should listen on for insecure connections.\nSee Port Configuration below for details.   HONO_AMQP_INSECURE_PORT_ENABLED\n--hono.amqp.insecurePortEnabled no false If set to true the protocol adapter will open an insecure port (not secured by TLS) using either the port number set via HONO_AMQP_INSECURE_PORT or the default AMQP port number (1883) if not set explicitly.\nSee Port Configuration below for details.   HONO_AMQP_KEY_PATH\n--hono.amqp.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_AMQP_CERT_PATH. Alternatively, the HONO_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_AMQP_KEY_STORE_PASSWORD\n--hono.amqp.keyStorePassword no - The password required to read the contents of the key store.   HONO_AMQP_KEY_STORE_PATH\n--hono.amqp.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the protocol adapter should use for authenticating to clients. Either this option or the HONO_AMQP_KEY_PATH and HONO_AMQP_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_AMQP_SNI\n--hono.amqp.sni no false Set whether the server supports Server Name Indication. By default, the server will not support SNI and the option is false. However, if set to true then the key store format, HONO_AMQP_KEY_STORE_PATH, should be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_AMQP_MAX_CONNECTIONS\n--hono.amqp.maxConnections no 0 The maximum number of concurrent connections that the protocol adapter should accept. If not set (or set to 0), the protocol adapter determines a reasonable value based on the available resources like memory and CPU.   HONO_AMQP_MAX_FRAME_SIZE\n--hono.amqp.maxFrameSize no 16384 The maximum number of bytes that can be sent in an AMQP message delivery over the connection with a device. When a client sends an AMQP frame of larger size, the connection is closed.   HONO_AMQP_MAX_PAYLOAD_SIZE\n--hono.amqp.maxPayloadSize no 2048 The maximum allowed size of an incoming AMQP message in bytes. When a client sends a message with a larger payload, the message is discarded and the link to the client is closed.   HONO_AMQP_MAX_SESSION_FRAMES\n--hono.amqp.maxSessionFrames no 30 The maximum number of AMQP transfer frames for sessions created on this connection. This is the number of transfer frames that may simultaneously be in flight for all links in the session.   HONO_AMQP_NATIVE_TLS_REQUIRED\n--hono.amqp.nativeTlsRequired no false The server will probe for OpenSSL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_AMQP_PORT\n--hono.amqp.port no 5671 The secure port that the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_AMQP_SECURE_PROTOCOLS\n--hono.amqp.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   HONO_AMQP_TENANT_IDLE_TIMEOUT\n--hono.amqp.tenantIdleTimeout no 0ms The duration after which the protocol adapter removes local state of the tenant (e.g. open AMQP links) with an amount and a unit, e.g. 2h for 2 hours. See the Spring Boot documentation for an explanation of the format. The value 0ms disables the timeout.   HONO_APP_MAX_INSTANCES\n--hono.app.maxInstances no #CPU cores The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.    The variables only need to be set if the default values do not match your environment.\nPort Configuration The AMQP protocol adapter can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The AMQP protocol adapter will fail to start if none of the ports is configured properly.\nSecure Port Only The protocol adapter needs to be configured with a private key and certificate in order to open a TLS secured port.\nThere are two alternative ways for doing so:\n either setting the HONO_AMQP_KEY_STORE_PATH and the HONO_AMQP_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_AMQP_KEY_PATH and HONO_AMQP_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  When starting up, the protocol adapter will bind a TLS secured socket to the default secure port 5671. The port number can also be set explicitly using the HONO_AMQP_PORT variable.\nThe HONO_AMQP_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_AMQP_INSECURE_PORT to a valid port number, or by implicitly configuring the default adapter port (5672) by simply setting HONO_AMQP_INSECURE_PORT_ENABLED to true.  The protocol adapter issues a warning on the console if HONO_AMQP_INSECURE_PORT is set to the default secure port (5671) used by the adapter for secure connections.\nThe HONO_AMQP_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port The protocol adapter may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nEphemeral Ports Both the secure as well as the insecure port numbers may be explicitly set to 0. The protocol adapter will then use arbitrary (unused) port numbers determined by the operating system during startup.\n"
+	"content": "The HTTP protocol adapter exposes HTTP based endpoints for Eclipse Hono\u0026trade;\u0026rsquo;s south bound Telemetry, Event and Command \u0026amp; Control APIs.\nThe adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nThe adapter supports the following standard configuration options:\n Common Java VM Options Common vert.x Options Common Protocol Adapter Options Monitoring Options  Service Configuration The following table provides an overview of the configuration variables and corresponding command line options for configuring the HTTP adapter.\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_APP_MAX_INSTANCES\n--hono.app.maxInstances no #CPU cores The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.   HONO_HTTP_AUTHENTICATION_REQUIRED\n--hono.http.authenticationRequired no true If set to true the protocol adapter requires devices to authenticate when connecting to the adapter. The credentials provided by the device are verified using the configured Credentials Service. Devices that have failed to authenticate are not allowed to publish any data.   HONO_HTTP_BIND_ADDRESS\n--hono.http.bindAddress no 127.0.0.1 The IP address of the network interface that the secure port should be bound to.\nSee Port Configuration below for details.   HONO_HTTP_CERT_PATH\n--hono.http.certPath no - The absolute path to the PEM file containing the certificate that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_HTTP_KEY_PATH.\nAlternatively, the HONO_HTTP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_HTTP_DEFAULTS_ENABLED\n--hono.http.defaultsEnabled no true If set to true the protocol adapter uses default values registered for a device to augment messages published by the device with missing information like a content type. In particular, the protocol adapter adds default values registered for the device as (application) properties with the same name to the AMQP 1.0 messages it sends downstream to the AMQP Messaging Network.   HONO_HTTP_INSECURE_PORT\n--hono.http.insecurePort no - The insecure port the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_HTTP_INSECURE_PORT_BIND_ADDRESS\n--hono.http.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure port should be bound to.\nSee Port Configuration below for details.   HONO_HTTP_INSECURE_PORT_ENABLED\n--hono.http.insecurePortEnabled no false If set to true the protocol adapter will open an insecure port (not secured by TLS) using either the port number set via HONO_HTTP_INSECURE_PORT or the default port number (8080) if not set explicitly.\nSee Port Configuration below for details.   HONO_HTTP_KEY_PATH\n--hono.http.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_HTTP_CERT_PATH. Alternatively, the HONO_HTTP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_HTTP_KEY_STORE_PASSWORD\n--hono.http.keyStorePassword no - The password required to read the contents of the key store.   HONO_HTTP_KEY_STORE_PATH\n--hono.http.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the protocol adapter should use for authenticating to clients. Either this option or the HONO_HTTP_KEY_PATH and HONO_HTTP_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_HTTP_SNI\n--hono.http.sni no false Set whether the server supports Server Name Indication. By default, the server will not support SNI and the option is false. However, if set to true then the key store format , HONO_HTTP_KEY_STORE_PATH, should be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_HTTP_NATIVE_TLS_REQUIRED\n--hono.http.nativeTlsRequired no false The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_HTTP_MAX_PAYLOAD_SIZE\n--hono.http.maxPayloadSize no 2048 The maximum allowed size of an incoming HTTP request\u0026rsquo;s body in bytes. Requests with a larger body size are rejected with a 413 Request entity too large response.   HONO_HTTP_PORT\n--hono.http.port no 8443 The secure port that the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_HTTP_REALM\n--hono.http.realm no Hono The name of the realm that unauthenticated devices are prompted to provide credentials for. The realm is used in the WWW-Authenticate header returned to devices in response to unauthenticated requests.   HONO_HTTP_SECURE_PROTOCOLS\n--hono.http.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   HONO_HTTP_TENANT_IDLE_TIMEOUT\n--hono.http.tenantIdleTimeout no 0ms The duration after which the protocol adapter removes local state of the tenant (e.g. open AMQP links) with an amount and a unit, e.g. 2h for 2 hours. See the Spring Boot documentation for an explanation of the format. The value 0ms disables the timeout.    The variables only need to be set if the default value does not match your environment.\nPort Configuration The HTTP protocol adapter can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The HTTP protocol adapter will fail to start if none of the ports is configured properly.\nSecure Port Only The protocol adapter needs to be configured with a private key and certificate in order to open a TLS secured port.\nThere are two alternative ways for doing so:\n Setting the HONO_HTTP_KEY_STORE_PATH and the HONO_HTTP_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_HTTP_KEY_PATH and HONO_HTTP_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  When starting up, the protocol adapter will bind a TLS secured socket to the default secure port 8443. The port number can also be set explicitly using the HONO_HTTP_PORT variable.\nThe HONO_HTTP_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_HTTP_INSECURE_PORT to a valid port number, or by implicitly configuring the default port (8080) by simply setting HONO_HTTP_INSECURE_PORT_ENABLED to true.  The protocol adapter issues a warning on the console if HONO_HTTP_INSECURE_PORT is set to the default secure HTTP port (8443).\nThe HONO_HTTP_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port The protocol adapter may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nEphemeral Ports Both the secure as well as the insecure port numbers may be explicitly set to 0. The protocol adapter will then use arbitrary (unused) port numbers determined by the operating system during startup.\n"
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/admin-guide/mqtt-adapter-config/",
 	"title": "MQTT Adapter Configuration",
 	"tags": [],
 	"description": "",
-	"content": "The MQTT protocol adapter exposes an MQTT topic hierarchy for publishing messages and events to Eclipse Hono\u0026trade;\u0026rsquo;s Telemetry and Event endpoints.\nThe adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nThe adapter supports the following standard configuration options:\n Common Java VM Options Common vert.x Options Common Protocol Adapter Options Monitoring Options  Service Configuration The following table provides an overview of the configuration variables and corresponding command line options for configuring the MQTT adapter.\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     HONO_APP_MAX_INSTANCES\n--hono.app.maxInstances no #CPU cores The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.   HONO_CONNECTION_EVENTS_PRODUCER\n--hono.connectionEvents.producer no logging The implementation of connection events producer which is to be used. This may be logging or events.\nSee Connection Events   HONO_MQTT_AUTHENTICATION_REQUIRED\n--hono.mqtt.authenticationRequired no true If set to true the protocol adapter requires devices to authenticate when connecting to the adapter. The credentials provided by the device are verified using the configured Credentials Service. Devices that have failed to authenticate are not allowed to publish any data.   HONO_MQTT_BIND_ADDRESS\n--hono.mqtt.bindAddress no 127.0.0.1 The IP address of the network interface that the secure port should be bound to.\nSee Port Configuration below for details.   HONO_MQTT_CERT_PATH\n--hono.mqtt.certPath no - The absolute path to the PEM file containing the certificate that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_MQTT_KEY_PATH.\nAlternatively, the HONO_MQTT_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_MQTT_COMMAND_ACK_TIMEOUT\n--hono.mqtt.commandAckTimeout no 100 The amount of time (milliseconds) after which the sending of a command to a device using QoS 1 is considered to be failed. The value of this variable should be increased in cases where devices are connected over a network with high latency.   HONO_MQTT_DEFAULTS_ENABLED\n--hono.mqtt.defaultsEnabled no true If set to true the protocol adapter uses default values registered for a device to augment messages published by the device with missing information like a content type. In particular, the protocol adapter adds default values registered for the device as (application) properties with the same name to the AMQP 1.0 messages it sends downstream to the AMQP Messaging Network.   HONO_MQTT_INSECURE_PORT_BIND_ADDRESS\n--hono.mqtt.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure port should be bound to.\nSee Port Configuration below for details.   HONO_MQTT_INSECURE_PORT_ENABLED\n--hono.mqtt.insecurePortEnabled no false If set to true the protocol adapter will open an insecure port (not secured by TLS) using either the port number set via HONO_MQTT_INSECURE_PORT or the default MQTT port number (1883) if not set explicitly.\nSee Port Configuration below for details.   HONO_MQTT_KEY_PATH\n--hono.mqtt.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_MQTT_CERT_PATH. Alternatively, the HONO_MQTT_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_MQTT_KEY_STORE_PASSWORD\n--hono.mqtt.keyStorePassword no - The password required to read the contents of the key store.   HONO_MQTT_KEY_STORE_PATH\n--hono.mqtt.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the protocol adapter should use for authenticating to clients. Either this option or the HONO_MQTT_KEY_PATH and HONO_MQTT_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_MQTT_SNI\n--hono.mqtt.sni no false Set whether the server supports Server Name Indication. By default, the server will not support SNI and the option is false. However, if set to true then the key store format , HONO_MQTT_KEY_STORE_PATH, should be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_MQTT_MAX_CONNECTIONS\n--hono.mqtt.maxConnections no 0 The maximum number of concurrent connections that the protocol adapter should accept. If not set (or set to 0), the protocol adapter determines a reasonable value based on the available resources like memory and CPU.   HONO_MQTT_MAX_PAYLOAD_SIZE\n--hono.mqtt.maxPayloadSize no 2048 The maximum allowed size of an incoming MQTT message\u0026rsquo;s payload in bytes. When a client sends a message with a larger payload, the message is discarded and the connection to the client gets closed.   HONO_MQTT_NATIVE_TLS_REQUIRED\n--hono.mqtt.nativeTlsRequired no false The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_MQTT_PORT\n--hono.mqtt.port no 8883 The secure port that the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_MQTT_SECURE_PROTOCOLS\n--hono.mqtt.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   HONO_MQTT_TENANT_IDLE_TIMEOUT\n--hono.mqtt.tenantIdleTimeout no 0ms The duration after which the protocol adapter removes local state of the tenant (e.g. open AMQP links) with an amount and a unit, e.g. 2h for 2 hours. See the Spring Boot documentation for an explanation of the format. The value 0ms disables the timeout.    The variables only need to be set if the default values do not match your environment.\nPort Configuration The MQTT protocol adapter can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The MQTT protocol adapter will fail to start if none of the ports is configured properly.\nSecure Port Only The protocol adapter needs to be configured with a private key and certificate in order to open a TLS secured port.\nThere are two alternative ways for doing so:\n either setting the HONO_MQTT_KEY_STORE_PATH and the HONO_MQTT_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_MQTT_KEY_PATH and HONO_MQTT_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  When starting up, the protocol adapter will bind a TLS secured socket to the default secure MQTT port 8883. The port number can also be set explicitly using the HONO_MQTT_PORT variable.\nThe HONO_MQTT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_MQTT_INSECURE_PORT to a valid port number, or by implicitly configuring the default MQTT port (1883) by simply setting HONO_MQTT_INSECURE_PORT_ENABLED to true.  The protocol adapter issues a warning on the console if HONO_MQTT_INSECURE_PORT is set to the default secure MQTT port (8883).\nThe HONO_MQTT_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port The protocol adapter may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nEphemeral Ports Both the secure as well as the insecure port numbers may be explicitly set to 0. The protocol adapter will then use arbitrary (unused) port numbers determined by the operating system during startup.\n"
+	"content": "The MQTT protocol adapter exposes an MQTT topic hierarchy for Eclipse Hono\u0026trade;\u0026rsquo;s south bound Telemetry, Event and Command \u0026amp; Control APIs.\nThe adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nThe adapter supports the following standard configuration options:\n Common Java VM Options Common vert.x Options Common Protocol Adapter Options Monitoring Options  Service Configuration The following table provides an overview of the configuration variables and corresponding command line options for configuring the MQTT adapter.\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     HONO_APP_MAX_INSTANCES\n--hono.app.maxInstances no #CPU cores The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.   HONO_CONNECTION_EVENTS_PRODUCER\n--hono.connectionEvents.producer no logging The implementation of connection events producer which is to be used. This may be logging or events.\nSee Connection Events   HONO_MQTT_AUTHENTICATION_REQUIRED\n--hono.mqtt.authenticationRequired no true If set to true the protocol adapter requires devices to authenticate when connecting to the adapter. The credentials provided by the device are verified using the configured Credentials Service. Devices that have failed to authenticate are not allowed to publish any data.   HONO_MQTT_BIND_ADDRESS\n--hono.mqtt.bindAddress no 127.0.0.1 The IP address of the network interface that the secure port should be bound to.\nSee Port Configuration below for details.   HONO_MQTT_CERT_PATH\n--hono.mqtt.certPath no - The absolute path to the PEM file containing the certificate that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_MQTT_KEY_PATH.\nAlternatively, the HONO_MQTT_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_MQTT_COMMAND_ACK_TIMEOUT\n--hono.mqtt.commandAckTimeout no 100 Deprecated. Use HONO_MQTT_SEND_MESSAGE_TO_DEVICE_TIMEOUT instead. The amount of time (milliseconds) after which the sending of a command to a device using QoS 1 is considered to be failed. The value of this variable should be increased in cases where devices are connected over a network with high latency.   HONO_MQTT_SEND_MESSAGE_TO_DEVICE_TIMEOUT\n--hono.mqtt.sendMessageToDeviceTimeout no 1000 The amount of time (milliseconds) after which the sending of a command to a device using QoS 1 is considered to be failed. The value of this variable should be increased in cases where devices are connected over a network with high latency.   HONO_MQTT_DEFAULTS_ENABLED\n--hono.mqtt.defaultsEnabled no true If set to true the protocol adapter uses default values registered for a device to augment messages published by the device with missing information like a content type. In particular, the protocol adapter adds default values registered for the device as (application) properties with the same name to the AMQP 1.0 messages it sends downstream to the AMQP Messaging Network.   HONO_MQTT_INSECURE_PORT_BIND_ADDRESS\n--hono.mqtt.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure port should be bound to.\nSee Port Configuration below for details.   HONO_MQTT_INSECURE_PORT_ENABLED\n--hono.mqtt.insecurePortEnabled no false If set to true the protocol adapter will open an insecure port (not secured by TLS) using either the port number set via HONO_MQTT_INSECURE_PORT or the default MQTT port number (1883) if not set explicitly.\nSee Port Configuration below for details.   HONO_MQTT_KEY_PATH\n--hono.mqtt.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_MQTT_CERT_PATH. Alternatively, the HONO_MQTT_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_MQTT_KEY_STORE_PASSWORD\n--hono.mqtt.keyStorePassword no - The password required to read the contents of the key store.   HONO_MQTT_KEY_STORE_PATH\n--hono.mqtt.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the protocol adapter should use for authenticating to clients. Either this option or the HONO_MQTT_KEY_PATH and HONO_MQTT_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_MQTT_SNI\n--hono.mqtt.sni no false Set whether the server supports Server Name Indication. By default, the server will not support SNI and the option is false. However, if set to true then the key store format , HONO_MQTT_KEY_STORE_PATH, should be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_MQTT_MAX_CONNECTIONS\n--hono.mqtt.maxConnections no 0 The maximum number of concurrent connections that the protocol adapter should accept. If not set (or set to 0), the protocol adapter determines a reasonable value based on the available resources like memory and CPU.   HONO_MQTT_MAX_PAYLOAD_SIZE\n--hono.mqtt.maxPayloadSize no 2048 The maximum allowed size of an incoming MQTT message\u0026rsquo;s payload in bytes. When a client sends a message with a larger payload, the message is discarded and the connection to the client gets closed.   HONO_MQTT_NATIVE_TLS_REQUIRED\n--hono.mqtt.nativeTlsRequired no false The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_MQTT_PORT\n--hono.mqtt.port no 8883 The secure port that the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_MQTT_SECURE_PROTOCOLS\n--hono.mqtt.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   HONO_MQTT_TENANT_IDLE_TIMEOUT\n--hono.mqtt.tenantIdleTimeout no 0ms The duration after which the protocol adapter removes local state of the tenant (e.g. open AMQP links) with an amount and a unit, e.g. 2h for 2 hours. See the Spring Boot documentation for an explanation of the format. The value 0ms disables the timeout.    The variables only need to be set if the default values do not match your environment.\nPort Configuration The MQTT protocol adapter can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The MQTT protocol adapter will fail to start if none of the ports is configured properly.\nSecure Port Only The protocol adapter needs to be configured with a private key and certificate in order to open a TLS secured port.\nThere are two alternative ways for doing so:\n either setting the HONO_MQTT_KEY_STORE_PATH and the HONO_MQTT_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_MQTT_KEY_PATH and HONO_MQTT_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  When starting up, the protocol adapter will bind a TLS secured socket to the default secure MQTT port 8883. The port number can also be set explicitly using the HONO_MQTT_PORT variable.\nThe HONO_MQTT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_MQTT_INSECURE_PORT to a valid port number, or by implicitly configuring the default MQTT port (1883) by simply setting HONO_MQTT_INSECURE_PORT_ENABLED to true.  The protocol adapter issues a warning on the console if HONO_MQTT_INSECURE_PORT is set to the default secure MQTT port (8883).\nThe HONO_MQTT_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port The protocol adapter may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nEphemeral Ports Both the secure as well as the insecure port numbers may be explicitly set to 0. The protocol adapter will then use arbitrary (unused) port numbers determined by the operating system during startup.\nCustom Message Mapping This protocol adapter supports transformation of messages that have been uploaded by devices before forwarding them to downstream consumers.\n Experimental This is an experimental feature. The names of the configuration properties, potential values and the overall functionality are therefore subject to change without prior notice.  The following table provides an overview of the configuration variables and corresponding command line options for configuring the external service endpoint(s) for transforming messages:\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     HONO_MQTT_MAPPERENDPOINTS_\u0026lt;mapperName\u0026gt;_HOST\n--hono.mqtt.mapperEndpoints.\u0026lt;mapperName\u0026gt;.host no - The host name or IP address of the service to invoke for transforming uploaded messages. The \u0026lt;mapperName\u0026gt; needs to contain the service name as set in the mapper property of the device\u0026rsquo;s registration information.   HONO_MQTT_MAPPERENDPOINTS_\u0026lt;mapperName\u0026gt;_PORT\n--hono.mqtt.mapperEndpoints.\u0026lt;mapperName\u0026gt;.port no - The port of the service to invoke for transforming uploaded messages. The \u0026lt;mapperName\u0026gt; needs to contain the service name as set in the mapper property of the device\u0026rsquo;s registration information.   HONO_MQTT_MAPPERENDPOINTS_\u0026lt;mapperName\u0026gt;_URI\n--hono.mqtt.mapperEndpoints.\u0026lt;mapperName\u0026gt;.uri no - The URI of the service to invoke for transforming uploaded messages. The \u0026lt;mapperName\u0026gt; needs to contain the service name as set in the mapper property of the device\u0026rsquo;s registration information.   "
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/admin-guide/amqp-adapter-config/",
+	"title": "AMQP Adapter Configuration",
+	"tags": [],
+	"description": "",
+	"content": "The AMQP protocol adapter exposes AMQP based endpoints for Eclipse Hono\u0026trade;\u0026rsquo;s south bound Telemetry, Event and Command \u0026amp; Control APIs.\nThe adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nThe adapter supports the following standard configuration options:\n Common Java VM Options Common vert.x Options Common Protocol Adapter Options Monitoring Options  Service Configuration The following table provides an overview of the configuration variables and corresponding command line options for configuring the AMQP adapter.\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     HONO_AMQP_AUTHENTICATION_REQUIRED\n--hono.amqp.authenticationRequired no true If set to true the protocol adapter requires devices to authenticate when connecting to the adapter. The credentials provided by the device are verified using the configured Credentials Service. Devices that have failed to authenticate are not allowed to publish any data.   HONO_AMQP_BIND_ADDRESS\n--hono.amqp.bindAddress no 127.0.0.1 The IP address of the network interface that the secure port should be bound to.\nSee Port Configuration below for details.   HONO_AMQP_CERT_PATH\n--hono.amqp.certPath no - The absolute path to the PEM file containing the certificate that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_AMQP_KEY_PATH.\nAlternatively, the HONO_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_AMQP_DEFAULTS_ENABLED\n--hono.amqp.defaultsEnabled no true If set to true the protocol adapter uses default values registered for a device to augment messages published by the device with missing information like a content type. In particular, the protocol adapter adds default values registered for the device as (application) properties with the same name to the AMQP 1.0 messages it sends downstream to the AMQP Messaging Network.   HONO_AMQP_IDLE_TIMEOUT\n--hono.amqp.idleTimeout no 60000 The time interval (milliseconds) to wait for incoming traffic from a device before the connection should be considered stale and thus be closed. Setting this property to 0 prevents the adapter from detecting and closing stale connections.   HONO_AMQP_SEND_MESSAGE_TO_DEVICE_TIMEOUT\n--hono.amqp.sendMessageToDeviceTimeout no 1000 The time interval (milliseconds) to wait for a device to acknowledge receiving a (command) message before the AMQP link used for sending the message will be closed. Setting this property to 0 means the adapter waits indefinitely for a device to acknowledge receiving the message.   HONO_AMQP_INSECURE_PORT_BIND_ADDRESS\n--hono.amqp.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure port should be bound to.\nSee Port Configuration below for details.   HONO_AMQP_INSECURE_PORT\n--hono.amqp.insecurePort no 5672 The port number that the protocol adapter should listen on for insecure connections.\nSee Port Configuration below for details.   HONO_AMQP_INSECURE_PORT_ENABLED\n--hono.amqp.insecurePortEnabled no false If set to true the protocol adapter will open an insecure port (not secured by TLS) using either the port number set via HONO_AMQP_INSECURE_PORT or the default AMQP port number (1883) if not set explicitly.\nSee Port Configuration below for details.   HONO_AMQP_KEY_PATH\n--hono.amqp.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_AMQP_CERT_PATH. Alternatively, the HONO_AMQP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_AMQP_KEY_STORE_PASSWORD\n--hono.amqp.keyStorePassword no - The password required to read the contents of the key store.   HONO_AMQP_KEY_STORE_PATH\n--hono.amqp.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the protocol adapter should use for authenticating to clients. Either this option or the HONO_AMQP_KEY_PATH and HONO_AMQP_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_AMQP_SNI\n--hono.amqp.sni no false Set whether the server supports Server Name Indication. By default, the server will not support SNI and the option is false. However, if set to true then the key store format, HONO_AMQP_KEY_STORE_PATH, should be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_AMQP_MAX_CONNECTIONS\n--hono.amqp.maxConnections no 0 The maximum number of concurrent connections that the protocol adapter should accept. If not set (or set to 0), the protocol adapter determines a reasonable value based on the available resources like memory and CPU.   HONO_AMQP_MAX_FRAME_SIZE\n--hono.amqp.maxFrameSize no 16384 The maximum number of bytes that can be sent in an AMQP message delivery over the connection with a device. When a client sends an AMQP frame of larger size, the connection is closed.   HONO_AMQP_MAX_PAYLOAD_SIZE\n--hono.amqp.maxPayloadSize no 2048 The maximum allowed size of an incoming AMQP message in bytes. When a client sends a message with a larger payload, the message is discarded and the link to the client is closed.   HONO_AMQP_MAX_SESSION_FRAMES\n--hono.amqp.maxSessionFrames no 30 The maximum number of AMQP transfer frames for sessions created on this connection. This is the number of transfer frames that may simultaneously be in flight for all links in the session.   HONO_AMQP_NATIVE_TLS_REQUIRED\n--hono.amqp.nativeTlsRequired no false The server will probe for OpenSSL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_AMQP_PORT\n--hono.amqp.port no 5671 The secure port that the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_AMQP_SECURE_PROTOCOLS\n--hono.amqp.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   HONO_AMQP_TENANT_IDLE_TIMEOUT\n--hono.amqp.tenantIdleTimeout no 0ms The duration after which the protocol adapter removes local state of the tenant (e.g. open AMQP links) with an amount and a unit, e.g. 2h for 2 hours. See the Spring Boot documentation for an explanation of the format. The value 0ms disables the timeout.   HONO_APP_MAX_INSTANCES\n--hono.app.maxInstances no #CPU cores The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.    The variables only need to be set if the default values do not match your environment.\nPort Configuration The AMQP protocol adapter can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The AMQP protocol adapter will fail to start if none of the ports is configured properly.\nSecure Port Only The protocol adapter needs to be configured with a private key and certificate in order to open a TLS secured port.\nThere are two alternative ways for doing so:\n either setting the HONO_AMQP_KEY_STORE_PATH and the HONO_AMQP_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_AMQP_KEY_PATH and HONO_AMQP_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  When starting up, the protocol adapter will bind a TLS secured socket to the default secure port 5671. The port number can also be set explicitly using the HONO_AMQP_PORT variable.\nThe HONO_AMQP_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_AMQP_INSECURE_PORT to a valid port number, or by implicitly configuring the default adapter port (5672) by simply setting HONO_AMQP_INSECURE_PORT_ENABLED to true.  The protocol adapter issues a warning on the console if HONO_AMQP_INSECURE_PORT is set to the default secure port (5671) used by the adapter for secure connections.\nThe HONO_AMQP_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port The protocol adapter may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nEphemeral Ports Both the secure as well as the insecure port numbers may be explicitly set to 0. The protocol adapter will then use arbitrary (unused) port numbers determined by the operating system during startup.\n"
+},
+{
+	"uri": "https://www.eclipse.org/hono/docs/admin-guide/coap-adapter-config/",
+	"title": "CoAP Adapter Configuration",
+	"tags": [],
+	"description": "",
+	"content": "The CoAP protocol adapter exposes CoAP based endpoints for Eclipse Hono\u0026trade;\u0026rsquo;s south bound Telemetry, Event and Command \u0026amp; Control APIs.\nThe adapter is implemented as a Spring Boot application using Eclipse Californium\u0026trade; for implementing the CoAP protocol handling. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nThe adapter supports the following standard configuration options:\n Common Java VM Options Common vert.x Options Common Protocol Adapter Options Monitoring Options  Service Configuration The following table provides an overview of the configuration variables and corresponding command line options for configuring the CoAP adapter.\n   Environment Variable\nCommand Line Option Mandatory Default Description     HONO_APP_MAX_INSTANCES\n--hono.app.maxInstances no #CPU cores The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.   HONO_COAP_AUTHENTICATION_REQUIRED\n--hono.coap.authenticationRequired no true If set to true the protocol adapter requires devices to authenticate when connecting to the adapter. The credentials provided by the device are verified using the configured Credentials Service. Devices that fail to authenticate are not allowed to connect to the adapter.   HONO_COAP_BIND_ADDRESS\n--hono.coap.bindAddress no 127.0.0.1 The IP address of the network interface that the secure port should be bound to.\nSee Port Configuration below for details.   HONO_COAP_CERT_PATH\n--hono.coap.certPath no - The absolute path to the PEM file containing the certificate that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_COAP_KEY_PATH.\nAlternatively, the HONO_COAP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_COAP_COAP_THREADS\n--hono.coap.coapThreads no 2 The number of threads to use for processing CoAP message exchanges at the protocol layer.   HONO_COAP_CONNECTOR_THREADS\n--hono.coap.connectorThreads no 2 The number of threads to use for receiving/sending UDP packets. The connector will start the given number of threads for each direction, outbound (sending) as well as inbound (receiving).   HONO_COAP_DTLS_THREADS\n--hono.coap.dtlsThreads no 32 The number of threads to use for processing DTLS message exchanges at the connection layer.   HONO_COAP_DTLS_RETRANSMISSION_TIMEOUT\n--hono.coap.dtlsRetransmissionTimeout no 2000 The timeout in milliseconds for DTLS retransmissions.   HONO_COAP_DEFAULTS_ENABLED\n--hono.coap.defaultsEnabled no true If set to true the protocol adapter uses default values registered for a device to augment messages published by the device with missing information like a content type. In particular, the protocol adapter adds default values registered for the device as (application) properties with the same name to the AMQP 1.0 messages it sends downstream to the AMQP Messaging Network.   HONO_COAP_EXCHANGE_LIFETIME\n--hono.coap.exchangeLifetime no 247000 The exchange lifetime in milliseconds. According RFC 7252, that value is 247s. Such a large time requires also a huge amount of heap. That time includes a processing time of 100s and retransmissions of CON messages. Therefore a practical value could be much smaller.   HONO_COAP_INSECURE_NETWORK_CONFIG\n--hono.coap.insecureNetworkConfig no - The absolute path to a Californium properties file containing network configuration properties that should be used for the insecure CoAP port. If not set, Californium\u0026rsquo;s default properties will be used.   HONO_COAP_INSECURE_PORT\n--hono.coap.insecurePort no - The insecure port the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_COAP_INSECURE_PORT_BIND_ADDRESS\n--hono.coap.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure port should be bound to.\nSee Port Configuration below for details.   HONO_COAP_INSECURE_PORT_ENABLED\n--hono.coap.insecurePortEnabled no false If set to true the protocol adapter will open an insecure port (not secured by TLS) using either the port number set via HONO_COAP_INSECURE_PORT or the default port number (5683) if not set explicitly.\nSee Port Configuration below for details.   HONO_COAP_KEY_PATH\n--hono.coap.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_COAP_CERT_PATH. Alternatively, the HONO_COAP_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_COAP_KEY_STORE_PASSWORD\n--hono.coap.keyStorePassword no - The password required to read the contents of the key store.   HONO_COAP_KEY_STORE_PATH\n--hono.coap.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the protocol adapter should use for authenticating to clients. Either this option or the HONO_COAP_KEY_PATH and HONO_COAP_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_COAP_MAX_CONNECTIONS\n--hono.coap.maxConnections no 0 The maximum number of concurrent DTLS connections that the protocol adapter should accept. If set to 0, the protocol adapter determines a reasonable value based on the available resources like memory and CPU.   HONO_COAP_MAX_PAYLOAD_SIZE\n--hono.coap.maxPayloadSize no 2048 The maximum allowed size of an incoming CoAP request\u0026rsquo;s body in bytes. Requests with a larger body size are rejected with a 4.13 Request entity too large response.   HONO_COAP_MESSAGE_OFFLOADING_ENABLED\n--hono.coap.messageOffloadingEnabled no true Enables to clear payload and serialized messages kept for deduplication in order to reduce the heap consumption. Experimental.   HONO_COAP_NETWORK_CONFIG\n--hono.coap.networkConfig no - The absolute path to a Californium properties file containing network configuration properties that should be used for the secure CoAP port. If not set, Californium\u0026rsquo;s default properties will be used.   HONO_COAP_PORT\n--hono.coap.port no - The secure port that the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_COAP_TENANT_IDLE_TIMEOUT\n--hono.coap.tenantIdleTimeout no 0ms The duration after which the protocol adapter removes local state of the tenant (e.g. open AMQP links) with an amount and a unit, e.g. 2h for 2 hours. See the Spring Boot documentation for an explanation of the format. The value 0ms disables the timeout.   HONO_COAP_TIMEOUT_TO_ACK\n--hono.coap.timeoutToAck no 500 Timeout to send a ACK and separate response. CoAP offers a very efficient piggybacked response, if that could be generated in time. This timeout waits for responding. If it expires without result, a ACK is sent and the response later. If the result is available in time, it is sent as piggybacked response. Special values: 0, always use piggybacked-response, -1, never use piggybacked-response.    The variables only need to be set if the default value needs to be changed.\nPort Configuration The CoAP protocol adapter can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The CoAP protocol adapter will fail to start if none of the ports is configured properly.\nSecure Port Only The protocol adapter opens a DTLS secured port if any of the following criteria are met\n The HONO_COAP_KEY_STORE_PATH and HONO_COAP_KEY_STORE_PASSWORD environment variables are set in order to load a key and certificate from a password protected key store or the HONO_COAP_KEY_PATH and HONO_COAP_CERT_PATH environment variables are set in order to load a key and certificate from two separate PEM files in PKCS8 format or the HONO_COAP_PORT environment variable is set to a valid port number.  When starting up, the protocol adapter will bind a DTLS secured UDP socket to the configured port. If the port is not set explicitly, the default CoAP secure port 5684 is used.\nThe HONO_COAP_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-DTLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled by\n explicitly setting HONO_COAP_AUTHENTICATION_REQUIRED to false and either  explicitly setting HONO_COAP_INSECURE_PORT to a valid port number or implicitly configuring the default insecure CoAP port (5683) by setting HONO_COAP_INSECURE_PORT_ENABLED to true.   The protocol adapter issues a warning on the console if HONO_COAP_INSECURE_PORT is set to the default secure CoAP port (5684).\nThe HONO_COAP_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-DTLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\n Note The insecure port will only be bound if the HONO_COAP_AUTHENTICATION_REQUIRED variable is set to false because CoAP authenticates clients (devices) as part of the DTLS handshake. Thus, requiring devices to authenticate effectively rules out setting up a non-DTLS secured port.  Dual Port The protocol adapter may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nEphemeral Ports Both the secure as well as the insecure port numbers may be explicitly set to 0. The protocol adapter will then use arbitrary (unused) port numbers determined by the operating system during startup.\nAuthentication The CoAP protocol is UDP based and as such uses the DTLS protocol to secure the communication between a client (device) and a server (adapter). The CoAP adapter also uses the DTLS handshake to prove its identity to devices and to authenticate the devices themselves. The DTLS protocol allows for different cipher suites to be used for doing so. These suites mainly differ from each other in the type of secret being used for proving the participants\u0026rsquo; identity to each other. One class of suites is based on a secret that is shared between the client and the server, very much like in a username/password based authentication scheme. This class of suites is called pre-shared key or PSK-based and is very popular for use cases where the devices are very constrained regarding CPU and memory. Another class of cipher suites is based on certificates which use asymmetric encryption for proving possession of the secret (the private key). The CoAP adapter supports cipher suites from both classes but only supports elliptic curve cryptography (ECC) based keys for the latter class of cipher suites.\nWhen enabling the secure port without configuring an ECC based key and certificate, the adapter will only use PSK based cipher suites for authentication. When configuring an ECC based key and certificate, the adapter will also offer certificate based cipher suites to the client to use for authentication.\nIn any case the device\u0026rsquo;s credentials need to be registered with the device registry. Please refer to the Standard Credential Types and the Device Registry Management API for additional information.\n"
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/admin-guide/kura-adapter-config/",
 	"title": "Kura Adapter Configuration",
 	"tags": [],
 	"description": "",
-	"content": "The Kura protocol adapter exposes an MQTT topic hierarchy allowing Eclipse Kura\u0026trade; based gateways to publish control and data messages to Eclipse Hono\u0026trade;\u0026rsquo;s Telemetry and Event endpoints.\nThe adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nThe adapter supports the following standard configuration options:\n Common Java VM Options Common vert.x Options Common Protocol Adapter Options Monitoring Options  Service Configuration The following table provides an overview of the configuration variables and corresponding command line options for configuring the MQTT adapter.\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     HONO_APP_MAX_INSTANCES\n--hono.app.maxInstances no #CPU cores The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.   HONO_KURA_AUTHENTICATION_REQUIRED\n--hono.kura.authenticationRequired no true If set to true the protocol adapter requires devices to authenticate when connecting to the adapter. The credentials provided by the device are verified using the configured Credentials Service. Devices that have failed to authenticate are not allowed to publish any data.   HONO_KURA_BIND_ADDRESS\n--hono.kura.bindAddress no 127.0.0.1 The IP address of the network interface that the secure port should be bound to.\nSee Port Configuration below for details.   HONO_KURA_CERT_PATH\n--hono.kura.certPath no - The absolute path to the PEM file containing the certificate that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_KURA_KEY_PATH.\nAlternatively, the HONO_KURA_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_KURA_CONTROL_PREFIX\n--hono.kura.controlPrefix no $EDC The topic.control-prefix to use for determining if a message published by a Kura gateway is a control message. All messages published to a topic that does not start with this prefix are considered data messages.   HONO_KURA_CTRL_MSG_CONTENT_TYPE\n--hono.kura.ctrlMsgContentType no application/vnd.eclipse.kura-control The content type to set on AMQP messages created from Kura control messages.   HONO_KURA_DATA_MSG_CONTENT_TYPE\n--hono.kura.dataMsgContentType no application/vnd.eclipse.kura-data The content type to set on AMQP messages created from Kura data messages.   HONO_KURA_DEFAULTS_ENABLED\n--hono.kura.defaultsEnabled no true If set to true the protocol adapter uses default values registered for a device to augment messages published by the device with missing information like a content type. In particular, the protocol adapter adds default values registered for the device as (application) properties with the same name to the AMQP 1.0 messages it sends downstream to the AMQP Messaging Network.   HONO_KURA_INSECURE_PORT\n--hono.kura.insecurePort no - The insecure port the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_KURA_INSECURE_PORT_BIND_ADDRESS\n--hono.kura.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure port should be bound to.\nSee Port Configuration below for details.   HONO_KURA_INSECURE_PORT_ENABLED\n--hono.kura.insecurePortEnabled no false If set to true the protocol adapter will open an insecure port (not secured by TLS) using either the port number set via HONO_KURA_INSECURE_PORT or the default MQTT port number (1883) if not set explicitly.\nSee Port Configuration below for details.   HONO_KURA_KEY_PATH\n--hono.kura.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_KURA_CERT_PATH. Alternatively, the HONO_KURA_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_KURA_KEY_STORE_PASSWORD\n--hono.kura.keyStorePassword no - The password required to read the contents of the key store.   HONO_KURA_KEY_STORE_PATH\n--hono.kura.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the protocol adapter should use for authenticating to clients. Either this option or the HONO_KURA_KEY_PATH and HONO_KURA_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_KURA_SNI\n--hono.kura.sni no false Set whether the server supports Server Name Indication. By default, the server will not support SNI and the option is false. However, if set to true then the key store format , HONO_KURA_KEY_STORE_PATH, should be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_KURA_MAX_PAYLOAD_SIZE\n--hono.kura.maxPayloadSize no 2048 The maximum allowed size of an incoming MQTT message\u0026rsquo;s payload in bytes. When a client sends a message with a larger payload, the message is discarded and the connection to the client gets closed.   HONO_KURA_NATIVE_TLS_REQUIRED\n--hono.kura.nativeTlsRequired no false The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_KURA_PORT\n--hono.kura.port no 8883 The secure port that the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_KURA_SECURE_PROTOCOLS\n--hono.kura.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   HONO_KURA_TENANT_IDLE_TIMEOUT\n--hono.kura.tenantIdleTimeout no 0ms The duration after which the protocol adapter removes local state of the tenant (e.g. open AMQP links) with an amount and a unit, e.g. 2h for 2 hours. See the Spring Boot documentation for an explanation of the format. The value 0ms disables the timeout.    The variables only need to be set if the default values do not match your environment.\nPort Configuration The Kura protocol adapter can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The Kura protocol adapter will fail to start if none of the ports is configured properly.\nSecure Port Only The protocol adapter needs to be configured with a private key and certificate in order to open a TLS secured port.\nThere are two alternative ways for doing so:\n either setting the HONO_KURA_KEY_STORE_PATH and the HONO_KURA_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_KURA_KEY_PATH and HONO_KURA_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  When starting up, the protocol adapter will bind a TLS secured socket to the default secure MQTT port 8883. The port number can also be set explicitly using the HONO_KURA_PORT variable.\nThe HONO_KURA_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_KURA_INSECURE_PORT to a valid port number, or by implicitly configuring the default MQTT port (1883) by simply setting HONO_KURA_INSECURE_PORT_ENABLED to true.  The protocol adapter issues a warning on the console if HONO_KURA_INSECURE_PORT is set to the default secure MQTT port (8883).\nThe HONO_KURA_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port The protocol adapter may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nEphemeral Ports Both the secure as well as the insecure port numbers may be explicitly set to 0. The protocol adapter will then use arbitrary (unused) port numbers determined by the operating system during startup.\n"
+	"content": "The Kura protocol adapter exposes an MQTT topic hierarchy allowing Eclipse Kura\u0026trade; based gateways to access Eclipse Hono\u0026trade;\u0026rsquo;s south bound Telemetry, Event and Command \u0026amp; Control APIs.\nThe adapter is implemented as a Spring Boot application. It can be run either directly from the command line or by means of starting the corresponding Docker image created from it.\nThe adapter supports the following standard configuration options:\n Common Java VM Options Common vert.x Options Common Protocol Adapter Options Monitoring Options  Service Configuration The following table provides an overview of the configuration variables and corresponding command line options for configuring the MQTT adapter.\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     HONO_APP_MAX_INSTANCES\n--hono.app.maxInstances no #CPU cores The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.   HONO_KURA_AUTHENTICATION_REQUIRED\n--hono.kura.authenticationRequired no true If set to true the protocol adapter requires devices to authenticate when connecting to the adapter. The credentials provided by the device are verified using the configured Credentials Service. Devices that have failed to authenticate are not allowed to publish any data.   HONO_KURA_BIND_ADDRESS\n--hono.kura.bindAddress no 127.0.0.1 The IP address of the network interface that the secure port should be bound to.\nSee Port Configuration below for details.   HONO_KURA_CERT_PATH\n--hono.kura.certPath no - The absolute path to the PEM file containing the certificate that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_KURA_KEY_PATH.\nAlternatively, the HONO_KURA_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_KURA_CONTROL_PREFIX\n--hono.kura.controlPrefix no $EDC The topic.control-prefix to use for determining if a message published by a Kura gateway is a control message. All messages published to a topic that does not start with this prefix are considered data messages.   HONO_KURA_CTRL_MSG_CONTENT_TYPE\n--hono.kura.ctrlMsgContentType no application/vnd.eclipse.kura-control The content type to set on AMQP messages created from Kura control messages.   HONO_KURA_DATA_MSG_CONTENT_TYPE\n--hono.kura.dataMsgContentType no application/vnd.eclipse.kura-data The content type to set on AMQP messages created from Kura data messages.   HONO_KURA_DEFAULTS_ENABLED\n--hono.kura.defaultsEnabled no true If set to true the protocol adapter uses default values registered for a device to augment messages published by the device with missing information like a content type. In particular, the protocol adapter adds default values registered for the device as (application) properties with the same name to the AMQP 1.0 messages it sends downstream to the AMQP Messaging Network.   HONO_KURA_INSECURE_PORT\n--hono.kura.insecurePort no - The insecure port the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_KURA_INSECURE_PORT_BIND_ADDRESS\n--hono.kura.insecurePortBindAddress no 127.0.0.1 The IP address of the network interface that the insecure port should be bound to.\nSee Port Configuration below for details.   HONO_KURA_INSECURE_PORT_ENABLED\n--hono.kura.insecurePortEnabled no false If set to true the protocol adapter will open an insecure port (not secured by TLS) using either the port number set via HONO_KURA_INSECURE_PORT or the default MQTT port number (1883) if not set explicitly.\nSee Port Configuration below for details.   HONO_KURA_KEY_PATH\n--hono.kura.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the protocol adapter should use for authenticating to clients. This option must be used in conjunction with HONO_KURA_CERT_PATH. Alternatively, the HONO_KURA_KEY_STORE_PATH option can be used to configure a key store containing both the key as well as the certificate.   HONO_KURA_KEY_STORE_PASSWORD\n--hono.kura.keyStorePassword no - The password required to read the contents of the key store.   HONO_KURA_KEY_STORE_PATH\n--hono.kura.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the protocol adapter should use for authenticating to clients. Either this option or the HONO_KURA_KEY_PATH and HONO_KURA_CERT_PATH options need to be set in order to enable TLS secured connections with clients. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_KURA_SNI\n--hono.kura.sni no false Set whether the server supports Server Name Indication. By default, the server will not support SNI and the option is false. However, if set to true then the key store format , HONO_KURA_KEY_STORE_PATH, should be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   HONO_MQTT_MAX_CONNECTIONS\n--hono.mqtt.maxConnections no 0 The maximum number of concurrent connections that the protocol adapter should accept. If not set (or set to 0), the protocol adapter determines a reasonable value based on the available resources like memory and CPU.   HONO_KURA_MAX_PAYLOAD_SIZE\n--hono.kura.maxPayloadSize no 2048 The maximum allowed size of an incoming MQTT message\u0026rsquo;s payload in bytes. When a client sends a message with a larger payload, the message is discarded and the connection to the client gets closed.   HONO_KURA_NATIVE_TLS_REQUIRED\n--hono.kura.nativeTlsRequired no false The server will probe for OpenSLL on startup if a secure port is configured. By default, the server will fall back to the JVM\u0026rsquo;s default SSL engine if not available. However, if set to true, the server will fail to start at all in this case.   HONO_KURA_PORT\n--hono.kura.port no 8883 The secure port that the protocol adapter should listen on.\nSee Port Configuration below for details.   HONO_KURA_SECURE_PROTOCOLS\n--hono.kura.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   HONO_KURA_TENANT_IDLE_TIMEOUT\n--hono.kura.tenantIdleTimeout no 0ms The duration after which the protocol adapter removes local state of the tenant (e.g. open AMQP links) with an amount and a unit, e.g. 2h for 2 hours. See the Spring Boot documentation for an explanation of the format. The value 0ms disables the timeout.   HONO_KURA_SEND_MESSAGE_TO_DEVICE_TIMEOUT\n--hono.kura.sendMessageToDeviceTimeout no 1000 The amount of time (milliseconds) after which the sending of a command to a device using QoS 1 is considered to be failed. The value of this variable should be increased in cases where devices are connected over a network with high latency.    The variables only need to be set if the default values do not match your environment.\nPort Configuration The Kura protocol adapter can be configured to listen for connections on\n a secure port only (default) or an insecure port only or both a secure and an insecure port (dual port configuration)  The Kura protocol adapter will fail to start if none of the ports is configured properly.\nSecure Port Only The protocol adapter needs to be configured with a private key and certificate in order to open a TLS secured port.\nThere are two alternative ways for doing so:\n either setting the HONO_KURA_KEY_STORE_PATH and the HONO_KURA_KEY_STORE_PASSWORD variables in order to load the key \u0026amp; certificate from a password protected key store, or setting the HONO_KURA_KEY_PATH and HONO_KURA_CERT_PATH variables in order to load the key and certificate from two separate PEM files in PKCS8 format.  When starting up, the protocol adapter will bind a TLS secured socket to the default secure MQTT port 8883. The port number can also be set explicitly using the HONO_KURA_PORT variable.\nThe HONO_KURA_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. Setting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nInsecure Port Only The secure port will mostly be required for production scenarios. However, it might be desirable to expose a non-TLS secured port instead, e.g. for testing purposes. In any case, the non-secure port needs to be explicitly enabled either by\n explicitly setting HONO_KURA_INSECURE_PORT to a valid port number, or by implicitly configuring the default MQTT port (1883) by simply setting HONO_KURA_INSECURE_PORT_ENABLED to true.  The protocol adapter issues a warning on the console if HONO_KURA_INSECURE_PORT is set to the default secure MQTT port (8883).\nThe HONO_KURA_INSECURE_PORT_BIND_ADDRESS variable can be used to specify the network interface that the port should be exposed on. By default the port is bound to the loopback device only, i.e. the port will only be accessible from the local host. This variable might be used to e.g. expose the non-TLS secured port on a local interface only, thus providing easy access from within the local network, while still requiring encrypted communication when accessed from the outside over public network infrastructure.\nSetting this variable to 0.0.0.0 will let the port being bound to all network interfaces (be careful not to expose the port unintentionally to the outside world).\nDual Port The protocol adapter may be configured to open both a secure and a non-secure port at the same time simply by configuring both ports as described above. For this to work, both ports must be configured to use different port numbers, otherwise startup will fail.\nEphemeral Ports Both the secure as well as the insecure port numbers may be explicitly set to 0. The protocol adapter will then use arbitrary (unused) port numbers determined by the operating system during startup.\n"
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/admin-guide/hono-client-configuration/",
 	"title": "Hono Client Configuration",
 	"tags": [],
 	"description": "",
-	"content": "The org.eclipse.hono.client.HonoConnection factory can be used to create AMQP 1.0 connections to Hono\u0026rsquo;s service components.\nThe factory uses environment variables and/or command line options to configure the connection to the service and the caching of responses to service invocations. All variables used for configuring the connection factory for a particular service share a common prefix. This way, multiple sets of variables can be used to configure multiple factories for connecting to different service endpoints without interfering with each other. For example, the set of variables for configuring the connection factory for the Device Registration service may use the common prefix HONO_REGISTRATION whereas the set for configuring the factory for the Credentials service may use HONO_CREDENTIALS.\nConnection Properties The following table provides an overview of the configuration variables and corresponding command line options for configuring the AMQP connection to the service. Note that the variables map to the properties of classes org.eclipse.hono.config.ClientConfigProperties and org.eclipse.client.RequestResponseClientConfigProperties which can be used to programmatically configure a client.\nThe variable names contain ${PREFIX} as a placeholder for the particular common prefix being used. The ${prefix} placeholder used in the command line option name is the same as ${PREFIX}, using all lower case characters and . instead of _ as the delimiter, e.g. the variable prefix HONO_CREDENTIALS corresponds to the command line option prefix hono.credentials).\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     ${PREFIX}_AMQPHOSTNAME\n--${prefix}.amqpHostname no - The name to use as the hostname in the client\u0026rsquo;s AMQP open frame during connection establishment. This variable can be used to indicate the virtual host to connect to on the server.   ${PREFIX}_CERTPATH\n--${prefix}.certPath no - The absolute path to the PEM file containing the certificate that the client should use for authenticating to the server. This variable must be used in conjunction with ${PREFIX}_KEY_PATH.\nAlternatively, the ${PREFIX}_KEYSTOREPATH variable can be used to configure a key store containing both the key as well as the certificate.   ${PREFIX}_CONNECTTIMEOUT\n--${prefix}.connectTimeout no 5000 The maximum amount of time (milliseconds) that the client should wait for the AMQP connection to be opened. This includes the time for TCP/TLS connection establishment, SASL handshake and exchange of the AMQP open frame. This property can be used to tune the time period to wait according to the network latency involved with the connection between the client and the service.   ${PREFIX}_CREDENTIALSPATH\n--${prefix}.credentialsPath no - The absolute path to a properties file that contains a username and a password property to use for authenticating to the service.\nThis variable is an alternative to using ${PREFIX}_USERNAME and ${PREFIX}_PASSWORD which has the advantage of not needing to expose the secret (password) in the client process\u0026rsquo; environment.   ${PREFIX}_FLOWLATENCY\n--${prefix}.flowLatency no 20 The maximum amount of time (milliseconds) that the client should wait for credits after a link to the service has been established.   ${PREFIX}_HOST\n--${prefix}.host no localhost The IP address or name of the host to connect to. NB This needs to be set to an address that can be resolved within the network the adapter runs on. When running as a Docker container, use Docker\u0026rsquo;s --network command line option to attach the local container to the Docker network that the service is running on.   ${PREFIX}_HOSTNAMEVERIFICATIONREQUIRED\n--${prefix}.hostnameVerificationRequired no true A flag indicating whether the value of the ${PREFIX}_HOST variable must match the distinguished name or any of the alternative names asserted by the server\u0026rsquo;s certificate when connecting using TLS.   ${PREFIX}_IDLETIMEOUT\n--${prefix}.idleTimeout no 16000 Sets the amount of time in milliseconds after which a connection will be closed when no frames have been received from the remote peer. This property is also used to configure a heartbeat mechanism, checking that the connection is still alive. The corresponding heartbeat interval will be set to idleTimeout/2 ms.   ${PREFIX}_INITIALCREDITS\n--${prefix}.initialCredits no 200 The number of credits that a consuming client will initially issue to the service (sender) after link creation. This value effectively limits the number of messages that can be in flight unsettled.   ${PREFIX}_KEYPATH\n--${prefix}.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the client should use for authenticating to the server. Note that the private key is not protected by a password. You should therefore make sure that the key file can only be read by the user that the client process is running under. This variable must be used in conjunction with ${PREFIX}_CERTPATH. Alternatively, the ${PREFIX}_KEYSTOREPATH variable can be used to configure a key store containing both the key as well as the certificate.   ${PREFIX}_KEYSTOREPASSWORD\n--${prefix}.keyStorePassword no - The password required to read the contents of the key store.   ${PREFIX}_KEYSTOREPATH\n--${prefix}.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the client should use for authenticating to the server. Either this variable or the ${PREFIX}_KEYPATH and ${PREFIX}_CERTPATH variables need to be set in order to enable SASL External based authentication to the server. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   ${PREFIX}_LINKESTABLISMENTTIMEOUT\n--${prefix}.linkEstablishmentTimeout no 1000 The maximum amount of time (milliseconds) that the client should wait for the service\u0026rsquo;s attach frame during link establishment. This property can be used to tune the time period to wait according to the network latency involved with the communication link between the client and the service.   ${PREFIX}_NAME\n--${prefix}.name no - The name to use as the container-id in the client\u0026rsquo;s AMQP open frame during connection establishment.   ${PREFIX}_PASSWORD\n--${prefix}.password no - The password to use for authenticating to the service.   ${PREFIX}_PORT\n--${prefix}.port no 5671 The port that the service is listening on.   ${PREFIX}_SENDMESSAGETIMEOUT\n--${prefix}.sendMessageTimeout no 1000 The maximum number of milliseconds to wait for a delivery update after an event or command message was sent before the send operation is failed. Setting this value to a higher value increases the chance of successful service invocation in situations where network latency is high.   ${PREFIX}_RECONNECTATTEMPTS\n--${prefix}.reconnectAttempts no -1 The number of attempts (in addition to the original connection attempt) that the client should make in order to establish an AMQP connection with the peer before giving up. The default value of this property is -1 which means that the client will try forever.   ${PREFIX}_RECONNECTDELAYINCREMENT\n--${prefix}.reconnectDelayIncrement no 100 The factor (milliseconds) used in the exponential backoff algorithm for determining the delay before trying to re-establish an AMQP connection with the peer. The delay after an initial, failed connection attempt will be the value of the ${PREFIX}_RECONNECTMINDELAY variable. Each subsequent connection attempt will use a random delay between the minimum delay and the value determined by exponentially increasing the delay by the ${PREFIX}_RECONNECTDELAYINCREMENT factor. The overall limit of the delay time is defined by the ${PREFIX}_RECONNECTMAXDELAY variable.   ${PREFIX}_RECONNECTMAXDELAY\n--${prefix}.reconnectMaxDelay no 7000 The maximum number of milliseconds to wait before trying to re-establish an AMQP connection with the peer.   ${PREFIX}_RECONNECTMINDELAY\n--${prefix}.reconnectMinDelay no 0 The minimum number of milliseconds to wait before trying to re-establish an AMQP connection with the peer.   ${PREFIX}_REQUESTTIMEOUT\n--${prefix}.requestTimeout no 200 The maximum number of milliseconds to wait for a response before a service invocation is failed. Setting this value to a higher value increases the chance of successful service invocation in situations where network latency is high.   ${PREFIX}_SECUREPROTOCOLS\n--${prefix}.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   ${PREFIX}_TLSENABLED\n--${prefix}.tlsEnabled no false If set to true the connection to the peer will be encrypted using TLS and the peer\u0026rsquo;s identity will be verified using the JVM\u0026rsquo;s configured standard trust store.\nThis variable only needs to be set to enable TLS explicitly if no specific trust store is configured using the ${PREFIX}_TRUSTSTOREPATH variable.   ${PREFIX}_TRUSTSTOREPATH\n--${prefix}.trustStorePath no - The absolute path to the Java key store containing the CA certificates the adapter uses for authenticating the service. This property must be set if the service has been configured to support TLS. The key store format can be either JKS, PKCS12 or PEM indicated by a .jks, .p12 or .pem file suffix respectively.   ${PREFIX}_TRUSTSTOREPASSWORD\n--${prefix}.trustStorePassword no - The password required to read the contents of the trust store.   ${PREFIX}_USERNAME\n--${prefix}.username no - The username to use for authenticating to the service. This property (and the corresponding password) needs to be set in order to enable SASL Plain based authentication to the service.    Response Caching The clients created by a Hono client factory support the caching of responses received in response to service invocations. Caching can greatly improve performance by preventing costly invocations of remote service operations. However, it usually only makes sense for resources that do not change too frequently. The Hono client follows the approach to caching used in HTTP 1.1. In particular, it supports cache directives that a service includes in the response messages it sends back to the Hono client.\nIn order to enable caching, the org.eclipse.hono.client.impl.HonoClientImpl factory class needs to be configured with a cache manager using the setCacheManager method. Any specific client created by the factory will then cache responses to service invocations based on the following rules:\n If the response contains a no-cache directive, the response is not cached at all. Otherwise, if the response contains a max-age directive, the response is cached for the number of seconds specified by the directive. Otherwise, if the response message does not contain any of the above directives and the response\u0026rsquo;s status code is one of the codes defined in RFC 2616, Section 13.4 Response Cacheability, the response is put to the cache using the default timeout defined by the ${PREFIX}_RESPONSECACHEDEFAULTTIMEOUT variable as the maximum age.  The following table provides an overview of the configuration variables and corresponding command line options for configuring the Hono client\u0026rsquo;s caching behavior.\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     ${PREFIX}_RESPONSECACHEMINSIZE\n--${prefix}.responseCacheMinSize no 20 The minimum number of responses that can be cached.   ${PREFIX}_RESPONSECACHEMAXSIZE\n--${prefix}.responseCacheMaxSize no 1000 The maximum number of responses that can be cached. It is up to the particular cache implementation, how to deal with new cache entries once this limit has been reached.   ${PREFIX}_RESPONSECACHEDEFAULTTIMEOUT\n--${prefix}.responseCacheDefaultTimeout no 600 The default number of seconds after which cached responses should be considered invalid.    Using TLS The factory can be configured to use TLS for\n authenticating the server during connection establishment and (optionally) authenticating to the server using a client certificate (if the server supports this)  In order to authenticate the server by means of the server\u0026rsquo;s certificate, the factory needs to be configured with a trust anchor containing the certificate authorities that the client trusts. The trust anchor can be configured explicitly by means of the ${PREFIX}_TRUSTSTOREPATH and ${PREFIX}_TRUSTSTOREPASSWORD variables. This is most useful in cases where the server\u0026rsquo;s certificate has not been signed by one of the public root CAs that are contained in the JRE\u0026rsquo;s standard trust store. However, if the server does use a certificate signed by such a public CA, then it is sufficient to set the ${PREFIX}_TLSENABLED variable to true in order for the client to support TLS when connecting to the server.\nThe client can also be configured to authenticate to the server by means of an X.509 client certificate if the server is configured to support this. The ${PREFIX}_CERTPATH and ${PREFIX}_KEYPATH variables can be used to set the paths to PEM files containing the certificate and private key. Alternatively, the ${PREFIX}_KEYSTOREPATH and ${PREFIX}_KEYSTOREPASSWORD variables can be used to set the path and password of a key store which contains both the certificate as well as the private key.\nThe factory supports TLS 1.2 only by default for negotiating TLS sessions with servers. Additional protocols can be enabled by setting the ${PREFIX}_SECUREPROTOCOLS variable to a comma separated list of protocol names as defined in the vert.x documentation. However, great care should be taken when enabling older protocols because most of them are vulnerable to attacks.\n"
+	"content": "The org.eclipse.hono.client.HonoConnection factory can be used to create AMQP 1.0 connections to Hono\u0026rsquo;s service components.\nThe factory uses environment variables and/or command line options to configure the connection to the service and the caching of responses to service invocations. All variables used for configuring the connection factory for a particular service share a common prefix. This way, multiple sets of variables can be used to configure multiple factories for connecting to different service endpoints without interfering with each other. For example, the set of variables for configuring the connection factory for the Device Registration service may use the common prefix HONO_REGISTRATION whereas the set for configuring the factory for the Credentials service may use HONO_CREDENTIALS.\nConnection Properties The following table provides an overview of the configuration variables and corresponding command line options for configuring the AMQP connection to the service. Note that the variables map to the properties of classes org.eclipse.hono.config.ClientConfigProperties and org.eclipse.client.RequestResponseClientConfigProperties which can be used to programmatically configure a client.\nThe variable names contain ${PREFIX} as a placeholder for the particular common prefix being used. The ${prefix} placeholder used in the command line option name is the same as ${PREFIX}, using all lower case characters and . instead of _ as the delimiter, e.g. the variable prefix HONO_CREDENTIALS corresponds to the command line option prefix hono.credentials).\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     ${PREFIX}_AMQPHOSTNAME\n--${prefix}.amqpHostname no - The name to use as the hostname in the client\u0026rsquo;s AMQP open frame during connection establishment. This variable can be used to indicate the virtual host to connect to on the server.   ${PREFIX}_CERTPATH\n--${prefix}.certPath no - The absolute path to the PEM file containing the certificate that the client should use for authenticating to the server. This variable must be used in conjunction with ${PREFIX}_KEY_PATH.\nAlternatively, the ${PREFIX}_KEYSTOREPATH variable can be used to configure a key store containing both the key as well as the certificate.   ${PREFIX}_CONNECTTIMEOUT\n--${prefix}.connectTimeout no 5000 The maximum amount of time (milliseconds) that the client should wait for the AMQP connection to be opened. This includes the time for TCP/TLS connection establishment, SASL handshake and exchange of the AMQP open frame. This property can be used to tune the time period to wait according to the network latency involved with the connection between the client and the service.   ${PREFIX}_CREDENTIALSPATH\n--${prefix}.credentialsPath no - The absolute path to a properties file that contains a username and a password property to use for authenticating to the service.\nThis variable is an alternative to using ${PREFIX}_USERNAME and ${PREFIX}_PASSWORD which has the advantage of not needing to expose the secret (password) in the client process\u0026rsquo; environment.   ${PREFIX}_FLOWLATENCY\n--${prefix}.flowLatency no 20 The maximum amount of time (milliseconds) that the client should wait for credits after a link to the service has been established.   ${PREFIX}_HOST\n--${prefix}.host no localhost The IP address or name of the host to connect to. NB This needs to be set to an address that can be resolved within the network the adapter runs on. When running as a Docker container, use Docker\u0026rsquo;s --network command line option to attach the local container to the Docker network that the service is running on.   ${PREFIX}_HOSTNAMEVERIFICATIONREQUIRED\n--${prefix}.hostnameVerificationRequired no true A flag indicating whether the value of the ${PREFIX}_HOST variable must match the distinguished name or any of the alternative names asserted by the server\u0026rsquo;s certificate when connecting using TLS.   ${PREFIX}_IDLETIMEOUT\n--${prefix}.idleTimeout no 16000 Sets the amount of time in milliseconds after which a connection will be closed when no frames have been received from the remote peer. This property is also used to configure a heartbeat mechanism, checking that the connection is still alive. The corresponding heartbeat interval will be set to idleTimeout/2 ms.   ${PREFIX}_INITIALCREDITS\n--${prefix}.initialCredits no 200 The number of credits that a consuming client will initially issue to the service (sender) after link creation. This value effectively limits the number of messages that can be in flight unsettled.   ${PREFIX}_KEYPATH\n--${prefix}.keyPath no - The absolute path to the (PKCS8) PEM file containing the private key that the client should use for authenticating to the server. Note that the private key is not protected by a password. You should therefore make sure that the key file can only be read by the user that the client process is running under. This variable must be used in conjunction with ${PREFIX}_CERTPATH. Alternatively, the ${PREFIX}_KEYSTOREPATH variable can be used to configure a key store containing both the key as well as the certificate.   ${PREFIX}_KEYSTOREPASSWORD\n--${prefix}.keyStorePassword no - The password required to read the contents of the key store.   ${PREFIX}_KEYSTOREPATH\n--${prefix}.keyStorePath no - The absolute path to the Java key store containing the private key and certificate that the client should use for authenticating to the server. Either this variable or the ${PREFIX}_KEYPATH and ${PREFIX}_CERTPATH variables need to be set in order to enable SASL External based authentication to the server. The key store format can be either JKS or PKCS12 indicated by a .jks or .p12 file suffix respectively.   ${PREFIX}_LINKESTABLISMENTTIMEOUT\n--${prefix}.linkEstablishmentTimeout no 1000 The maximum amount of time (milliseconds) that the client should wait for the service\u0026rsquo;s attach frame during link establishment. This property can be used to tune the time period to wait according to the network latency involved with the communication link between the client and the service.   ${PREFIX}_NAME\n--${prefix}.name no - The name to use as the container-id in the client\u0026rsquo;s AMQP open frame during connection establishment.   ${PREFIX}_PASSWORD\n--${prefix}.password no - The password to use for authenticating to the service.   ${PREFIX}_PORT\n--${prefix}.port no 5671 The port that the service is listening on.   ${PREFIX}_SENDMESSAGETIMEOUT\n--${prefix}.sendMessageTimeout no 1000 The maximum number of milliseconds to wait for a delivery update after an event or command message was sent before the send operation is failed. Setting this value to a higher value increases the chance of successful service invocation in situations where network latency is high.   ${PREFIX}_RECONNECTATTEMPTS\n--${prefix}.reconnectAttempts no -1 The number of attempts (in addition to the original connection attempt) that the client should make in order to establish an AMQP connection with the peer before giving up. The default value of this property is -1 which means that the client will try forever.   ${PREFIX}_RECONNECTDELAYINCREMENT\n--${prefix}.reconnectDelayIncrement no 100 The factor (milliseconds) used in the exponential backoff algorithm for determining the delay before trying to re-establish an AMQP connection with the peer. The delay after an initial, failed connection attempt will be the value of the ${PREFIX}_RECONNECTMINDELAY variable. Each subsequent connection attempt will use a random delay between the minimum delay and the value determined by exponentially increasing the delay by the ${PREFIX}_RECONNECTDELAYINCREMENT factor. The overall limit of the delay time is defined by the ${PREFIX}_RECONNECTMAXDELAY variable.   ${PREFIX}_RECONNECTMAXDELAY\n--${prefix}.reconnectMaxDelay no 7000 The maximum number of milliseconds to wait before trying to re-establish an AMQP connection with the peer.   ${PREFIX}_RECONNECTMINDELAY\n--${prefix}.reconnectMinDelay no 0 The minimum number of milliseconds to wait before trying to re-establish an AMQP connection with the peer.   ${PREFIX}_REQUESTTIMEOUT\n--${prefix}.requestTimeout no 200 The maximum number of milliseconds to wait for a response before a service invocation is failed. Setting this value to a higher value increases the chance of successful service invocation in situations where network latency is high.   ${PREFIX}_SECUREPROTOCOLS\n--${prefix}.secureProtocols no TLSv1.2 A (comma separated) list of secure protocols that are supported when negotiating TLS sessions. Please refer to the vert.x documentation for a list of supported protocol names.   ${PREFIX}_TLSENABLED\n--${prefix}.tlsEnabled no false If set to true the connection to the peer will be encrypted using TLS and the peer\u0026rsquo;s identity will be verified using the JVM\u0026rsquo;s configured standard trust store.\nThis variable only needs to be set to enable TLS explicitly if no specific trust store is configured using the ${PREFIX}_TRUSTSTOREPATH variable.   ${PREFIX}_TRUSTSTOREPATH\n--${prefix}.trustStorePath no - The absolute path to the Java key store containing the CA certificates the adapter uses for authenticating the service. This property must be set if the service has been configured to support TLS. The key store format can be either JKS, PKCS12 or PEM indicated by a .jks, .p12 or .pem file suffix respectively.   ${PREFIX}_TRUSTSTOREPASSWORD\n--${prefix}.trustStorePassword no - The password required to read the contents of the trust store.   ${PREFIX}_USERNAME\n--${prefix}.username no - The username to use for authenticating to the service. This property (and the corresponding password) needs to be set in order to enable SASL Plain based authentication to the service.    Response Caching The clients created by a Hono client factory support the caching of responses received in response to service invocations. Caching can greatly improve performance by preventing costly invocations of remote service operations. However, it usually only makes sense for resources that do not change too frequently. The Hono client follows the approach to caching used in HTTP 1.1. In particular, it supports cache directives that a service includes in the response messages it sends back to the Hono client.\nIn order to enable caching, the org.eclipse.hono.client.impl.HonoClientImpl factory class needs to be configured with a cache manager using the setCacheManager method. Any specific client created by the factory will then cache responses to service invocations based on the following rules:\n If the response contains a no-cache directive, the response is not cached at all. Otherwise, if the response contains a max-age directive, the response is cached for the number of seconds specified by the directive. Otherwise, if the response message does not contain any of the above directives and the response\u0026rsquo;s status code is one of the codes defined in RFC 2616, Section 13.4 Response Cacheability, the response is put to the cache using the default timeout defined by the ${PREFIX}_RESPONSECACHEDEFAULTTIMEOUT variable as the maximum age.  The following table provides an overview of the configuration variables and corresponding command line options for configuring the Hono client\u0026rsquo;s caching behavior.\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     ${PREFIX}_RESPONSECACHEMINSIZE\n--${prefix}.responseCacheMinSize no 20 The minimum number of responses that can be cached.   ${PREFIX}_RESPONSECACHEMAXSIZE\n--${prefix}.responseCacheMaxSize no 1000 The maximum number of responses that can be cached. It is up to the particular cache implementation, how to deal with new cache entries once this limit has been reached.   ${PREFIX}_RESPONSECACHEDEFAULTTIMEOUT\n--${prefix}.responseCacheDefaultTimeout no 600 The default number of seconds after which cached responses should be considered invalid.    Using TLS The factory can be configured to use TLS for\n authenticating the server during connection establishment and (optionally) authenticating to the server using a client certificate (if the server supports this)  In order to authenticate the server by means of the server\u0026rsquo;s certificate, the factory needs to be configured with a trust anchor containing the certificate authorities that the client trusts. The trust anchor can be configured explicitly by means of the ${PREFIX}_TRUSTSTOREPATH and ${PREFIX}_TRUSTSTOREPASSWORD variables. This is most useful in cases where the server\u0026rsquo;s certificate has not been signed by one of the public root CAs that are contained in the JRE\u0026rsquo;s standard trust store. However, if the server does use a certificate signed by such a public CA, then it is sufficient to set the ${PREFIX}_TLSENABLED variable to true in order for the client to support TLS when connecting to the server.\nThe client can also be configured to authenticate to the server by means of an X.509 client certificate if the server is configured to support this. The ${PREFIX}_CERTPATH and ${PREFIX}_KEYPATH variables can be used to set the paths to PEM files containing the certificate and private key. Alternatively, the ${PREFIX}_KEYSTOREPATH and ${PREFIX}_KEYSTOREPASSWORD variables can be used to set the path and password of a key store which contains both the certificate as well as the private key.\nThe factory supports TLS 1.2 only by default for negotiating TLS sessions with servers. Additional protocols can be enabled by setting the ${PREFIX}_SECUREPROTOCOLS variable to a comma separated list of protocol names as defined in the vert.x documentation. However, great care should be taken when enabling older protocols because most of them are vulnerable to attacks.\nAddress rewriting In some multi-tenant messaging environments external can have their addresses internally mapped to enforce consistent namespaces. For example, the addresses can be prefixed by the virtual host the client uses to connect or some other internal identifier. So address like telemetry/DEFAULT_TENANT would be internally represented as test-vhost/telemetry/DEFAULT_TENANT for example.\nTo successfully address those external clients, infrastructure Hono components need to apply the same mapping rules. The client factory can be configured to automatically rewrite addresses when opening links to the AMQP network. The ${PREFIX}_ADDRESSREWRITERULE variable contains rewrite rule for addresses based on the regular expressions.\n   Environment Variable\nCommand Line Option Mandatory Default Value Description     ${PREFIX}_ADDRESSREWRITERULE\n--${prefix}.addressRewriteRule no - The address rewrite rule in the \u0026quot;$PATTERN $REPLACEMENT\u0026quot; format.    The rule is defined in the \u0026quot;$PATTERN $REPLACEMENT\u0026quot; format, where the pattern and replacement use the standard Java regular expression syntax. The pattern should match the address or otherwise the original address will be used.\nFor example, setting HONO_ADDRESSREWRITERULE to ([a-z_]+)/([\\\\w-]+) test-vhost/$1/$2 would result in adding the test-vhost/ prefix to all addresses used by the client.\n"
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/admin-guide/amqp-network-config/",
@@ -214,7 +235,7 @@
 	"title": "Secure Communication",
 	"tags": [],
 	"description": "",
-	"content": "The individual components of an Eclipse Hono\u0026trade; installation, e.g. the protocol adapters, AMQP Messaging Network, Hono Auth etc., and the clients attaching to Hono in order to send and receive data all communicate with each other using AMQP 1.0 over TCP. The Hono components and the clients will usually not be located on the same local network but will probably communicate over public networking infrastructure. For most use cases it is therefore desirable, if not necessary, to provide for confidentiality of the data being transferred between these components. This section describes how Hono supports confidentiality by means of Transport Layer Security (TLS) and how to configure it.\nEnabling TLS All of Hono\u0026rsquo;s components can be configured to use TLS for establishing an encrypted communication channel with peers. When a client initiates a connection with a server, the TLS handshake protocol is used to negotiate parameters of a secure channel to be used for exchanging data. The most important of those parameters is a secret (symmetric) encryption key that is only known to the client and the server and which is used to transparently encrypt all data being sent over the connection as long as the connection exists. With each new connection, a new secret key is negotiated.\nUsing TLS in this way requires configuring the server component with a cryptographic private/public key pair and a certificate which binds an identity claim to the public key. It is out of scope of this document to describe the full process of creating such a key pair and acquiring a corresponding certificate. The demo-certs module already contains a set of keys and certificates to be used for evaluation and demonstration purposes. Throughout the rest of this section we will use these keys and certificates . Please refer to the demo-certs/README.md file for details regarding how to create your own keys and certificates.\nWithin a Hono installation the following communication channels can be secured with TLS:\n Applications connecting to Dispatch Router - Client applications consuming e.g. Telemetry data from Hono connect to the AMQP Messaging Network. This connection can be secured by configuring the client and the messaging network for TLS. Device Registry connecting to Auth Server - The Device Registry connects to the Auth Server in order to verify client credentials and determine the client\u0026rsquo;s authorities. This (internal) connection can (should) be secured by configuring the Auth Server and Device Registry for TLS. Protocol Adapter to Device Registry - A protocol adapter connects to the Device Registry in order to retrieve assertions regarding the registration status of devices. This (internal) connection can be secured by configuring the protocol adapter and the Device Registry for TLS. Protocol Adapter connecting to AMQP Messaging Network - A protocol adapter connects to the messaging network in order to forward telemetry data and commands hence and forth between downstream components (client applications) and devices. This (internal) connection can be secured by configuring the Dispatch Router and the protocol adapters for TLS. Devices connecting to a Protocol Adapter - Devices use TLS to both authenticate the protocol adapter and to establish an encrypted channel that provides integrity and privacy when transmitting data. Note that the specifics of if and how TLS can be used with a particular protocol adapter is specific to the transport protocol the adapter uses for communicating with the devices. Liveness/readiness probes connecting to Service Health Checks - Systems like Kubernetes are periodically checking the health status of the individual services . This communication can be secured by configuring the health check of the individual services to expose a secure endpoint.  Auth Server The Auth Server supports the use of TLS for connections to clients. Please refer to the Auth Server admin guide for details regarding the required configuration steps.\nThe demo-certs/certs folder includes the following demo keys and certificates to be used with the Auth Server for that purpose.\n   File Description     auth-server-key.pem The example private key for creating signatures.   auth-server-cert.pem The example certificate asserting the server\u0026rsquo;s identity.   trusted-certs.pem Trusted CA certificates to use for verifying signatures.    Dispatch Router The Dispatch Router reads its configuration from a file on startup (the default location is /etc/qpid-dispatch/qdrouterd.conf). Please refer to the Dispatch Router documentation for details regarding the configuration of TLS/SSL.\nThe demo-certs/certs folder includes the following demo keys and certificates to be used with the Dispatch Router for that purpose:\n   File Description     qdrouter-key.pem The example private key for creating signatures.   qdrouter-cert.pem The example certificate asserting the server\u0026rsquo;s identity.   trusted-certs.pem Trusted CA certificates to use for verifying signatures.    Device Registry The Device Registry supports the use of TLS for connections to protocol adapters and the Auth Server. Please refer to the Device Registry admin guide for details regarding the required configuration steps.\nThe demo-certs/certs folder contains the following demo keys and certificates to be used with the Device Registry for that purpose.\n   File Description     auth-server-cert.pem The certificate of the Auth Server, used to verify the signatures of tokens issued by the Auth Server.   device-registry-key.pem The example private key for creating signatures.   device-registry-cert.pem The example certificate asserting the server\u0026rsquo;s identity.   trusted-certs.pem Trusted CA certificates to use for verifying signatures.    HTTP Adapter The HTTP adapter supports the use of TLS for its connections to the Tenant service, the Device Registration service, the Credentials service and the AMQP Messaging Network. The adapter also supports the use of TLS for connections with devices. For this purpose, the adapter can be configured with a server certificate and private key. Please refer to the HTTP adapter admin guide for details regarding the required configuration steps.\nThe demo-certs/certs folder contains the following demo keys and certificates to be used with the HTTP adapter for that purpose.\n   File Description     http-adapter-key.pem The example private key for creating signatures.   http-adapter-cert.pem The example certificate asserting the adapter\u0026rsquo;s identity.   trusted-certs.pem Trusted CA certificates to use for verifying signatures.    MQTT Adapter The MQTT adapter supports the use of TLS for its connections to the Tenant service, the Device Registration service, the Credentials service and the AMQP Messaging Network. The adapter also supports the use of TLS for connections with devices. For this purpose, the adapter can be configured with a server certificate and private key. Please refer to the MQTT adapter admin guide for details regarding the required configuration steps.\nThe demo-certs/certs folder contains the following demo keys and certificates to be used with the MQTT adapter for that purpose.\n   File Description     mqtt-adapter-key.pem The example private key for creating signatures.   mqtt-adapter-cert.pem The example certificate asserting the adapter\u0026rsquo;s identity.   trusted-certs.pem Trusted CA certificates to use for verifying signatures.    Kura Adapter The Kura adapter supports the use of TLS for its connections to the Tenant service, the Device Registration service, the Credentials service and the AMQP Messaging Network. The adapter also supports the use of TLS for connections with devices. For this purpose, the adapter can be configured with a server certificate and private key. Please refer to the Kura adapter admin guide for details regarding the required configuration steps.\nThe demo-certs/certs folder contains the following demo keys and certificates to be used with the Kura adapter for that purpose.\n   File Description     kura-adapter-key.pem The example private key for creating signatures.   kura-adapter-cert.pem The example certificate asserting the adapter\u0026rsquo;s identity.   trusted-certs.pem Trusted CA certificates to use for verifying signatures.    Client Application When the connection between an application client and Hono (i.e. the Dispatch Router) is supposed to be secured by TLS (which is a good idea), then the client application needs to be configured to trust the CA that signed the Dispatch Router\u0026rsquo;s certificate chain. Clients can use the org.eclipse.hono.client.HonoConnection.newConnection(ClientConfigProperties) method to establish a connection to Hono. The org.eclipse.hono.config.ClientConfigProperties instance passed in to the method needs to be configured with the trust store containing the CA\u0026rsquo;s certificate. Please refer to the Hono Client configuration guide for details regarding the corresponding configuration properties that need to be set.\nThe demo-certs/certs folder contains the following demo keys to be used with client applications for that purpose.\n   File Description     trusted-certs.pem Trusted CA certificates to use for verifying signatures.    Using OpenSSL Hono\u0026rsquo;s individual services are implemented in Java and therefore, by default, use the SSL/TLS engine that comes with the Java Virtual Machine that the services are running on. In case of the Docker images provided by Hono this is the SSL engine of OpenJDK. While the standard SSL engine has the advantage of being a part of the JVM itself and thus being available on every operating system that the JVM is running on without further installation, it provides only limited performance and throughput when compared to native TLS implementations like OpenSSL.\nIn order to address this problem, the Netty networking library that is used in Hono\u0026rsquo;s components can be configured to employ the OpenSSL instead of the JVM\u0026rsquo;s SSL engine by means of Netty\u0026rsquo;s Forked Tomcat Native (tcnative) module.\nThe tcnative module comes in several flavors, corresponding to the way that the OpenSSL library has been linked in. The statically linked versions include a specific version of OpenSSL (or BoringSSL for that matter) and is therefore most easy to use on supported platforms, regardless of whether another version of OpenSSL is already installed or not. In contrast, the dynamically linked variants depend on a particular version of OpenSSL being already installed on the operating system. Both approaches have their pros and cons and Hono therefore does not include tcnative in its Docker images by default, i.e. Hono\u0026rsquo;s services will use the JVM\u0026rsquo;s default SSL engine by default.\nConfiguring Containers When starting up any of Hono\u0026rsquo;s Docker images as a container, the JVM will look for additional jar files to include in its classpath in the container\u0026rsquo;s /opt/hono/extensions folder. Thus, using a specific variant of tcnative is just a matter of configuring the container to mount a volume or binding a host folder at that location and putting the desired variant of tcnative into the corresponding volume or host folder.r Assuming that the Auth Server should be run with the statically linked, BoringSSL based tcnative variant, the following steps are necessary:\n Download tcnative matching the platform architecture (linux-x86_64). Put the jar file to a folder on the Docker host, e.g. /tmp/tcnative. Start the Auth Server Docker image mounting the host folder:  docker run --name hono-auth-server --mount type=bind,src=/tmp/tcnative,dst=/opt/hono/extensions,ro ... eclipse/hono-service-auth  Note that the command given above does not contain the environment variables and secrets that are usually required to configure the service properly.\nWhen the Auth Server starts up, it will look for a working variant of tcnative on its classpath and (if found) use it for establishing TLS connections. The service\u0026rsquo;s log file will indicate whether the JVM\u0026rsquo;s default SSL engine or OpenSSL is used.\nUsing a Docker volume instead of a bind mount works the same way but requires the use of volume as the type of the --mount parameter. Please refer to the Docker reference documentation for details.\nServer Name Indication (SNI) Server Name Indication can be used to indicate to a server the host name that the client wants to connect to as part of the TLS handshake. This is useful in order to be able to host multiple virtual servers on a single network address. In particular, SNI allows server components to select a server certificate that matches the domain name indicated by the client using SNI.\nHono\u0026rsquo;s protocol adapters support virtual servers by means of SNI as described above. Devices can then connect to a protocol adapter using any one of the configured virtual domain names.\nThe following steps a re necessary in order to configure the protocol adapters with multiple virtual servers:\n Create Server Certificate(s)  When a device establishes a connection to one of Hono\u0026rsquo;s protocol adapters using one of its virtual domain names, then it includes the domain name in its TLS hello message by means of the SNI extension. The server can then use this information to determine the matching server certificate and corresponding private key that is required to perform the TLS handshake.\nIt is therefore necessary to create a private key and certificate for each virtual server to be hosted. The virtual server\u0026rsquo;s domain name needs to be added to the certificate\u0026rsquo;s Subject Alternative Name (SAN) list in order for Hono to be able to determine the key/certificate pair to use for the TLS handshake with the device. Please refer to the vert.x SNI guide for details on how this works under the hood.\nHono\u0026rsquo;s protocol adapters then need to be configured with the server certificates and keys. In order to do so, the certificates and corresponding private keys need to be added to a key store. Hono supports the JKS and PKCS12 key store formats for that purpose. Once the key store has been created, Hono\u0026rsquo;s protocol adapters need to be configured with the path to the key store by means of the adapters\u0026rsquo; KEY_STORE_PATH configuration variable. Please refer to the protocol adapter admin guides for details on how to configure the key store path.\n Enable SNI for Hono\u0026rsquo;s Protocol Adapters  Hono\u0026rsquo;s protocol adapters can be configured to support SNI by means of the SNI configuration variable. Please refer to the protocol adapter admin guides for details on how to set this variable.\n Verify Configuration  The setup can be verified by means of the command line tools that are part of OpenSSL. Assuming that the MQTT protocol adapter\u0026rsquo;s IP address is 10.100.84.23, its secure endpoint is bound to port 31884 and it has been configured with a certificate using domain name my-hono.eclipse.org, then the following command can be used to test if a TLS secured connection with the adapter using that virtual host name can be established successfully:\nopenssl s_client -connect 10.100.84.23:31884 -servername my-hono.eclipse.org "
+	"content": "The individual components of an Eclipse Hono\u0026trade; installation, e.g. the protocol adapters, AMQP Messaging Network, Hono Auth etc., and the clients attaching to Hono in order to send and receive data all communicate with each other using AMQP 1.0 over TCP. The Hono components and the clients will usually not be located on the same local network but will probably communicate over public networking infrastructure. For most use cases it is therefore desirable, if not necessary, to provide for confidentiality of the data being transferred between these components. This section describes how Hono supports confidentiality by means of Transport Layer Security (TLS) and how to configure it.\nEnabling TLS All of Hono\u0026rsquo;s components can be configured to use TLS for establishing an encrypted communication channel with peers. When a client initiates a connection with a server, the TLS handshake protocol is used to negotiate parameters of a secure channel to be used for exchanging data. The most important of those parameters is a secret (symmetric) encryption key that is only known to the client and the server and which is used to transparently encrypt all data being sent over the connection as long as the connection exists. With each new connection, a new secret key is negotiated.\nUsing TLS in this way requires configuring the server component with a cryptographic private/public key pair and a certificate which binds an identity claim to the public key. It is out of scope of this document to describe the full process of creating such a key pair and acquiring a corresponding certificate. The demo-certs module already contains a set of keys and certificates to be used for evaluation and demonstration purposes. Throughout the rest of this section we will use these keys and certificates . Please refer to the demo-certs/README.md file for details regarding how to create your own keys and certificates.\nWithin a Hono installation the following communication channels can be secured with TLS:\n Applications connecting to Dispatch Router - Client applications consuming e.g. Telemetry data from Hono connect to the AMQP Messaging Network. This connection can be secured by configuring the client and the messaging network for TLS. Device Registry connecting to Auth Server - The Device Registry connects to the Auth Server in order to verify client credentials and determine the client\u0026rsquo;s authorities. This (internal) connection can (should) be secured by configuring the Auth Server and Device Registry for TLS. Protocol Adapter to Device Registry - A protocol adapter connects to the Device Registry in order to retrieve assertions regarding the registration status of devices. This (internal) connection can be secured by configuring the protocol adapter and the Device Registry for TLS. Protocol Adapter connecting to AMQP Messaging Network - A protocol adapter connects to the messaging network in order to forward telemetry data and commands hence and forth between downstream components (client applications) and devices. This (internal) connection can be secured by configuring the Dispatch Router and the protocol adapters for TLS. Devices connecting to a Protocol Adapter - Devices use TLS to both authenticate the protocol adapter and to establish an encrypted channel that provides integrity and privacy when transmitting data. Note that the specifics of if and how TLS can be used with a particular protocol adapter is specific to the transport protocol the adapter uses for communicating with the devices. Liveness/readiness probes connecting to Service Health Checks - Systems like Kubernetes are periodically checking the health status of the individual services . This communication can be secured by configuring the health check of the individual services to expose a secure endpoint.  Auth Server The Auth Server supports the use of TLS for connections to clients. Please refer to the Auth Server admin guide for details regarding the required configuration steps.\nThe demo-certs/certs folder includes the following demo keys and certificates to be used with the Auth Server for that purpose.\n   File Description     auth-server-key.pem The example private key for creating signatures.   auth-server-cert.pem The example certificate asserting the server\u0026rsquo;s identity.   trusted-certs.pem Trusted CA certificates to use for verifying signatures.    Dispatch Router The Dispatch Router reads its configuration from a file on startup (the default location is /etc/qpid-dispatch/qdrouterd.conf). Please refer to the Dispatch Router documentation for details regarding the configuration of TLS/SSL.\nThe demo-certs/certs folder includes the following demo keys and certificates to be used with the Dispatch Router for that purpose:\n   File Description     qdrouter-key.pem The example private key for creating signatures.   qdrouter-cert.pem The example certificate asserting the server\u0026rsquo;s identity.   trusted-certs.pem Trusted CA certificates to use for verifying signatures.    File Based Device Registry The file based Device Registry supports the use of TLS for connections to protocol adapters and the Auth Server. Please refer to the file based Device Registry admin guide for details regarding the required configuration steps.\nThe demo-certs/certs folder contains the following demo keys and certificates to be used with the file based Device Registry for that purpose.\n   File Description     auth-server-cert.pem The certificate of the Auth Server, used to verify the signatures of tokens issued by the Auth Server.   device-registry-key.pem The example private key for creating signatures.   device-registry-cert.pem The example certificate asserting the server\u0026rsquo;s identity.   trusted-certs.pem Trusted CA certificates to use for verifying signatures.    MongoDB Based Device Registry The MongoDB based Device Registry supports the use of TLS for connections to protocol adapters and the Auth Server. Please refer to the MongoDB based Device Registry admin guide for details regarding the required configuration steps.\nThe demo-certs/certs folder contains the following demo keys and certificates to be used with the MongoDB based Device Registry for that purpose.\n   File Description     auth-server-cert.pem The certificate of the Auth Server, used to verify the signatures of tokens issued by the Auth Server.   device-registry-key.pem The example private key for creating signatures.   device-registry-cert.pem The example certificate asserting the server\u0026rsquo;s identity.   trusted-certs.pem Trusted CA certificates to use for verifying signatures.    HTTP Adapter The HTTP adapter supports the use of TLS for its connections to the Tenant service, the Device Registration service, the Credentials service and the AMQP Messaging Network. The adapter also supports the use of TLS for connections with devices. For this purpose, the adapter can be configured with a server certificate and private key. Please refer to the HTTP adapter admin guide for details regarding the required configuration steps.\nThe demo-certs/certs folder contains the following demo keys and certificates to be used with the HTTP adapter for that purpose.\n   File Description     http-adapter-key.pem The example private key for creating signatures.   http-adapter-cert.pem The example certificate asserting the adapter\u0026rsquo;s identity.   trusted-certs.pem Trusted CA certificates to use for verifying signatures.    MQTT Adapter The MQTT adapter supports the use of TLS for its connections to the Tenant service, the Device Registration service, the Credentials service and the AMQP Messaging Network. The adapter also supports the use of TLS for connections with devices. For this purpose, the adapter can be configured with a server certificate and private key. Please refer to the MQTT adapter admin guide for details regarding the required configuration steps.\nThe demo-certs/certs folder contains the following demo keys and certificates to be used with the MQTT adapter for that purpose.\n   File Description     mqtt-adapter-key.pem The example private key for creating signatures.   mqtt-adapter-cert.pem The example certificate asserting the adapter\u0026rsquo;s identity.   trusted-certs.pem Trusted CA certificates to use for verifying signatures.    Kura Adapter The Kura adapter supports the use of TLS for its connections to the Tenant service, the Device Registration service, the Credentials service and the AMQP Messaging Network. The adapter also supports the use of TLS for connections with devices. For this purpose, the adapter can be configured with a server certificate and private key. Please refer to the Kura adapter admin guide for details regarding the required configuration steps.\nThe demo-certs/certs folder contains the following demo keys and certificates to be used with the Kura adapter for that purpose.\n   File Description     kura-adapter-key.pem The example private key for creating signatures.   kura-adapter-cert.pem The example certificate asserting the adapter\u0026rsquo;s identity.   trusted-certs.pem Trusted CA certificates to use for verifying signatures.    Client Application When the connection between an application client and Hono (i.e. the Dispatch Router) is supposed to be secured by TLS (which is a good idea), then the client application needs to be configured to trust the CA that signed the Dispatch Router\u0026rsquo;s certificate chain. Clients can use the org.eclipse.hono.client.HonoConnection.newConnection(ClientConfigProperties) method to establish a connection to Hono. The org.eclipse.hono.config.ClientConfigProperties instance passed in to the method needs to be configured with the trust store containing the CA\u0026rsquo;s certificate. Please refer to the Hono Client configuration guide for details regarding the corresponding configuration properties that need to be set.\nThe demo-certs/certs folder contains the following demo keys to be used with client applications for that purpose.\n   File Description     trusted-certs.pem Trusted CA certificates to use for verifying signatures.    Using OpenSSL Hono\u0026rsquo;s individual services are implemented in Java and therefore, by default, use the SSL/TLS engine that comes with the Java Virtual Machine that the services are running on. In case of the Docker images provided by Hono this is the SSL engine of OpenJDK. While the standard SSL engine has the advantage of being a part of the JVM itself and thus being available on every operating system that the JVM is running on without further installation, it provides only limited performance and throughput when compared to native TLS implementations like OpenSSL.\nIn order to address this problem, the Netty networking library that is used in Hono\u0026rsquo;s components can be configured to employ the OpenSSL instead of the JVM\u0026rsquo;s SSL engine by means of Netty\u0026rsquo;s Forked Tomcat Native (tcnative) module.\nThe tcnative module comes in several flavors, corresponding to the way that the OpenSSL library has been linked in. The statically linked versions include a specific version of OpenSSL (or BoringSSL for that matter) and is therefore most easy to use on supported platforms, regardless of whether another version of OpenSSL is already installed or not. In contrast, the dynamically linked variants depend on a particular version of OpenSSL being already installed on the operating system. Both approaches have their pros and cons and Hono therefore does not include tcnative in its Docker images by default, i.e. Hono\u0026rsquo;s services will use the JVM\u0026rsquo;s default SSL engine by default.\nConfiguring Containers When starting up any of Hono\u0026rsquo;s Docker images as a container, the JVM will look for additional jar files to include in its classpath in the container\u0026rsquo;s /opt/hono/extensions folder. Thus, using a specific variant of tcnative is just a matter of configuring the container to mount a volume or binding a host folder at that location and putting the desired variant of tcnative into the corresponding volume or host folder.r Assuming that the Auth Server should be run with the statically linked, BoringSSL based tcnative variant, the following steps are necessary:\n Download tcnative matching the platform architecture (linux-x86_64). Put the jar file to a folder on the Docker host, e.g. /tmp/tcnative. Start the Auth Server Docker image mounting the host folder:  docker run --name hono-auth-server --mount type=bind,src=/tmp/tcnative,dst=/opt/hono/extensions,ro ... eclipse/hono-service-auth  Note that the command given above does not contain the environment variables and secrets that are usually required to configure the service properly.\nWhen the Auth Server starts up, it will look for a working variant of tcnative on its classpath and (if found) use it for establishing TLS connections. The service\u0026rsquo;s log file will indicate whether the JVM\u0026rsquo;s default SSL engine or OpenSSL is used.\nUsing a Docker volume instead of a bind mount works the same way but requires the use of volume as the type of the --mount parameter. Please refer to the Docker reference documentation for details.\nServer Name Indication (SNI) Server Name Indication can be used to indicate to a server the host name that the client wants to connect to as part of the TLS handshake. This is useful in order to be able to host multiple virtual servers on a single network address. In particular, SNI allows server components to select a server certificate that matches the domain name indicated by the client using SNI.\nHono\u0026rsquo;s protocol adapters support virtual servers by means of SNI as described above. Devices can then connect to a protocol adapter using any one of the configured virtual domain names.\nThe following steps a re necessary in order to configure the protocol adapters with multiple virtual servers:\n Create Server Certificate(s)  When a device establishes a connection to one of Hono\u0026rsquo;s protocol adapters using one of its virtual domain names, then it includes the domain name in its TLS hello message by means of the SNI extension. The server can then use this information to determine the matching server certificate and corresponding private key that is required to perform the TLS handshake.\nIt is therefore necessary to create a private key and certificate for each virtual server to be hosted. The virtual server\u0026rsquo;s domain name needs to be added to the certificate\u0026rsquo;s Subject Alternative Name (SAN) list in order for Hono to be able to determine the key/certificate pair to use for the TLS handshake with the device. Please refer to the vert.x SNI guide for details on how this works under the hood.\nHono\u0026rsquo;s protocol adapters then need to be configured with the server certificates and keys. In order to do so, the certificates and corresponding private keys need to be added to a key store. Hono supports the JKS and PKCS12 key store formats for that purpose. Once the key store has been created, Hono\u0026rsquo;s protocol adapters need to be configured with the path to the key store by means of the adapters\u0026rsquo; KEY_STORE_PATH configuration variable. Please refer to the protocol adapter admin guides for details on how to configure the key store path.\n Enable SNI for Hono\u0026rsquo;s Protocol Adapters  Hono\u0026rsquo;s protocol adapters can be configured to support SNI by means of the SNI configuration variable. Please refer to the protocol adapter admin guides for details on how to set this variable.\n Verify Configuration  The setup can be verified by means of the command line tools that are part of OpenSSL. Assuming that the MQTT protocol adapter\u0026rsquo;s IP address is 10.100.84.23, its secure endpoint is bound to port 31884 and it has been configured with a certificate using domain name my-hono.eclipse.org, then the following command can be used to test if a TLS secured connection with the adapter using that virtual host name can be established successfully:\nopenssl s_client -connect 10.100.84.23:31884 -servername my-hono.eclipse.org "
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/admin-guide/monitoring-tracing-config/",
@@ -249,7 +270,7 @@
 	"title": "Consuming Messages from Java",
 	"tags": [],
 	"description": "",
-	"content": " To illustrate how Eclipse Hono\u0026trade; can be integrated with Java code, a simple application is provided that consumes telemetry and event data for devices belonging to the default tenant.\nIt also includes support for Command and Control:\nif indicated by a received downstream message that contains a ttd value (refer to Device notifications for details) it tries to send a command to the device. If the value of ttd indicates that the device stays connected for an unlimited time (ttd == -1), the application will periodically repeat to send a command until notified the device is disconnected again (ttd == 0).\nThis application shall serve as a blueprint to integrate your existing java source code with Hono. Its code is found in the example module in the package org.eclipse.hono.vertx.example.\nThe provided classes are kept as simple as possible (in the tradition of a classical \u0026ldquo;Hello World\u0026rdquo; implementation) while still covering the most relevant messaging patterns (downstream and upstream messages). For this purpose they make use of simple constant definitions and deal with exceptions as rarely as possible. You may want to change the level of detail that should be logged to the console by editing the contained resources/logback.xml file.\nPlease refer to the javadoc of the classes for details.\n Note Note that production ready code likely has to think more about error handling and logging than this simple blueprint.  Configure the example For simplicity, all configurations are defined as Java constants inside the class HonoExampleConstants.\nIf you have Hono running in Docker under localhost, the example should work out of the box.\nSome configuration values can be overridden by providing them as property to the application.\nThis includes the host and the port of the AMQP network. In the standard setup of Hono they should be configured to the qdrouter from the Apache Qpid project. In production scenarios this might be a large setup of AMQP routers, brokers, etc.\nPlease refer to the class HonoExampleConstants to find out which part of the application can be configured by properties.\nRun the example The application waits for messages until you press any key or kill it.\nIt is started by\n# in directory: hono/example/ mvn exec:java -Dexec.mainClass=org.eclipse.hono.vertx.example.HonoExampleApplication  or \u0026mdash; if e.g. the host of the AMQP network should be changed \u0026mdash;\nmvn exec:java -Dexec.mainClass=org.eclipse.hono.vertx.example.HonoExampleApplication -Dconsumer.host=192.168.99.100  Telemetry and Event messages Depending on the logger configuration, all received downstream messages are printed to the console.\nPlease note that consumers do not connect with Hono directly, but rather with an AMQP router network.\nCommand and Control By using a helper class provided by Hono, a callback in the application code is invoked when a downstream message was received that signals the device will stay connected to the protocol adapter for some time (see Device notifications for details).\nInside this callback an arbitrary simple command is sent down to the device (once or periodically) and the response is logged to the console.\nEncryption of communication For the encrypted communication with Hono, the necessary truststore is already installed and used by the Hono client.\nIf you want to integrate the code with your own software, please copy the provided truststore (hono/demo-certs/certs/trusted-certs.pem) from the Hono project to the resources directory of your project and adopt the code pointing to the file location.\n"
+	"content": " To illustrate how Eclipse Hono\u0026trade; can be integrated with Java code, a simple application is provided that consumes telemetry and event data for devices belonging to the default tenant.\nIt also includes support for Command and Control:\nif indicated by a received downstream message that contains a ttd value (refer to Device notifications for details) it tries to send a command to the device. If the value of ttd indicates that the device stays connected for an unlimited time (ttd == -1), the application will periodically repeat to send a command until notified the device is disconnected again (ttd == 0).\nThis application shall serve as a blueprint to integrate your existing java source code with Hono. Its code is found in the example module in the package org.eclipse.hono.vertx.example.\nThe provided classes are kept as simple as possible (in the tradition of a classical \u0026ldquo;Hello World\u0026rdquo; implementation) while still covering the most relevant messaging patterns (downstream and upstream messages). For this purpose they make use of simple constant definitions and deal with exceptions as rarely as possible. You may want to change the level of detail that should be logged to the console by editing the contained resources/logback.xml file.\nPlease refer to the javadoc of the classes for details.\n Note Note that production ready code likely has to think more about error handling and logging than this simple blueprint.  Configure the example For simplicity, all configurations are defined as Java constants inside the class HonoExampleConstants.\nIf you have Hono running in Docker under localhost, the example should work out of the box.\nSome configuration values can be overridden by providing them as property to the application.\nThis includes the host and the port of the AMQP network. In the standard setup of Hono they should be configured to the qdrouter from the Apache Qpid project. In production scenarios this might be a large setup of AMQP routers, brokers, etc.\nPlease refer to the class HonoExampleConstants to find out which part of the application can be configured by properties.\nRun the example The application waits for messages until you press any key or kill it.\nIt is started by\n# in directory: hono/examples/ mvn exec:java -Dexec.mainClass=org.eclipse.hono.vertx.example.HonoExampleApplication  or \u0026mdash; if e.g. the host of the AMQP network should be changed \u0026mdash;\nmvn exec:java -Dexec.mainClass=org.eclipse.hono.vertx.example.HonoExampleApplication -Dconsumer.host=192.168.99.100  Telemetry and Event messages Depending on the logger configuration, all received downstream messages are printed to the console.\nPlease note that consumers do not connect with Hono directly, but rather with an AMQP router network.\nCommand and Control By using a helper class provided by Hono, a callback in the application code is invoked when a downstream message was received that signals the device will stay connected to the protocol adapter for some time (see Device notifications for details).\nInside this callback an arbitrary simple command is sent down to the device (once or periodically) and the response is logged to the console.\nEncryption of communication For the encrypted communication with Hono, the necessary truststore is already installed and used by the Hono client.\nIf you want to integrate the code with your own software, please copy the provided truststore (hono/demo-certs/certs/trusted-certs.pem) from the Hono project to the resources directory of your project and adopt the code pointing to the file location.\n"
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/dev-guide/custom_http_adapter/",
@@ -298,21 +319,21 @@
 	"title": "Device Connection API Specification",
 	"tags": [],
 	"description": "",
-	"content": "The Device Connection API is used by Protocol Adapters to set and retrieve information about the connections from devices or gateways to the protocol adapters.\nThe Device Connection API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using an AMQP 1.0 client in order to invoke operations of the API as described in the following sections.\n\nPreconditions for invoking the Device Connection API  Client has established an AMQP connection with the Device Connection service. Client has established an AMQP link in role sender on the connection using target address device_con/${tenant_id}. This link is used by the client to send commands concerning device connections to Hono. Client has established an AMQP link in role receiver on the connection using source address device_con/${tenant_id}/${reply-to} where reply-to may be any arbitrary string chosen by the client. This link is used by the client to receive responses to the requests it has sent to the Device Connection service. This link\u0026rsquo;s source address is also referred to as the reply-to address for the request messages.    Client connecting to Device Connection service   Set last known Gateway for Device Clients use this command to set the gateway that last acted on behalf of a given device.\nAs this operation is invoked frequently by Hono\u0026rsquo;s components, implementors may choose to keep this information in memory. This API doesn\u0026rsquo;t mandate checks on the validity of the given device or gateway IDs in order not to introduce a dependency on the Device Registration API. However, implementations of this API may choose to perform such checks or impose a restriction on the overall amount of data that can be stored per tenant in order to protect against malicious requests.\nMessage Flow\n  Client sets the last known gateway for a device   Request Message Format\nThe following table provides an overview of the properties a client needs to set on a message to set the last known gateway for a device in addition to the Standard Request Properties.\n   Name Mandatory Location AMQP Type Description     subject yes properties string MUST be set to set-last-gw.   gateway_id yes application-properties string The identifier of the gateway that last acted on behalf of the device identified by the device_id property. If a device connects directly instead of through a gateway, the device\u0026rsquo;s identifier MUST be specified here.    The body of the message SHOULD be empty and will be ignored if it is not.\nResponse Message Format\nA response to a set last known gateway for device request contains the Standard Response Properties.\nThe response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     204 OK, the last known gateway for the device has been updated.   400 Bad Request, the last known gateway has not been updated due to invalid or missing data in the request.    Implementors of this API may return a 404 status code in order to indicate that no device and/or gateway with the given identifier exists for the given tenant. However, performing such a check is optional.\nFor status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred.\nGet last known Gateway for Device Clients use this command to retrieve the gateway that last acted on behalf of a given device.\nMessage Flow\n  Client retrieving the last known gateway for a device   Request Message Format\nThe following table provides an overview of the properties a client needs to set on a message to retrieve the last known gateway for a device in addition to the Standard Request Properties.\n   Name Mandatory Location AMQP Type Description     subject yes properties string MUST be set to get-last-gw.    The body of the message SHOULD be empty and will be ignored if it is not.\nResponse Message Format\nA response to a get last known gateway for device request contains the Standard Response Properties as well as the properties shown in the following table:\n   Name Mandatory Location AMQP Type Description     content-type no properties string MUST be set to application/json if the invocation of the operation was successful and the body of the response message contains payload as described below.    The result of a successful invocation is carried in a single Data section of the response message as a UTF-8 encoded string representation of a single JSON object. It is an error to include payload that is not of this type.\nThe response message JSON object has the following properties:\n   Name Mandatory JSON Type Description     gateway-id yes string The ID of the last known gateway for the device.   last-updated no string The date that the information about the last known gateway for the device was last updated. The value MUST be an ISO 8601 compliant combined date and time representation in extended format.    The response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     200 OK, the payload contains the gateway ID.   400 Bad Request, the request message does not contain all required information/properties.   404 Not Found, there is no last known gateway assigned to the device.    Implementors of this API may return a 404 status code in order to indicate that no device with the given identifier exists for the given tenant. However, performing such a check is optional.\nFor status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred.\nSet command-handling protocol adapter instance for device Clients use this command to set the protocol adapter instance that currently handles command \u0026amp; control messages for a given device.\nThis API doesn\u0026rsquo;t mandate checks on the validity of the given device in order not to introduce a dependency on the Device Registration API. However, implementations of this API may choose to perform such checks or impose a restriction on the overall amount of data that can be stored per tenant in order to protect against malicious requests.\nMessage Flow\n  Client sets the command-handling protocol adapter instance for device   Request Message Format\nThe following table provides an overview of the properties a client needs to set on a message to set the command-handling protocol adapter instance for a device in addition to the Standard Request Properties.\n   Name Mandatory Location AMQP Type Description     subject yes properties string MUST be set to set-cmd-handling-adapter-instance.   adapter_instance_id yes application-properties string The identifier of the protocol adapter instance that currently handles commands for the device or gateway identified by the device_id property.    The body of the message SHOULD be empty and will be ignored if it is not.\nResponse Message Format\nA response to a set command-handling adapter instance for device request contains the Standard Response Properties.\nThe response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     204 OK, the adapter instance for the device has been updated.   400 Bad Request, the command-handling adapter instance has not been updated due to invalid or missing data in the request.    Implementors of this API may return a 404 status code in order to indicate that no device with the given identifier exists for the given tenant. However, performing such a check is optional.\nFor status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred.\nRemove command-handling protocol adapter instance for device Clients use this command to remove the information, which protocol adapter instance is currently handling command \u0026amp; control messages for the given device. The mapping information is only removed, if the currently associated adapter instance matches the one given in the request.\nThis API doesn\u0026rsquo;t mandate checks on the validity of the given device in order not to introduce a dependency on the Device Registration API. However, implementations of this API may choose to perform such checks or impose a restriction on the overall amount of data that can be stored per tenant in order to protect against malicious requests.\nMessage Flow\n  Client removes the command-handling protocol adapter instance information for device   Request Message Format\nThe following table provides an overview of the properties a client needs to set on a message to remove the mapping information regarding the command-handling protocol adapter instance for a device in addition to the Standard Request Properties.\n   Name Mandatory Location AMQP Type Description     subject yes properties string MUST be set to remove-cmd-handling-adapter-instance.   adapter_instance_id yes application-properties string The identifier of the protocol adapter instance to remove the mapping information for. Only if this adapter instance is currently associated with the device or gateway identified by the device_id property, the mapping entry will be removed.    The body of the message SHOULD be empty and will be ignored if it is not.\nResponse Message Format\nA response to a remove command-handling adapter instance for device request contains the Standard Response Properties.\nThe response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     204 OK, the adapter instance mapping information for the device has been removed.   400 Bad Request, the request message does not contain all required properties.   404 Not Found, there is no matching command-handling adapter instance assigned to the device.    Implementors of this API may return a 404 status code in order to indicate that no device with the given identifier exists for the given tenant. However, performing such a check is optional. In case the currently mapped adapter instance doesn\u0026rsquo;t match the given adapter instance id, a 412 status code may also be returned instead of 404.\nFor status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred.\nGet command-handling protocol adapter instances for device Clients use this command to get information about the adapter instances that can handle command \u0026amp; control messages for the given device.\nAs part of the request message, the client is supposed to provide the list of gateways that may act on behalf of the given device. The client may get this list via the Device Registration API\u0026rsquo;s assert Device Registration operation.\nThis API doesn\u0026rsquo;t mandate checks on the validity of the given device and the gateway list in order not to introduce a dependency on the Device Registration API.\nThe command implementation MUST determine the adapter instances by applying the following rules (in the given order):\n If an adapter instance is associated with the given device, this adapter instance is returned as the single returned list entry. Otherwise, if there is an adapter instance registered for the last known gateway associated with the given device, this adapter instance is returned as the single returned list entry. The last known gateway has to be contained in the given list of gateways for this case. Otherwise, all adapter instances associated with any of the given gateway identifiers are returned.  That means that for a device communicating via a gateway, the result is reduced to a single element list if an adapter instance for the device itself or its last known gateway is found. The adapter instance registered for the device itself is given precedence in order to ensure that a gateway having subscribed to commands for that particular device is chosen over a gateway that has subscribed to commands for all devices of a tenant.\nMessage Flow\n  Client retrieving the list of command-handling adapter instances for a device   Request Message Format\nThe following table provides an overview of the properties a client needs to set on a message to retrieve the command-handling adapter instances for a device in addition to the Standard Request Properties.\n   Name Mandatory Location AMQP Type Description     content-type yes properties string MUST be set to application/json.   subject yes properties string MUST be set to get-cmd-handling-adapter-instances.    The body of the message MUST consist of a single AMQP Data section containing a UTF-8 encoded string representation of a single JSON object. The JSON object has the following properties:\n   Name Mandatory JSON Type Description     gateway-ids yes array The IDs of the gateways that may act on behalf of the given device. This list may be obtained via the Device Registration API\u0026rsquo;s assert Device Registration operation.    Example of a request payload:\n{ \u0026quot;gateway-ids\u0026quot;: [\u0026quot;gw-1\u0026quot;, \u0026quot;gw-2\u0026quot;, \u0026quot;gw-3\u0026quot;] }  Response Message Format\nA response to a get command-handling adapter instances for device request contains the Standard Response Properties as well as the properties shown in the following table:\n   Name Mandatory Location AMQP Type Description     content-type no properties string MUST be set to application/json if the invocation of the operation was successful and the body of the response message contains payload as described below.    The result of a successful invocation is carried in a single Data section of the response message as a UTF-8 encoded string representation of a single JSON object. It is an error to include payload that is not of this type.\nThe response message JSON object has the following properties:\n   Name Mandatory JSON Type Description     adapter-instances yes array A non-empty array of JSON objects that represent the command-handling adapter instances along with the device or gateway id.    Each entry in the adapter-instances array has the following properties:\n   Name Mandatory JSON Type Description     adapter-instance-id yes string The ID of the protocol adapter instance handling command \u0026amp; control messages for the device given in the device-id property.   device-id yes string The ID of the gateway or device that the protocol adapter instance given by the adapter-instance-id is handling command \u0026amp; control messages for. This ID is not necessarily the device_id given in the request message, it may be the ID of one of the gateways acting on behalf of the device.    An example of a response message with a single adapter instance result, returned for example if an adapter instance is registered for the given device:\n{ \u0026quot;adapter-instances\u0026quot;: [ { \u0026quot;adapter-instance-id\u0026quot;: \u0026quot;adapter-1\u0026quot;, \u0026quot;device-id\u0026quot;: \u0026quot;4711\u0026quot; } ] }  An example of a response message with multiple contained adapter instances, returned for example if no adapter instance is registered for the given device or its last used gateway, and therefore a list of all adapter instances for the gateways of the device is returned:\n{ \u0026quot;adapter-instances\u0026quot;: [ { \u0026quot;adapter-instance-id\u0026quot;: \u0026quot;adapter-1\u0026quot;, \u0026quot;device-id\u0026quot;: \u0026quot;gw-1\u0026quot; }, { \u0026quot;adapter-instance-id\u0026quot;: \u0026quot;adapter-1\u0026quot;, \u0026quot;device-id\u0026quot;: \u0026quot;gw-2\u0026quot; } ] }  The response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     200 OK, the payload contains the adapter instances.   400 Bad Request, the request message does not contain all required information/properties.   404 Not Found, there is no command-handling adapter instance assigned to the device.    Implementors of this API may also return a 404 status code in order to indicate that no device with the given identifier exists for the given tenant. However, performing such a check is optional.\nFor status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred.\nStandard Message Properties Due to the nature of the request/response message pattern of the operations of the Device Connection API, there are some standard properties shared by all of the request and response messages exchanged as part of the operations.\nStandard Request Properties The following table provides an overview of the properties shared by all request messages regardless of the particular operation being invoked.\n   Name Mandatory Location AMQP Type Description     subject yes properties string MUST be set to the value defined by the particular operation being invoked.   correlation-id no properties message-id MAY contain an ID used to correlate a response message to the original request. If set, it is used as the correlation-id property in the response, otherwise the value of the message-id property is used. Either this or the message-id property MUST be set.   message-id no properties string MAY contain an identifier that uniquely identifies the message at the sender side. Either this or the correlation-id property MUST be set.   reply-to yes properties string MUST contain the source address that the client wants to received response messages from. This address MUST be the same as the source address used for establishing the client\u0026rsquo;s receive link (see Preconditions).   device_id yes application-properties string MUST contain the ID of the device that is subject to the operation.    Standard Response Properties The following table provides an overview of the properties shared by all response messages regardless of the particular operation being invoked.\n   Name Mandatory Location AMQP Type Description     correlation-id yes properties message-id Contains the message-id (or the correlation-id, if specified) of the request message that this message is the response to.   status yes application-properties int Contains the status code indicating the outcome of the operation. Concrete values and their semantics are defined for each particular operation.   cache_control no application-properties string Contains an RFC 2616 compliant cache directive. The directive contained in the property MUST be obeyed by clients that are caching responses.    Delivery States Hono uses the following AMQP message delivery states when receiving request messages from clients:\n   Delivery State Description     ACCEPTED Indicates that the request message has been received and accepted for processing.   REJECTED Indicates that Hono has received the request but was not able to process it. The error field contains information regarding the reason why. Clients should not try to re-send the request using the same message properties in this case.   "
+	"content": "The Device Connection API is used by Protocol Adapters to set and retrieve information about the connections from devices or gateways to the protocol adapters.\nThe Device Connection API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using an AMQP 1.0 client in order to invoke operations of the API as described in the following sections.\n\nPreconditions for invoking the Device Connection API  Client has established an AMQP connection with the Device Connection service. Client has established an AMQP link in role sender on the connection using target address device_con/${tenant_id}. This link is used by the client to send commands concerning device connections to Hono. Client has established an AMQP link in role receiver on the connection using source address device_con/${tenant_id}/${reply-to} where reply-to may be any arbitrary string chosen by the client. This link is used by the client to receive responses to the requests it has sent to the Device Connection service. This link\u0026rsquo;s source address is also referred to as the reply-to address for the request messages.    Client connecting to Device Connection service   Set last known Gateway for Device Clients use this command to set the gateway that last acted on behalf of a given device.\nAs this operation is invoked frequently by Hono\u0026rsquo;s components, implementors may choose to keep this information in memory. This API doesn\u0026rsquo;t mandate checks on the validity of the given device or gateway IDs in order not to introduce a dependency on the Device Registration API. However, implementations of this API may choose to perform such checks or impose a restriction on the overall amount of data that can be stored per tenant in order to protect against malicious requests.\nMessage Flow\n  Client sets the last known gateway for a device   Request Message Format\nThe following table provides an overview of the properties a client needs to set on a message to set the last known gateway for a device in addition to the Standard Request Properties.\n   Name Mandatory Location AMQP Type Description     subject yes properties string MUST be set to set-last-gw.   gateway_id yes application-properties string The identifier of the gateway that last acted on behalf of the device identified by the device_id property. If a device connects directly instead of through a gateway, the device\u0026rsquo;s identifier MUST be specified here.    The body of the message SHOULD be empty and will be ignored if it is not.\nResponse Message Format\nA response to a set last known gateway for device request contains the Standard Response Properties.\nThe response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     204 OK, the last known gateway for the device has been updated.   400 Bad Request, the last known gateway has not been updated due to invalid or missing data in the request.    Implementors of this API may return a 404 status code in order to indicate that no device and/or gateway with the given identifier exists for the given tenant. However, performing such a check is optional.\nFor status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred.\nGet last known Gateway for Device Clients use this command to retrieve the gateway that last acted on behalf of a given device.\nMessage Flow\n  Client retrieving the last known gateway for a device   Request Message Format\nThe following table provides an overview of the properties a client needs to set on a message to retrieve the last known gateway for a device in addition to the Standard Request Properties.\n   Name Mandatory Location AMQP Type Description     subject yes properties string MUST be set to get-last-gw.    The body of the message SHOULD be empty and will be ignored if it is not.\nResponse Message Format\nA response to a get last known gateway for device request contains the Standard Response Properties as well as the properties shown in the following table:\n   Name Mandatory Location AMQP Type Description     content-type no properties string MUST be set to application/json if the invocation of the operation was successful and the body of the response message contains payload as described below.    The result of a successful invocation is carried in a single Data section of the response message as a UTF-8 encoded string representation of a single JSON object. It is an error to include payload that is not of this type.\nThe response message JSON object has the following properties:\n   Name Mandatory JSON Type Description     gateway-id yes string The ID of the last known gateway for the device.   last-updated no string The date that the information about the last known gateway for the device was last updated. The value MUST be an ISO 8601 compliant combined date and time representation in extended format.    The response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     200 OK, the payload contains the gateway ID.   400 Bad Request, the request message does not contain all required information/properties.   404 Not Found, there is no last known gateway assigned to the device.    Implementors of this API may return a 404 status code in order to indicate that no device with the given identifier exists for the given tenant. However, performing such a check is optional.\nFor status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred.\nSet command-handling protocol adapter instance for device Clients use this command to set the protocol adapter instance that currently handles command \u0026amp; control messages for a given device.\nClients can provide an optional lifespan parameter to make the protocol adapter instance entry expire after the given number of seconds. Note that implementations of this API have to support this feature, otherwise protocol adapters, as the clients of this API, might fail to correctly route command messages.\nThis API doesn\u0026rsquo;t mandate checks on the validity of the given device in order not to introduce a dependency on the Device Registration API. However, implementations of this API may choose to perform such checks or impose a restriction on the overall amount of data that can be stored per tenant in order to protect against malicious requests.\nMessage Flow\n  Client sets the command-handling protocol adapter instance for device   Request Message Format\nThe following table provides an overview of the properties a client needs to set on a message to set the command-handling protocol adapter instance for a device in addition to the Standard Request Properties.\n   Name Mandatory Location AMQP Type Description     subject yes properties string MUST be set to set-cmd-handling-adapter-instance.   adapter_instance_id yes application-properties string The identifier of the protocol adapter instance that currently handles commands for the device or gateway identified by the device_id property.   lifespan no application-properties int The lifespan of the mapping entry in seconds. After that period, the mapping entry shall be treated as non-existent by the Device Registration API methods. A negative value, as well as an omitted property, is interpreted as an unlimited lifespan.    The body of the message SHOULD be empty and will be ignored if it is not.\nResponse Message Format\nA response to a set command-handling adapter instance for device request contains the Standard Response Properties.\nThe response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     204 OK, the command-handling adapter instance for the device has been updated.   400 Bad Request, the adapter instance for the device has not been set or updated due to invalid or missing data in the request.    Implementors of this API may return a 404 status code in order to indicate that no device with the given identifier exists for the given tenant. However, performing such a check is optional.\nFor status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred.\nRemove command-handling protocol adapter instance for device Clients use this command to remove the information, which protocol adapter instance is currently handling command \u0026amp; control messages for the given device. The mapping information is only removed, if the currently associated adapter instance matches the one given in the request.\nThis API doesn\u0026rsquo;t mandate checks on the validity of the given device in order not to introduce a dependency on the Device Registration API. However, implementations of this API may choose to perform such checks or impose a restriction on the overall amount of data that can be stored per tenant in order to protect against malicious requests.\nMessage Flow\n  Client removes the command-handling protocol adapter instance information for device   Request Message Format\nThe following table provides an overview of the properties a client needs to set on a message to remove the mapping information regarding the command-handling protocol adapter instance for a device in addition to the Standard Request Properties.\n   Name Mandatory Location AMQP Type Description     subject yes properties string MUST be set to remove-cmd-handling-adapter-instance.   adapter_instance_id yes application-properties string The identifier of the protocol adapter instance to remove the mapping information for. Only if this adapter instance is currently associated with the device or gateway identified by the device_id property, the mapping entry will be removed.    The body of the message SHOULD be empty and will be ignored if it is not.\nResponse Message Format\nA response to a remove command-handling adapter instance for device request contains the Standard Response Properties.\nThe response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     204 OK, the adapter instance mapping information for the device has been removed.   400 Bad Request, the request message does not contain all required properties.   412 Precondition failed, the adapter instance for the device has not been removed because there is no matching command-handling adapter instance assigned to the device.    Implementors of this API may return a 404 status code in order to indicate that no device with the given identifier exists for the given tenant. However, performing such a check is optional.\nFor status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred.\nGet command-handling protocol adapter instances for device Clients use this command to get information about the adapter instances that can handle command \u0026amp; control messages for the given device.\nAs part of the request message, the client is supposed to provide the list of gateways that may act on behalf of the given device. The client may get this list via the Device Registration API\u0026rsquo;s assert Device Registration operation.\nThis API doesn\u0026rsquo;t mandate checks on the validity of the given device and the gateway list in order not to introduce a dependency on the Device Registration API.\nThe command implementation MUST determine the adapter instances by applying the following rules (in the given order):\n If an adapter instance is associated with the given device, this adapter instance is returned as the single returned list entry. Otherwise, if there is an adapter instance registered for the last known gateway associated with the given device, this adapter instance is returned as the single returned list entry. The last known gateway has to be contained in the given list of gateways for this case. Otherwise, all adapter instances associated with any of the given gateway identifiers are returned.  That means that for a device communicating via a gateway, the result is reduced to a single element list if an adapter instance for the device itself or its last known gateway is found. The adapter instance registered for the device itself is given precedence in order to ensure that a gateway having subscribed to commands for that particular device is chosen over a gateway that has subscribed to commands for all devices of a tenant.\nMessage Flow\n  Client retrieving the list of command-handling adapter instances for a device   Request Message Format\nThe following table provides an overview of the properties a client needs to set on a message to retrieve the command-handling adapter instances for a device in addition to the Standard Request Properties.\n   Name Mandatory Location AMQP Type Description     content-type yes properties string MUST be set to application/json.   subject yes properties string MUST be set to get-cmd-handling-adapter-instances.    The body of the message MUST consist of a single AMQP Data section containing a UTF-8 encoded string representation of a single JSON object. The JSON object has the following properties:\n   Name Mandatory JSON Type Description     gateway-ids yes array The IDs of the gateways that may act on behalf of the given device. This list may be obtained via the Device Registration API\u0026rsquo;s assert Device Registration operation.    Example of a request payload:\n{ \u0026quot;gateway-ids\u0026quot;: [\u0026quot;gw-1\u0026quot;, \u0026quot;gw-2\u0026quot;, \u0026quot;gw-3\u0026quot;] }  Response Message Format\nA response to a get command-handling adapter instances for device request contains the Standard Response Properties as well as the properties shown in the following table:\n   Name Mandatory Location AMQP Type Description     content-type no properties string MUST be set to application/json if the invocation of the operation was successful and the body of the response message contains payload as described below.    The result of a successful invocation is carried in a single Data section of the response message as a UTF-8 encoded string representation of a single JSON object. It is an error to include payload that is not of this type.\nThe response message JSON object has the following properties:\n   Name Mandatory JSON Type Description     adapter-instances yes array A non-empty array of JSON objects that represent the command-handling adapter instances along with the device or gateway id.    Each entry in the adapter-instances array has the following properties:\n   Name Mandatory JSON Type Description     adapter-instance-id yes string The ID of the protocol adapter instance handling command \u0026amp; control messages for the device given in the device-id property.   device-id yes string The ID of the gateway or device that the protocol adapter instance given by the adapter-instance-id is handling command \u0026amp; control messages for. This ID is not necessarily the device_id given in the request message, it may be the ID of one of the gateways acting on behalf of the device.    An example of a response message with a single adapter instance result, returned for example if an adapter instance is registered for the given device:\n{ \u0026quot;adapter-instances\u0026quot;: [ { \u0026quot;adapter-instance-id\u0026quot;: \u0026quot;adapter-1\u0026quot;, \u0026quot;device-id\u0026quot;: \u0026quot;4711\u0026quot; } ] }  An example of a response message with multiple contained adapter instances, returned for example if no adapter instance is registered for the given device or its last used gateway, and therefore a list of all adapter instances for the gateways of the device is returned:\n{ \u0026quot;adapter-instances\u0026quot;: [ { \u0026quot;adapter-instance-id\u0026quot;: \u0026quot;adapter-1\u0026quot;, \u0026quot;device-id\u0026quot;: \u0026quot;gw-1\u0026quot; }, { \u0026quot;adapter-instance-id\u0026quot;: \u0026quot;adapter-1\u0026quot;, \u0026quot;device-id\u0026quot;: \u0026quot;gw-2\u0026quot; } ] }  The response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     200 OK, the payload contains the adapter instances.   400 Bad Request, the request message does not contain all required information/properties.   404 Not Found, there is no command-handling adapter instance assigned to the device.    Implementors of this API may also return a 404 status code in order to indicate that no device with the given identifier exists for the given tenant. However, performing such a check is optional.\nFor status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred.\nStandard Message Properties Due to the nature of the request/response message pattern of the operations of the Device Connection API, there are some standard properties shared by all of the request and response messages exchanged as part of the operations.\nStandard Request Properties The following table provides an overview of the properties shared by all request messages regardless of the particular operation being invoked.\n   Name Mandatory Location AMQP Type Description     subject yes properties string MUST be set to the value defined by the particular operation being invoked.   correlation-id no properties message-id MAY contain an ID used to correlate a response message to the original request. If set, it is used as the correlation-id property in the response, otherwise the value of the message-id property is used. Either this or the message-id property MUST be set.   message-id no properties string MAY contain an identifier that uniquely identifies the message at the sender side. Either this or the correlation-id property MUST be set.   reply-to yes properties string MUST contain the source address that the client wants to received response messages from. This address MUST be the same as the source address used for establishing the client\u0026rsquo;s receive link (see Preconditions).   device_id yes application-properties string MUST contain the ID of the device that is subject to the operation.    Standard Response Properties The following table provides an overview of the properties shared by all response messages regardless of the particular operation being invoked.\n   Name Mandatory Location AMQP Type Description     correlation-id yes properties message-id Contains the message-id (or the correlation-id, if specified) of the request message that this message is the response to.   status yes application-properties int Contains the status code indicating the outcome of the operation. Concrete values and their semantics are defined for each particular operation.   cache_control no application-properties string Contains an RFC 2616 compliant cache directive. The directive contained in the property MUST be obeyed by clients that are caching responses.    Delivery States Hono uses the following AMQP message delivery states when receiving request messages from clients:\n   Delivery State Description     ACCEPTED Indicates that the request message has been received and accepted for processing.   REJECTED Indicates that Hono has received the request but was not able to process it. The error field contains information regarding the reason why. Clients should not try to re-send the request using the same message properties in this case.   "
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/api/device-registration/",
 	"title": "Device Registration API Specification",
 	"tags": [],
 	"description": "",
-	"content": "The Device Registration API is used by Hono\u0026rsquo;s protocol adapters to get information about devices connecting to the adapters.\nThe Device Registration API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using an AMQP 1.0 client in order to invoke operations of the API as described in the following sections.\n\nPreconditions for invoking the Device Registration API  Client has established an AMQP connection with the Device Registration service. Client has established an AMQP link in role sender on the connection using target address registration/${tenant_id}. This link is used by the client to send request messages to the Device Registration service. Client has established an AMQP link in role receiver on the connection using source address registration/${tenant_id}/${reply-to} where reply-to may be any arbitrary string chosen by the client. This link is used by the client to receive responses to the requests it has sent to the Device Registration service. This link\u0026rsquo;s source address is also referred to as the reply-to address for the request messages.    Client connecting to Device Registration service   Assert Device Registration Clients use this command to verify that a device is registered for a particular tenant and is enabled.\nMessage Flow\nThe following sequence diagram illustrates the flow of messages involved in a Client asserting a device\u0026rsquo;s registration status.\n  Client asserting a device\u0026#39;s registration status   Request Message Format\nThe following table provides an overview of the properties a client needs to set on a message to assert a device\u0026rsquo;s registration status:\n   Name Mandatory Location AMQP Type Description     correlation-id no properties message-id MAY contain an ID used to correlate a response message to the original request. If set, it is used as the correlation-id property in the response, otherwise the value of the message-id property is used. Either this or the message-id property MUST be set.   device_id yes application-properties string MUST contain the ID of the device that is subject to the operation.   gateway_id no application-properties string The identifier of the gateway that wants to get an assertion on behalf of another device (given in the device_id property).\nAn implementation SHOULD verify that the gateway exists, is enabled and is authorized to get an assertion for, and thus send data on behalf of, the device.   message-id no properties string MAY contain an identifier that uniquely identifies the message at the sender side. Either this or the correlation-id property MUST be set.   reply-to yes properties string MUST contain the source address that the client wants to received response messages from. This address MUST be the same as the source address used for establishing the client\u0026rsquo;s receive link (see Preconditions).   subject yes properties string MUST be set to assert.    The body of the message SHOULD be empty and will be ignored if it is not.\nResponse Message Format\nThe following table provides an overview of the properties contained in a response message to an assert request:\n   Name Mandatory Location AMQP Type Description     correlation-id yes properties message-id Contains the message-id (or the correlation-id, if specified) of the request message that this message is the response to.   content-type no properties string MUST be set to application/json if the invocation of the operation was successful and the body of the response message contains payload as described below.   status yes application-properties int Contains the status code indicating the outcome of the operation. Concrete values and their semantics are defined below.   cache_control no application-properties string Contains an RFC 2616 compliant cache directive. The directive contained in the property MUST be obeyed by clients that are caching responses.    In case of a successful invocation of the operation, the body of the response message consists of a single Data section containing a UTF-8 encoded string representation of a single JSON object having the following properties:\n   Name Mandatory JSON Type Description     device-id yes string The ID of the device that is subject of the assertion.   via no array The IDs (JSON strings) of gateways which may act on behalf of the device. This property MUST be set if any gateways are registered for the device. If the assertion request contained a gateway_id property and the response\u0026rsquo;s status property has value 200 (indicating a successful assertion) then the array MUST at least contain the gateway ID from the request.   defaults no object Default values to be used by protocol adapters for augmenting messages from devices with missing information like a content type. It is up to the discretion of a protocol adapter if and how to use the given default values when processing messages published by the device.    Below is an example for a payload of a response to an assert request for device 4711 which also includes a default content-type:\n{ \u0026quot;device-id\u0026quot;: \u0026quot;4711\u0026quot;, \u0026quot;via\u0026quot;: [\u0026quot;4712\u0026quot;], \u0026quot;defaults\u0026quot;: { \u0026quot;content-type\u0026quot;: \u0026quot;application/vnd.acme+json\u0026quot; } }  The response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     200 OK, the device is registered for the given tenant and is enabled. The response message body contains the asserted device\u0026rsquo;s registration status.   400 Bad Request, the request message did not contain all mandatory properties.   403 Forbidden, the gateway with the given gateway id either does not exist, is not enabled or is not authorized to get an assertion for the device with the given device id.   404 Not Found, there is no device registered with the given device id within the given tenant id or the device is not enabled.    For status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred. In this case, the response message\u0026rsquo;s content-type property SHOULD be set accordingly.\nDelivery States The Device Registration service uses the following AMQP message delivery states when receiving request messages from clients:\n   Delivery State Description     ACCEPTED Indicates that the request message has been received and accepted for processing.   REJECTED Indicates that the request message has been received but cannot be processed. The disposition frame\u0026rsquo;s error field contains information regarding the reason why. Clients should not try to re-send the request using the same message properties in this case.   "
+	"content": "The Device Registration API is used by Hono\u0026rsquo;s protocol adapters to get information about devices connecting to the adapters.\nThe Device Registration API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using an AMQP 1.0 client in order to invoke operations of the API as described in the following sections.\n\nPreconditions for invoking the Device Registration API  Client has established an AMQP connection with the Device Registration service. Client has established an AMQP link in role sender on the connection using target address registration/${tenant_id}. This link is used by the client to send request messages to the Device Registration service. Client has established an AMQP link in role receiver on the connection using source address registration/${tenant_id}/${reply-to} where reply-to may be any arbitrary string chosen by the client. This link is used by the client to receive responses to the requests it has sent to the Device Registration service. This link\u0026rsquo;s source address is also referred to as the reply-to address for the request messages.    Client connecting to Device Registration service   Assert Device Registration Clients use this command to verify that a device is registered for a particular tenant and is enabled.\nMessage Flow\nThe following sequence diagram illustrates the flow of messages involved in a Client asserting a device\u0026rsquo;s registration status.\n  Client asserting a device\u0026#39;s registration status   Request Message Format\nThe following table provides an overview of the properties a client needs to set on a message to assert a device\u0026rsquo;s registration status:\n   Name Mandatory Location AMQP Type Description     correlation-id no properties message-id MAY contain an ID used to correlate a response message to the original request. If set, it is used as the correlation-id property in the response, otherwise the value of the message-id property is used. Either this or the message-id property MUST be set.   device_id yes application-properties string MUST contain the ID of the device that is subject to the operation.   gateway_id no application-properties string The identifier of the gateway that wants to get an assertion on behalf of another device (given in the device_id property).\nAn implementation SHOULD verify that the gateway exists, is enabled and is authorized to get an assertion for, and thus send data on behalf of, the device.   message-id no properties string MAY contain an identifier that uniquely identifies the message at the sender side. Either this or the correlation-id property MUST be set.   reply-to yes properties string MUST contain the source address that the client wants to received response messages from. This address MUST be the same as the source address used for establishing the client\u0026rsquo;s receive link (see Preconditions).   subject yes properties string MUST be set to assert.    The body of the message SHOULD be empty and will be ignored if it is not.\nResponse Message Format\nThe following table provides an overview of the properties contained in a response message to an assert request:\n   Name Mandatory Location AMQP Type Description     correlation-id yes properties message-id Contains the message-id (or the correlation-id, if specified) of the request message that this message is the response to.   content-type no properties string MUST be set to application/json if the invocation of the operation was successful and the body of the response message contains payload as described below.   status yes application-properties int Contains the status code indicating the outcome of the operation. Concrete values and their semantics are defined below.   cache_control no application-properties string Contains an RFC 2616 compliant cache directive. The directive contained in the property MUST be obeyed by clients that are caching responses.    In case of a successful invocation of the operation, the body of the response message consists of a single Data section containing a UTF-8 encoded string representation of a single JSON object having the following properties:\n   Name Mandatory JSON Type Description     device-id yes string The ID of the device that is subject of the assertion.   via no array The IDs (JSON strings) of gateways which may act on behalf of the device. This property MUST be set if any gateways are registered for the device. If the assertion request contained a gateway_id property and the response\u0026rsquo;s status property has value 200 (indicating a successful assertion) then the array MUST at least contain the gateway ID from the request.   defaults no object Default values to be used by protocol adapters for augmenting messages from devices with missing information like a content type. It is up to the discretion of a protocol adapter if and how to use the given default values when processing messages published by the device.   mapper no string The name of a service that can be used to transform messages uploaded by the device before they are forwarded to downstream consumers. The client needs to map this name to the particular service to invoke.    Below is an example for a payload of a response to an assert request for device 4711 which also includes a default content-type and a mapper service:\n{ \u0026quot;device-id\u0026quot;: \u0026quot;4711\u0026quot;, \u0026quot;via\u0026quot;: [\u0026quot;4712\u0026quot;], \u0026quot;defaults\u0026quot;: { \u0026quot;content-type\u0026quot;: \u0026quot;application/vnd.acme+json\u0026quot; }, \u0026quot;mapper\u0026quot;: \u0026quot;my-payload-transformation\u0026quot; }  The response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     200 OK, the device is registered for the given tenant and is enabled. The response message body contains the asserted device\u0026rsquo;s registration status.   400 Bad Request, the request message did not contain all mandatory properties.   403 Forbidden, the gateway with the given gateway id either does not exist, is not enabled or is not authorized to get an assertion for the device with the given device id.   404 Not Found, there is no device registered with the given device id within the given tenant id or the device is not enabled.    For status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred. In this case, the response message\u0026rsquo;s content-type property SHOULD be set accordingly.\nDelivery States The Device Registration service uses the following AMQP message delivery states when receiving request messages from clients:\n   Delivery State Description     ACCEPTED Indicates that the request message has been received and accepted for processing.   REJECTED Indicates that the request message has been received but cannot be processed. The disposition frame\u0026rsquo;s error field contains information regarding the reason why. Clients should not try to re-send the request using the same message properties in this case.   "
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/api/credentials/",
 	"title": "Credentials API Specification",
 	"tags": [],
 	"description": "",
-	"content": "The Credentials API is used by Protocol Adapters to retrieve credentials used to authenticate Devices connecting to the adapter. In particular, the API supports to look up shared secrets which are often used by IoT devices by means of username/password based authentication schemes.\nCredentials are of a certain type which indicates which authentication mechanism the credentials can be used with. Each set of credentials also contains an authentication identity which is the identity claimed by the device during authentication. This authentication identity is usually different from the device-id the device has been registered under. A device may have multiple sets of credentials, using arbitrary authentication identities.\nThe Credentials API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using an AMQP 1.0 client in order to invoke operations of the API as described in the following sections.\n\nPreconditions for invoking the Credentials API  Client has established an AMQP connection with the Credentials service. Client has established an AMQP link in role sender on the connection using target address credentials/${tenant_id}. This link is used by the client to send commands to the Credentials service. Client has established an AMQP link in role receiver on the connection using source address credentials/${tenant_id}/${reply-to} where reply-to may be any arbitrary string chosen by the client. This link is used by the client to receive responses to the requests it has sent to the Credentials service. This link\u0026rsquo;s source address is also referred to as the reply-to address for the request messages.    Client connecting to Credentials service   Get Credentials Protocol adapters use this command to look up credentials of a particular type for a device identity.\nMessage Flow\n  Client looking up credentials for a device   Request Message Format\nThe following table provides an overview of the properties a client needs to set on an get credentials message.\n   Name Mandatory Location AMQP Type Description     correlation-id no properties message-id MAY contain an ID used to correlate a response message to the original request. If set, it is used as the correlation-id property in the response, otherwise the value of the message-id property is used. Either this or the message-id property MUST be set.   message-id no properties string MAY contain an identifier that uniquely identifies the message at the sender side. Either this or the correlation-id property MUST be set.   reply-to yes properties string MUST contain the source address that the client wants to receive response messages from. This address MUST be the same as the source address used for establishing the client\u0026rsquo;s receive link (see Preconditions).   subject yes properties string MUST contain the value get.    The body of the request MUST consist of a single Data section containing a UTF-8 encoded string representation of a single JSON object having the following members:\n   Name Mandatory JSON Type Description     type yes string The type of credentials to look up. Potential values include (but are not limited to) psk, x509-cert, hashed-password etc.   auth-id yes string The authentication identifier to look up credentials for.   client-certificate no string The client certificate the device authenticated with. If present, it MUST be the DER encoding of the (validated) X.509 client certificate as a Base64 encoded byte array and it\u0026rsquo;s subject DN MUST match the auth-id.    The client-certificate property MAY be used by the service implementation for auto-provisioning of devices. To do so, the device registry needs to create credentials (and registration data) for the device if they do not already exist.\nAdditionally, the body MAY contain arbitrary properties that service implementations can use to determine a device\u0026rsquo;s identity.\nThe following request payload may be used to look up the hashed password for a device with the authentication identifier sensor1:\n{ \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor1\u0026quot; }  The following request payload may be used to look up or create x509-cert credentials for a device with the authentication identifier CN=device-1,O=ACME Corporation:\n{ \u0026quot;type\u0026quot;: \u0026quot;x509-cert\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;CN=device-1,O=ACME Corporation\u0026quot;, \u0026quot;client-certificate\u0026quot;: \u0026quot;DeviceCert==\u0026quot; }  Response Message Format\nA response to a get credentials request contains the following properties:\n   Name Mandatory Location AMQP Type Description     correlation-id yes properties message-id Contains the message-id (or the correlation-id, if specified) of the request message that this message is the response to.   content-type no properties string MUST be set to application/json if the invocation of the operation was successful and the body of the response message contains payload as described below.   status yes application-properties int Contains the status code indicating the outcome of the operation. Concrete values and their semantics are defined below.   cache_control no application-properties string Contains an RFC 2616 compliant cache directive. The directive contained in the property MUST be obeyed by clients that are caching responses.    The response message payload MUST contain credential information as defined in Credentials Format if the status is 200 or 201.\nThe response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     200 OK, the payload contains the credentials for the authentication identifier.   201 Created, the payload contains the newly created credentials for the authentication identifier.   400 Bad Request, the request message did not contain all mandatory properties or the subject DN of the certificate does not match the authentication identifier.   404 Not Found, there are no credentials registered matching the criteria.    For status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred. In this case, the response message\u0026rsquo;s content-type property SHOULD be set accordingly.\nDelivery States The Credentials service uses the following AMQP message delivery states when receiving request messages from clients:\n   Delivery State Description     ACCEPTED Indicates that the request message has been received and accepted for processing.   REJECTED Indicates that the request message has been received but cannot be processed. The disposition frame\u0026rsquo;s error field contains information regarding the reason why. Clients should not try to re-send the request using the same message properties in this case.    Credentials Format Credential data is carried in the body of an AMQP message as part of a single Data section. The message\u0026rsquo;s content-type property must be set to application/json.\nThe credential data is contained in the Data section as a UTF-8 encoded string representation of a single JSON object. It is an error to include payload that is not of this type.\nThe table below provides an overview of the standard members defined for the JSON object:\n   Name Mandatory JSON Type Default Value Description     device-id yes string  The ID of the device to which the credentials belong.   type yes string  The credential type name. The value may be arbitrarily chosen by clients but SHOULD reflect the particular type of authentication mechanism the credentials are to be used with. Possible values include (but are not limited to) psk, x509-cert, hashed-password etc.   auth-id yes string  The identity that the device should be authenticated as.   enabled no boolean true If set to false the credentials are not supposed to be used to authenticate devices any longer. This may e.g. be used to disable a particular mechanism for authenticating the device. NB It is the responsibility of the protocol adapter to make use of this information.   secrets yes array  A list of secrets scoped to a particular time period. See Secrets Format for details. NB This array must contain at least one element - an empty array is considered an error.    For each set of credentials the combination of auth-id and type MUST be unique within a tenant.\nThe device registry may choose to not return information which is not suitable for authentication a device. This includes for example the enabled property. If set to false, then the device registry may choose to treat this request as if no credentials would be found. For secrets for example, this could mean that the device registry does not return secrets which are not valid at the current point in time.\nNB Care needs to be taken that the value for the authentication identifier is compliant with the authentication mechanism(s) it is supposed to be used with. For example, when using standard HTTP Basic authentication, the username part of the Basic Authorization header value (which corresponds to the auth-id) MUST not contain any colon (:) characters, because the colon character is used as the separator between username and password. Similar constraints may exist for other authentication mechanisms, so the authentication identifier needs to be chosen with the anticipated mechanism(s) being used in mind. Otherwise, devices may fail to authenticate with protocol adapters, even if the credentials provided by the device match the credentials registered for the device. In general, using only characters from the [a-zA-Z0-9_-] range for the authentication identifier should be compatible with most mechanisms.\nSecrets Format Each set of credentials may contain arbitrary secrets scoped to a particular validity period during which the secrets may be used for authenticating a device. The validity periods MAY overlap in order to support the process of changing a secret on a device that itself doesn\u0026rsquo;t support the definition of multiple secrets for gapless authentication across adjacent validity periods.\nThe table below contains the properties used to define the validity period of a single secret:\n   Name Mandatory JSON Type Default Value Description     not-before no string null The point in time from which on the secret may be used to authenticate devices. If not null, the value MUST be an ISO 8601 compliant combined date and time representation in extended format. NB It is up to the discretion of the protocol adapter to make use of this information.   not-after no string null The point in time until which the secret may be used to authenticate devices. If not null, the value MUST be an ISO 8601 compliant combined date and time representation in extended format. NB It is up to the discretion of the protocol adapter to make use of this information.    Examples Below is an example for a payload containing a hashed password for device 4711 with auth-id sensor1 using SHA512 as the hashing function with a 4 byte salt (Base64 encoding of 0x32AEF017). Note that the payload does not contain a not-before property, thus it may be used immediately up until X-mas eve 2017.\n{ \u0026quot;device-id\u0026quot;: \u0026quot;4711\u0026quot;, \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor1\u0026quot;, \u0026quot;enabled\u0026quot;: true, \u0026quot;secrets\u0026quot;: [{ \u0026quot;not-after\u0026quot;: \u0026quot;2017-12-24T19:00:00+0100\u0026quot;, \u0026quot;pwd-hash\u0026quot;: \u0026quot;AQIDBAUGBwg=\u0026quot;, \u0026quot;salt\u0026quot;: \u0026quot;Mq7wFw==\u0026quot;, \u0026quot;hash-function\u0026quot;: \u0026quot;sha-512\u0026quot; }] }  The next example contains two pre-shared keys with overlapping validity periods for device myDevice with PSK identity little-sensor2.\n{ \u0026quot;device-id\u0026quot;: \u0026quot;myDevice\u0026quot;, \u0026quot;type\u0026quot;: \u0026quot;psk\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;little-sensor2\u0026quot;, \u0026quot;enabled\u0026quot;: true, \u0026quot;secrets\u0026quot;: [{ \u0026quot;not-after\u0026quot;: \u0026quot;2017-07-01T00:00:00+0100\u0026quot;, \u0026quot;key\u0026quot;: \u0026quot;cGFzc3dvcmRfb2xk\u0026quot; },{ \u0026quot;not-before\u0026quot;: \u0026quot;2017-06-29T00:00:00+0100\u0026quot;, \u0026quot;key\u0026quot;: \u0026quot;cGFzc3dvcmRfbmV3\u0026quot; }] }  Credential Verification Protocol Adapters are responsible for authenticating devices when they connect. The Credentials API provides the Get Credentials operation to support Protocol Adapters in doing so as illustrated below:\nThe following sequence diagram illustrates the flow of messages involved in a Protocol Adapter authenticating a device. This is shown for the MQTT Protocol Adapter as example how a device authenticates with a username and a hashed-password. The mechanism can be transferred to other protocols in a similar manner.\n  MQTT Adapter authenticates device using the Credentials service   Protocol adapters MUST comply with the following rules when verifying credentials presented by a device:\n Credentials that have their enabled property set to false MUST NOT be used for authentication. Adapters MUST only consider secrets for authentication which\n have their not-before property set to either null or the current or a past point in time and have their not-after property set to either null or the current or a future point in time.   Standard Credential Types The following sections define some standard credential types and their properties. Applications are encouraged to make use of these types. However, the types are not enforced anywhere in Hono and clients may of course add application specific properties to the credential types.\nCommon Properties All credential types used with Hono MUST contain device-id, type, auth-id, enabled and secrets properties as defined in Credentials Format.\nHashed Password A credential type for storing a (hashed) password for a device.\nExample:\n{ \u0026quot;device-id\u0026quot;: \u0026quot;4711\u0026quot;, \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor1\u0026quot;, \u0026quot;secrets\u0026quot;: [{ \u0026quot;pwd-hash\u0026quot;: \u0026quot;AQIDBAUGBwg=\u0026quot;, \u0026quot;salt\u0026quot;: \u0026quot;Mq7wFw==\u0026quot;, \u0026quot;hash-function\u0026quot;: \u0026quot;sha-512\u0026quot; }] }     Name Mandatory JSON Type Default Description     type yes string  The credential type name, always hashed-password.   auth-id yes string  The identity that the device should be authenticated as.   pwd-hash yes string  The password hash (see table below for details).   salt no string  The Base64 encoding of the salt used in the password hash (see table below for details).   hash-function no string sha-256 The name of the hash function used to create the password hash. The hash functions supported by Hono are described in the table below.    NB It is strongly recommended to use salted password hashes only. Furthermore, the salt should be unique per user and password, so no lookup table or rainbow table attacks can be used to crack the salt-hashed password. Whenever a password is updated for a user, the salt should change as well.\nNB The example above does not contain any of the not-before, not-after and enabled properties, thus the credentials can be used at any time according to the rules defined in Credential Verification.\nThe table below describes the hash functions supported by Hono and how they map to the secret structure.\n   Name Salt Usage Salt Location Password Hash Format     sha-256 optional salt field The Base64 encoding of the bytes resulting from applying the sha-256 hash function to the byte array consisting of the salt bytes (if a salt is used) and the UTF-8 encoding of the clear text password.   sha-512 optional salt field The Base64 encoding of the bytes resulting from applying the sha-512 hash function to the byte array consisting of the salt bytes (if a salt is used) and the UTF-8 encoding of the clear text password.   bcrypt mandatory pwd-hash value The output of applying the Bcrypt hash function to the clear text password. The salt is contained in the password hash.\nNB Hono (currently) uses Spring Security for matching clear text passwords against Bcrypt hashes. However, this library only supports hashes containing the $2a$ prefix (see https://github.com/fpirsch/twin-bcrypt#about-prefixes) so Hono will fail to verify any passwords for which the corresponding Bcrypt hashes returned by the Credentials service contain e.g. the $2y$ prefix.    Pre-Shared Key A credential type for storing a Pre-shared Key as used in TLS handshakes.\nExample:\n{ \u0026quot;device-id\u0026quot;: \u0026quot;4711\u0026quot;, \u0026quot;type\u0026quot;: \u0026quot;psk\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;little-sensor2\u0026quot;, \u0026quot;secrets\u0026quot;: [{ \u0026quot;key\u0026quot;: \u0026quot;AQIDBAUGBwg=\u0026quot; }] }     Name Mandatory JSON Type Description     type yes string The credential type name, always psk.   auth-id yes string The PSK identity.   key yes string The Base64 encoded bytes representing the shared (secret) key.    NB The example above does not contain any of the not-before, not-after and enabled properties, thus the credentials can be used at any time according to the rules defined in Credential Verification.\nX.509 Certificate A credential type for storing the RFC 2253 formatted subject DN of a client certificate that is used to authenticate the device as part of a TLS handshake.\nExample:\n{ \u0026quot;device-id\u0026quot;: \u0026quot;4711\u0026quot;, \u0026quot;type\u0026quot;: \u0026quot;x509-cert\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;CN=device-1,O=ACME Corporation\u0026quot;, \u0026quot;secrets\u0026quot;: [{}] }     Name Mandatory JSON Type Description     type yes string The credential type name, always x509-cert.   auth-id yes string The subject DN of the client certificate in the format defined by RFC 2253.    NB The example above does not contain any of the not-before, not-after and enabled properties. The not-before and not-after properties should be omitted if the validity period is the same as the period indicated by the client certificate\u0026rsquo;s corresponding properties. It is still necessary to provide a (empty) JSON object in the secrets array, though.\n"
+	"content": "The Credentials API is used by Protocol Adapters to retrieve credentials used to authenticate Devices connecting to the adapter. In particular, the API supports to look up shared secrets which are often used by IoT devices by means of username/password based authentication schemes.\nCredentials are of a certain type which indicates which authentication mechanism the credentials can be used with. Each set of credentials also contains an authentication identity which is the identity claimed by the device during authentication. This authentication identity is usually different from the device-id the device has been registered under. A device may have multiple sets of credentials, using arbitrary authentication identities.\nThe Credentials API is defined by means of AMQP 1.0 message exchanges, i.e. a client needs to connect to Hono using an AMQP 1.0 client in order to invoke operations of the API as described in the following sections.\n\nPreconditions for invoking the Credentials API  Client has established an AMQP connection with the Credentials service. Client has established an AMQP link in role sender on the connection using target address credentials/${tenant_id}. This link is used by the client to send commands to the Credentials service. Client has established an AMQP link in role receiver on the connection using source address credentials/${tenant_id}/${reply-to} where reply-to may be any arbitrary string chosen by the client. This link is used by the client to receive responses to the requests it has sent to the Credentials service. This link\u0026rsquo;s source address is also referred to as the reply-to address for the request messages.    Client connecting to Credentials service   Get Credentials Protocol adapters use this command to look up credentials of a particular type for a device identity.\nMessage Flow\n  Client looking up credentials for a device   Request Message Format\nThe following table provides an overview of the properties a client needs to set on an get credentials message.\n   Name Mandatory Location AMQP Type Description     correlation-id no properties message-id MAY contain an ID used to correlate a response message to the original request. If set, it is used as the correlation-id property in the response, otherwise the value of the message-id property is used. Either this or the message-id property MUST be set.   message-id no properties string MAY contain an identifier that uniquely identifies the message at the sender side. Either this or the correlation-id property MUST be set.   reply-to yes properties string MUST contain the source address that the client wants to receive response messages from. This address MUST be the same as the source address used for establishing the client\u0026rsquo;s receive link (see Preconditions).   subject yes properties string MUST contain the value get.    The body of the request MUST consist of a single Data section containing a UTF-8 encoded string representation of a single JSON object having the following members:\n   Name Mandatory JSON Type Description     type yes string The type of credentials to look up. Potential values include (but are not limited to) psk, x509-cert, hashed-password etc.   auth-id yes string The authentication identifier to look up credentials for.   client-certificate no string The client certificate the device authenticated with. If present, it MUST be the DER encoding of the (validated) X.509 client certificate as a Base64 encoded byte array and it\u0026rsquo;s subject DN MUST match the auth-id.    The client-certificate property MAY be used by the service implementation for auto-provisioning of devices. To do so, the device registry needs to create credentials (and registration data) for the device if they do not already exist.\nAdditionally, the body MAY contain arbitrary properties that service implementations can use to determine a device\u0026rsquo;s identity.\nThe following request payload may be used to look up the hashed password for a device with the authentication identifier sensor1:\n{ \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor1\u0026quot; }  The following request payload may be used to look up or create x509-cert credentials for a device with the authentication identifier CN=device-1,O=ACME Corporation:\n{ \u0026quot;type\u0026quot;: \u0026quot;x509-cert\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;CN=device-1,O=ACME Corporation\u0026quot;, \u0026quot;client-certificate\u0026quot;: \u0026quot;DeviceCert==\u0026quot; }  Response Message Format\nA response to a get credentials request contains the following properties:\n   Name Mandatory Location AMQP Type Description     correlation-id yes properties message-id Contains the message-id (or the correlation-id, if specified) of the request message that this message is the response to.   content-type no properties string MUST be set to application/json if the invocation of the operation was successful and the body of the response message contains payload as described below.   status yes application-properties int Contains the status code indicating the outcome of the operation. Concrete values and their semantics are defined below.   cache_control no application-properties string Contains an RFC 2616 compliant cache directive. The directive contained in the property MUST be obeyed by clients that are caching responses.    The response message payload MUST contain credential information as defined in Credentials Format if the status is 200 or 201.\nThe response message\u0026rsquo;s status property may contain the following codes:\n   Code Description     200 OK, the payload contains the credentials for the authentication identifier.   201 Created, the payload contains the newly created credentials for the authentication identifier.   400 Bad Request, the request message did not contain all mandatory properties or the subject DN of the certificate does not match the authentication identifier.   404 Not Found, there are no credentials registered matching the criteria.    For status codes indicating an error (codes in the 400 - 499 range) the message body MAY contain a detailed description of the error that occurred. In this case, the response message\u0026rsquo;s content-type property SHOULD be set accordingly.\nDelivery States The Credentials service uses the following AMQP message delivery states when receiving request messages from clients:\n   Delivery State Description     ACCEPTED Indicates that the request message has been received and accepted for processing.   REJECTED Indicates that the request message has been received but cannot be processed. The disposition frame\u0026rsquo;s error field contains information regarding the reason why. Clients should not try to re-send the request using the same message properties in this case.    Credentials Format Credential data is carried in the body of an AMQP message as part of a single Data section. The message\u0026rsquo;s content-type property must be set to application/json.\nThe credential data is contained in the Data section as a UTF-8 encoded string representation of a single JSON object. It is an error to include payload that is not of this type.\nThe table below provides an overview of the standard members defined for the JSON object:\n   Name Mandatory JSON Type Default Value Description     device-id yes string  The ID of the device to which the credentials belong.   type yes string  The credential type name. The value may be arbitrarily chosen by clients but SHOULD reflect the particular type of authentication mechanism the credentials are to be used with. Possible values include (but are not limited to) psk, x509-cert, hashed-password etc.   auth-id yes string  The identity that the device should be authenticated as.   enabled no boolean true If set to false the credentials are not supposed to be used to authenticate devices any longer. This may e.g. be used to disable a particular mechanism for authenticating the device. NB It is the responsibility of the protocol adapter to make use of this information.   secrets yes array  A list of secrets scoped to a particular time period. See Secrets Format for details. NB This array must contain at least one element - an empty array is considered an error.    For each set of credentials the combination of auth-id and type MUST be unique within a tenant.\nThe device registry may choose to not return information which is not suitable for authentication a device. This includes for example the enabled property. If set to false, then the device registry may choose to treat this request as if no credentials would be found. For secrets for example, this could mean that the device registry does not return secrets which are not valid at the current point in time.\nNB Care needs to be taken that the value for the authentication identifier is compliant with the authentication mechanism(s) it is supposed to be used with. For example, when using standard HTTP Basic authentication, the username part of the Basic Authorization header value (which corresponds to the auth-id) MUST not contain any colon (:) characters, because the colon character is used as the separator between username and password. Similar constraints may exist for other authentication mechanisms, so the authentication identifier needs to be chosen with the anticipated mechanism(s) being used in mind. Otherwise, devices may fail to authenticate with protocol adapters, even if the credentials provided by the device match the credentials registered for the device. In general, using only characters from the [a-zA-Z0-9_-] range for the authentication identifier should be compatible with most mechanisms.\nSecrets Format Each set of credentials may contain arbitrary secrets scoped to a particular validity period during which the secrets may be used for authenticating a device. The validity periods MAY overlap in order to support the process of changing a secret on a device that itself doesn\u0026rsquo;t support the definition of multiple secrets for gapless authentication across adjacent validity periods.\nThe table below contains the properties used to define the validity period of a single secret:\n   Name Mandatory JSON Type Default Value Description     not-before no string null The point in time from which on the secret may be used to authenticate devices. If not null, the value MUST be an ISO 8601 compliant combined date and time representation in extended format. NB It is up to the discretion of the protocol adapter to make use of this information.   not-after no string null The point in time until which the secret may be used to authenticate devices. If not null, the value MUST be an ISO 8601 compliant combined date and time representation in extended format. NB It is up to the discretion of the protocol adapter to make use of this information.    Examples Below is an example for a payload containing a hashed password for device 4711 with auth-id sensor1 using SHA512 as the hashing function with a 4 byte salt (Base64 encoding of 0x32AEF017). Note that the payload does not contain a not-before property, thus it may be used immediately up until X-mas eve 2017.\n{ \u0026quot;device-id\u0026quot;: \u0026quot;4711\u0026quot;, \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor1\u0026quot;, \u0026quot;enabled\u0026quot;: true, \u0026quot;secrets\u0026quot;: [{ \u0026quot;not-after\u0026quot;: \u0026quot;2017-12-24T19:00:00+0100\u0026quot;, \u0026quot;pwd-hash\u0026quot;: \u0026quot;AQIDBAUGBwg=\u0026quot;, \u0026quot;salt\u0026quot;: \u0026quot;Mq7wFw==\u0026quot;, \u0026quot;hash-function\u0026quot;: \u0026quot;sha-512\u0026quot; }] }  The next example contains two pre-shared keys with overlapping validity periods for device myDevice with PSK identity little-sensor2.\n{ \u0026quot;device-id\u0026quot;: \u0026quot;myDevice\u0026quot;, \u0026quot;type\u0026quot;: \u0026quot;psk\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;little-sensor2\u0026quot;, \u0026quot;enabled\u0026quot;: true, \u0026quot;secrets\u0026quot;: [{ \u0026quot;not-after\u0026quot;: \u0026quot;2017-07-01T00:00:00+0100\u0026quot;, \u0026quot;key\u0026quot;: \u0026quot;cGFzc3dvcmRfb2xk\u0026quot; },{ \u0026quot;not-before\u0026quot;: \u0026quot;2017-06-29T00:00:00+0100\u0026quot;, \u0026quot;key\u0026quot;: \u0026quot;cGFzc3dvcmRfbmV3\u0026quot; }] }  Credential Verification Protocol Adapters are responsible for authenticating devices when they connect. The Credentials API provides the Get Credentials operation to support Protocol Adapters in doing so as illustrated below:\nThe following sequence diagram illustrates the flow of messages involved in a Protocol Adapter authenticating a device. This is shown for the MQTT Protocol Adapter as example how a device authenticates with a username and a hashed-password. The mechanism can be transferred to other protocols in a similar manner.\n  MQTT Adapter authenticates device using the Credentials service   Protocol adapters MUST comply with the following rules when verifying credentials presented by a device:\n Credentials that have their enabled property set to false MUST NOT be used for authentication. Adapters MUST only consider secrets for authentication which\n have their not-before property set to either null or the current or a past point in time and have their not-after property set to either null or the current or a future point in time.   Standard Credential Types The following sections define some standard credential types and their properties. Applications are encouraged to make use of these types. However, the types are not enforced anywhere in Hono and clients may of course add application specific properties to the credential types.\nCommon Properties All credential types used with Hono MUST contain device-id, type, auth-id, enabled and secrets properties as defined in Credentials Format.\nHashed Password A credential type for storing a (hashed) password for a device.\nExample:\n{ \u0026quot;device-id\u0026quot;: \u0026quot;4711\u0026quot;, \u0026quot;type\u0026quot;: \u0026quot;hashed-password\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;sensor1\u0026quot;, \u0026quot;secrets\u0026quot;: [{ \u0026quot;pwd-hash\u0026quot;: \u0026quot;AQIDBAUGBwg=\u0026quot;, \u0026quot;salt\u0026quot;: \u0026quot;Mq7wFw==\u0026quot;, \u0026quot;hash-function\u0026quot;: \u0026quot;sha-512\u0026quot; }] }     Name Mandatory JSON Type Default Description     type yes string  The credential type name, always hashed-password.   auth-id yes string  The identity that the device should be authenticated as.   pwd-hash yes string  The password hash (see table below for details).   salt no string  The Base64 encoding of the salt used in the password hash (see table below for details).   hash-function no string sha-256 The name of the hash function used to create the password hash. The hash functions supported by Hono are described in the table below.    NB It is strongly recommended to use salted password hashes only. Furthermore, the salt should be unique per user and password, so no lookup table or rainbow table attacks can be used to crack the salt-hashed password. Whenever a password is updated for a user, the salt should change as well.\nNB The example above does not contain any of the not-before, not-after and enabled properties, thus the credentials can be used at any time according to the rules defined in Credential Verification.\nThe table below describes the hash functions supported by Hono and how they map to the secret structure.\n   Name Salt Usage Salt Location Password Hash Format     sha-256 optional salt field The Base64 encoding of the bytes resulting from applying the sha-256 hash function to the byte array consisting of the salt bytes (if a salt is used) and the UTF-8 encoding of the clear text password.   sha-512 optional salt field The Base64 encoding of the bytes resulting from applying the sha-512 hash function to the byte array consisting of the salt bytes (if a salt is used) and the UTF-8 encoding of the clear text password.   bcrypt mandatory pwd-hash value The output of applying the Bcrypt hash function to the clear text password. The salt is contained in the password hash.\nNB Hono (currently) uses Spring Security for matching clear text passwords against Bcrypt hashes. However, this library only supports hashes containing the $2a$ prefix (see https://github.com/fpirsch/twin-bcrypt#about-prefixes) so Hono will fail to verify any passwords for which the corresponding Bcrypt hashes returned by the Credentials service contain e.g. the $2y$ prefix.    Pre-Shared Key A credential type for storing a Pre-shared Key as used in (D)TLS handshakes.\nExample:\n{ \u0026quot;device-id\u0026quot;: \u0026quot;4711\u0026quot;, \u0026quot;type\u0026quot;: \u0026quot;psk\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;little-sensor2\u0026quot;, \u0026quot;secrets\u0026quot;: [{ \u0026quot;key\u0026quot;: \u0026quot;AQIDBAUGBwg=\u0026quot; }] }     Name Mandatory JSON Type Description     type yes string The credential type name, always psk.   auth-id yes string The PSK identity.   key yes string The Base64 encoded bytes representing the shared (secret) key.    NB The example above does not contain any of the not-before, not-after and enabled properties, thus the credentials can be used at any time according to the rules defined in Credential Verification.\nX.509 Certificate A credential type for storing the RFC 2253 formatted subject DN of a client certificate that is used to authenticate the device as part of a (D)TLS handshake.\nExample:\n{ \u0026quot;device-id\u0026quot;: \u0026quot;4711\u0026quot;, \u0026quot;type\u0026quot;: \u0026quot;x509-cert\u0026quot;, \u0026quot;auth-id\u0026quot;: \u0026quot;CN=device-1,O=ACME Corporation\u0026quot;, \u0026quot;secrets\u0026quot;: [{}] }     Name Mandatory JSON Type Description     type yes string The credential type name, always x509-cert.   auth-id yes string The subject DN of the client certificate in the format defined by RFC 2253.    NB The example above does not contain any of the not-before, not-after and enabled properties. The not-before and not-after properties should be omitted if the validity period is the same as the period indicated by the client certificate\u0026rsquo;s corresponding properties. It is still necessary to provide a (empty) JSON object in the secrets array, though.\n"
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/api/authentication/",
@@ -333,7 +354,7 @@
 	"title": "Metrics",
 	"tags": [],
 	"description": "",
-	"content": "Eclipse Hono\u0026trade;\u0026rsquo;s components report several metrics which may be used to gain some insight into the running system. For instance, the HTTP adapter reports the number of successfully processed telemetry messages. Some of these metrics are considered part of Hono\u0026rsquo;s external interface. This section describes the semantics and format of the metrics, how they can be retrieved and how to interpret actual values.\nReported Metrics Hono uses Micrometer in combination with Spring Boot to internally collect metrics. Those metrics can be exported to different back ends. Please refer to Configuring Metrics for details.\nThe example deployment by default uses Prometheus as the metrics back end.\nWhen deploying to Kubernetes/OpenShift, the metrics reported by Hono may contain environment specific tags (like the pod name) which are added by the Prometheus scraper. However, those tags are not part of the Hono metrics definition.\nHono applications may report other metrics in addition to the ones defined here. In particular, all components report metrics regarding the JVM\u0026rsquo;s internal state, e.g. memory consumption and garbage collection status. Those metrics are not considered part of Hono\u0026rsquo;s official metrics definition. However, all those metrics will still contain tags as described below.\nCommon Metrics Tags for common metrics are:\n   Tag Value Description     host string The name of the host that the component reporting the metric is running on   component-type adapter, service The type of component reporting the metric   component-name string The name of the component reporting the metric.    The names of Hono\u0026rsquo;s standard components are as follows:\n   Component component-name     Auth Server hono-auth   Device Registry hono-registry   AMQP adapter hono-amqp   CoAP adapter hono-coap   HTTP adapter hono-http   Kura adapter hono-kura-mqtt   MQTT adapter hono-mqtt   Lora adapter hono-lora   Sigfox adapter hono-sigfox    Protocol Adapter Metrics Additional tags for protocol adapters are:\n   Name Value Description     direction one-way, request, response The direction in which a Command \u0026amp; Control message is being sent:\none-way indicates a command sent to a device for which the sending application doesn\u0026rsquo;t expect to receive a response.\nrequest indicates a command request message sent to a device.\nresponse indicates a command response received from a device.   qos 0, 1, unknown The quality of service used for a telemetry or event message.\n0 indicates at most once,\n1 indicates at least once and\nnone indicates unknown delivery semantics.   status forwarded, unprocessable, undeliverable The processing status of a message.\nforwarded indicates that the message has been forwarded to a downstream consumer\nunprocessable indicates that the message has not been processed not forwarded, e.g. because the message was malformed\nundeliverable indicates that the message could not be forwarded, e.g. because there is no downstream consumer or due to an infrastructure problem   tenant string The identifier of the tenant that the metric is being reported for   ttd command, expired, none A status indicating the outcome of processing a TTD value contained in a message received from a device.\ncommand indicates that a command for the device has been included in the response to the device\u0026rsquo;s request for uploading the message.\nexpired indicates that a response without a command has been sent to the device.\nnone indicates that either no TTD value has been specified by the device or that the protocol adapter does not support it.   type telemetry, event The type of (downstream) message that the metric is being reported for.    Metrics provided by the protocol adapters are:\n   Metric Type Tags Description     hono.commands.received Timer host, component-type, component-name, tenant, type, status, direction The time it took to process a message conveying a command or a response to a command.   hono.commands.payload DistributionSummary host, component-type, component-name, tenant, type, status, direction The number of bytes conveyed in the payload of a command message.   hono.connections.authenticated Gauge host, component-type, component-name, tenant Current number of connected, authenticated devices.  NB This metric is only supported by protocol adapters that maintain connection state with authenticated devices. In particular, the HTTP adapter does not support this metric.   hono.connections.unauthenticated Gauge host, component-type, component-name Current number of connected, unauthenticated devices.  NB This metric is only supported by protocol adapters that maintain connection state with authenticated devices. In particular, the HTTP adapter does not support this metric.   hono.connections.authenticated.duration Timer host, component-type, component-name, tenant The overall amount of time that authenticated devices have been connected to protocol adapters.  NB This metric is only supported by protocol adapters that maintain connection state with authenticated devices. In particular, the HTTP adapter does not support this metric.   hono.messages.received Timer host, component-type, component-name, tenant, type, status, qos, ttd The time it took to process a message conveying telemetry data or an event.   hono.messages.payload DistributionSummary host, component-type, component-name, tenant, type, status The number of bytes conveyed in the payload of a telemetry or event message.    Minimum Message Size If a minimum message size is configured for a tenant, then the payload size of the telemetry, event and command messages are calculated in accordance with the configured value and then reported to the metrics by the AMQP, HTTP and MQTT protocol adapters. If minimum message size is not configured for a tenant then the actual message payload size is reported.\nAssume that the minimum message size for a tenant is configured as 4096 bytes (4KB). The payload size of an incoming message with size 1KB is calculated as 4KB by the protocol adapters and reported to the metrics system. For an incoming message of size 10KB, it is reported as 12KB.\nService Metrics Hono\u0026rsquo;s service components do not report any metrics at the moment.\n"
+	"content": "Eclipse Hono\u0026trade;\u0026rsquo;s components report several metrics which may be used to gain some insight into the running system. For instance, the HTTP adapter reports the number of successfully processed telemetry messages. Some of these metrics are considered part of Hono\u0026rsquo;s external interface. This section describes the semantics and format of the metrics, how they can be retrieved and how to interpret actual values.\nReported Metrics Hono uses Micrometer in combination with Spring Boot to internally collect metrics. Those metrics can be exported to different back ends. Please refer to Configuring Metrics for details.\nThe example deployment by default uses Prometheus as the metrics back end.\nWhen deploying to Kubernetes/OpenShift, the metrics reported by Hono may contain environment specific tags (like the pod name) which are added by the Prometheus scraper. However, those tags are not part of the Hono metrics definition.\nHono applications may report other metrics in addition to the ones defined here. In particular, all components report metrics regarding the JVM\u0026rsquo;s internal state, e.g. memory consumption and garbage collection status. Those metrics are not considered part of Hono\u0026rsquo;s official metrics definition. However, all those metrics will still contain tags as described below.\nCommon Metrics Tags for common metrics are:\n   Tag Value Description     host string The name of the host that the component reporting the metric is running on   component-type adapter, service The type of component reporting the metric   component-name string The name of the component reporting the metric.    The names of Hono\u0026rsquo;s standard components are as follows:\n   Component component-name     Auth Server hono-auth   Device Registry hono-registry   AMQP adapter hono-amqp   CoAP adapter hono-coap   HTTP adapter hono-http   Kura adapter hono-kura-mqtt   MQTT adapter hono-mqtt   Lora adapter hono-lora   Sigfox adapter hono-sigfox    Protocol Adapter Metrics Additional tags for protocol adapters are:\n   Name Value Description     direction one-way, request, response The direction in which a Command \u0026amp; Control message is being sent:\none-way indicates a command sent to a device for which the sending application doesn\u0026rsquo;t expect to receive a response.\nrequest indicates a command request message sent to a device.\nresponse indicates a command response received from a device.   qos 0, 1, unknown The quality of service used for a telemetry or event message.\n0 indicates at most once,\n1 indicates at least once and\nnone indicates unknown delivery semantics.   status forwarded, unprocessable, undeliverable The processing status of a message.\nforwarded indicates that the message has been forwarded to a downstream consumer\nunprocessable indicates that the message has not been processed not forwarded, e.g. because the message was malformed\nundeliverable indicates that the message could not be forwarded, e.g. because there is no downstream consumer or due to an infrastructure problem   tenant string The identifier of the tenant that the metric is being reported for   ttd command, expired, none A status indicating the outcome of processing a TTD value contained in a message received from a device.\ncommand indicates that a command for the device has been included in the response to the device\u0026rsquo;s request for uploading the message.\nexpired indicates that a response without a command has been sent to the device.\nnone indicates that either no TTD value has been specified by the device or that the protocol adapter does not support it.   type telemetry, event The type of (downstream) message that the metric is being reported for.    Metrics provided by the protocol adapters are:\n   Metric Type Tags Description     hono.commands.received Timer host, component-type, component-name, tenant, type, status, direction The time it took to process a message conveying a command or a response to a command.   hono.commands.payload DistributionSummary host, component-type, component-name, tenant, type, status, direction The number of bytes conveyed in the payload of a command message.   hono.connections.authenticated Gauge host, component-type, component-name, tenant Current number of connected, authenticated devices.  NB This metric is only supported by protocol adapters that maintain connection state with authenticated devices. In particular, the HTTP adapter does not support this metric.   hono.connections.unauthenticated Gauge host, component-type, component-name Current number of connected, unauthenticated devices.  NB This metric is only supported by protocol adapters that maintain connection state with authenticated devices. In particular, the HTTP adapter does not support this metric.   hono.connections.authenticated.duration Timer host, component-type, component-name, tenant The overall amount of time that authenticated devices have been connected to protocol adapters.  NB This metric is only supported by protocol adapters that maintain connection state with authenticated devices. In particular, the HTTP adapter does not support this metric.   hono.connections.attempts Counter host, component-type, component-name, outcome The number of connection attempts to protocol adapters. The outcome can be observed by looking the tag outcome which contains the result and the reason. At the moment there\u0026rsquo;s only one possible value: adapter-connection-limit-exceeded NB This metric is only supported by protocol adapters that maintain connection state with authenticated devices. In particular, the HTTP adapter does not support this metric.   hono.messages.received Timer host, component-type, component-name, tenant, type, status, qos, ttd The time it took to process a message conveying telemetry data or an event.   hono.messages.payload DistributionSummary host, component-type, component-name, tenant, type, status The number of bytes conveyed in the payload of a telemetry or event message.    Minimum Message Size If a minimum message size is configured for a tenant, then the payload size of the telemetry, event and command messages are calculated in accordance with the configured value and then reported to the metrics by the AMQP, HTTP and MQTT protocol adapters. If minimum message size is not configured for a tenant then the actual message payload size is reported.\nAssume that the minimum message size for a tenant is configured as 4096 bytes (4KB). The payload size of an incoming message with size 1KB is calculated as 4KB by the protocol adapters and reported to the metrics system. For an incoming message of size 10KB, it is reported as 12KB.\nService Metrics Hono\u0026rsquo;s service components do not report any metrics at the moment.\n"
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/deployment/",
@@ -347,7 +368,7 @@
 	"title": "Helm based Deployment",
 	"tags": [],
 	"description": "",
-	"content": "Eclipse Hono\u0026trade;\u0026rsquo;s components are provided as container images which can be run on arbitrary container orchestration platforms. This page describes the steps necessary to deploy Hono to a Kubernetes cluster using the Helm package manager.\nInstalling Hono Hono\u0026rsquo;s Helm chart is available from the Eclipse IoT Packages chart repository. Please refer to the chart\u0026rsquo;s README for instructions regarding installation and configuration.\nDeploying custom Container Images The chart by default installs Hono\u0026rsquo;s pre-built container images. In some cases it might be desirable to build Hono from source, e.g. in order to use a different metrics back end or to use Jaeger tracing.\nThe container images created as part of the build process need to be made available to the Kubernetes cluster that Hono should be installed to. This usually requires the images to be pushed to a (private) container registry that the cluster can pull them from. Please refer to the documentation of the employed Kubernetes service provider for details regarding the setup and configuration of a private container registry.\nDeploying via a private Registry The first step is getting the source code of Hono. Please refer to Building from Source for details. Once the source code has been retrieved, the build process can be started using the following command:\n# in base directory of Hono working tree: mvn clean install -Pbuild-docker-image,metrics-prometheus  After the build process has finished, the custom container images need to be pushed to the registry so that the Kubernetes cluster can pull them from there during deployment. Assuming that the images should be tagged with 1.0.3-CUSTOM and the container registry name is my.registry.io, the following command can be used to tag the locally built images and push them to the registry:\n# in base directory of Hono working tree: ./push_hono_images.sh 1.0.3-CUSTOM my.registry.io   Note You may need to log in to the (private) container registry before pushing the images.  The image names that Hono should use for starting up containers can be configured in a YAML file:\ndeviceRegistryExample: imageName: \u0026quot;my.registry.io/eclipse/hono-service-device-registry-file:1.0.3-CUSTOM\u0026quot; authServer: imageName: \u0026quot;my.registry.io/eclipse/hono-service-auth:1.0.3-CUSTOM\u0026quot; deviceConnectionService: imageName: \u0026quot;my.registry.io/eclipse/hono-service-device-connection:1.0.3-CUSTOM\u0026quot; adapters: amqp: imageName: \u0026quot;my.registry.io/eclipse/hono-adapter-amqp-vertx:1.0.3-CUSTOM\u0026quot; mqtt: imageName: \u0026quot;my.registry.io/eclipse/hono-adapter-mqtt-vertx:1.0.3-CUSTOM\u0026quot; http: imageName: \u0026quot;my.registry.io/eclipse/hono-adapter-http-vertx:1.0.3-CUSTOM\u0026quot;  Assuming that the YAML file is called imageNames.yaml, installation can then be done using:\nhelm install --dependency-update -n hono -f imageNames.yaml eclipse-hono eclipse-iot/hono  Deploying to Minikube When using Minikube as the deployment target, things are a little easier. Minikube comes with an embedded Docker daemon which can be used to build the container images instead of using a local Docker daemon, thus eliminating the need to push the images to a registry altogether. In order to use Minikube\u0026rsquo;s Docker daemon, the following command needs to be run:\neval $(minikube docker-env)  This will set the Docker environment variables to point to Minikube\u0026rsquo;s Docker daemon which can then be used for building the container images and storing them locally in the Minikube VM.\nIn any case the build process can be started using the following command:\n# in base directory of Hono working tree: mvn clean install -Pbuild-docker-image,metrics-prometheus  The newly built images can then be deployed using Helm:\nhelm install --dependency-update -n hono eclipse-hono eclipse-iot/hono  Using Jaeger Tracing Hono\u0026rsquo;s components are instrumented using OpenTracing to allow tracking of the distributed processing of messages flowing through the system. The Hono chart can be configured to report tracing information to the Jaeger tracing system. The Spans reported by the components can then be viewed in a web browser.\nIn order for Hono\u0026rsquo;s components to use the Jaeger client for reporting tracing information, the container images need to be built with the jaeger Maven profile. Please refer to Monitoring \u0026amp; Tracing for details. The newly built images also need to be made available to the target Kubernetes cluster as described in the two previous sections.\nThe chart can be configured to deploy and use an example Jaeger back end by means of setting the jaegerBackendExample.enabled property to true when running Helm:\nhelm install --dependency-update -n hono --set jaegerBackendExample.enabled=true eclipse-hono eclipse-iot/hono  This will create a Jaeger back end instance suitable for testing purposes and will configure all deployed Hono components to use the Jaeger back end.\nThe following command can then be used to return the IP address with which the Jaeger UI can be accessed in a browser (ensure minikube tunnel is running when using minikube):\nkubectl get service hono-jaeger-query --output='jsonpath={.status.loadBalancer.ingress[0].ip}' -n hono  If no example Jaeger back end should be deployed but instead an existing Jaeger installation should be used, the chart\u0026rsquo;s jaegerAgentConf property can be set to environment variables which are passed in to the Jaeger Agent that is deployed with each of Hono\u0026rsquo;s components.\nhelm install --dependency-update -n hono --set jaegerAgentConf.REPORTER_TYPE=tchannel --set jaegerAgentConf.REPORTER_TCHANNEL_HOST_PORT=my-jaeger-collector:14267 eclipse-hono eclipse-iot/hono  Deploying to Azure Kubernetes Service (AKS) The following chapter describes how to use Azure Kubernetes Service (AKS) as a deployment target that has been set up as described in the Setting up a Kubernetes Cluster guide.\nFirst we build the docker images and push them into the ACR. Note that if you define a custom image tag you have to provide the helm with the image tags as described in the chapters above.\n# Resource group where the ACR is deployed. acr_resourcegroupname={YOUR_ACR_RG} # Name of your ACR. acr_registry_name={YOUR_ACR_NAME} # Full name of the ACR. acr_login_server=$acr_registry_name.azurecr.io # Authenticate your docker daemon with the ACR. az acr login --name $ACR_NAME # Build images. cd hono mvn install -Pbuild-docker-image -Ddocker.registry=$acr_login_server # Push images to ACR. ./push_hono_images.sh 1.0.0-SNAPSHOT $acr_login_server  Now we can retrieve settings from the deployment for the following steps:\n# Resource group of the AKS deployment resourcegroup_name=hono aks_cluster_name=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.aksClusterName.value -o tsv` http_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.httpPublicIPAddress.value -o tsv` amqp_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.amqpPublicIPAddress.value -o tsv` mqtt_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.mqttPublicIPAddress.value -o tsv` registry_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.registryPublicIPAddress.value -o tsv` network_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.networkPublicIPAddress.value -o tsv`  Note: add the following lines in case you opted for the Azure Service Bus variant:\nservice_bus_namespace=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.serviceBusNamespaceName.value -o tsv` service_bus_key_name=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.serviceBusKeyName.value -o tsv` service_bus_key=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.serviceBusKey.value -o tsv`  Next we prepare the k8s environment:\nk8s_namespace=honons kubectl create namespace $k8s_namespace  Finally install Hono. Leveraging the managed-premium-retain storage in combination with deviceRegistry.resetFiles=false parameter is optional but ensures that Device registry storage will retain future update deployments.\n# in Hono working tree directory: hono/deploy helm install target/deploy/helm/eclipse-hono/ \\ --dep-up \\ --name hono \\ --namespace $k8s_namespace \\ --set adapters.mqtt.svc.annotations.\u0026quot;service\\.beta\\.kubernetes\\.io/azure-load-balancer-resource-group\u0026quot;=$resourcegroup_name \\ --set adapters.http.svc.annotations.\u0026quot;service\\.beta\\.kubernetes\\.io/azure-load-balancer-resource-group\u0026quot;=$resourcegroup_name \\ --set adapters.amqp.svc.annotations.\u0026quot;service\\.beta\\.kubernetes\\.io/azure-load-balancer-resource-group\u0026quot;=$resourcegroup_name \\ --set deviceRegistryExample.svc.annotations.\u0026quot;service\\.beta\\.kubernetes\\.io/azure-load-balancer-resource-group\u0026quot;=$resourcegroup_name \\ --set amqpMessagingNetworkExample.dispatchRouter.svc.annotations.\u0026quot;service\\.beta\\.kubernetes\\.io/azure-load-balancer-resource-group\u0026quot;=$resourcegroup_name \\ --set deviceRegistryExample.storageClass=managed-premium-retain \\ --set deviceRegistryExample.resetFiles=false \\ --set adapters.mqtt.svc.loadBalancerIP=$mqtt_ip_address \\ --set adapters.http.svc.loadBalancerIP=$http_ip_address \\ --set adapters.amqp.svc.loadBalancerIP=$amqp_ip_address \\ --set deviceRegistryExample.svc.loadBalancerIP=$registry_ip_address \\ --set amqpMessagingNetworkExample.dispatchRouter.svc.loadBalancerIP=$network_ip_address  Note: add the following lines in case you opted for the Azure Service Bus variant:\n# Router update required to work together with Azure Service Bus --set amqpMessagingNetworkExample.dispatchRouter.imageName=quay.io/enmasse/qdrouterd-base:1.8.0 \\ --set amqpMessagingNetworkExample.broker.type=servicebus \\ --set amqpMessagingNetworkExample.broker.servicebus.saslUsername=$service_bus_key_name \\ --set amqpMessagingNetworkExample.broker.servicebus.saslPassword=$service_bus_key \\ --set amqpMessagingNetworkExample.broker.servicebus.host=$service_bus_namespace.servicebus.windows.net \\  Have fun with Hono on Microsoft Azure!\nNext steps:\nYou can follow the steps as described in the Getting Started guide with the following differences:\nCompared to a plain k8s deployment Azure provides us DNS names with static IPs for the Hono endpoints. To retrieve them:\nHTTP_ADAPTER_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.httpPublicIPFQDN.value -o tsv` AMQP_ADAPTER_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.amqpPublicIPFQDN.value -o tsv` MQTT_ADAPTER_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.mqttPublicIPFQDN.value -o tsv` REGISTRY_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.registryPublicIPFQDN.value -o tsv` AMQP_NETWORK_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.networkPublicIPFQDN.value -o tsv`  As Azure Service Bus does not support auto creation of queues you have to create a queue per tenant (ID), e.g. after you have created your tenant run:\naz servicebus queue create --resource-group $resourcegroup_name \\ --namespace-name $service_bus_namespace \\ --name $MY_TENANT "
+	"content": "Eclipse Hono\u0026trade;\u0026rsquo;s components are provided as container images which can be run on arbitrary container orchestration platforms. This page describes the steps necessary to deploy Hono to a Kubernetes cluster using the Helm package manager.\nInstalling Hono Hono\u0026rsquo;s Helm chart is available from the Eclipse IoT Packages chart repository. Please refer to the chart\u0026rsquo;s README for instructions regarding installation and configuration.\nDeploying custom Container Images The chart by default installs Hono\u0026rsquo;s pre-built container images. In some cases it might be desirable to build Hono from source, e.g. in order to use a different metrics back end or to use Jaeger tracing.\nThe container images created as part of the build process need to be made available to the Kubernetes cluster that Hono should be installed to. This usually requires the images to be pushed to a (private) container registry that the cluster can pull them from. Please refer to the documentation of the employed Kubernetes service provider for details regarding the setup and configuration of a private container registry.\nDeploying via a private Registry The first step is getting the source code of Hono. Please refer to Building from Source for details. Once the source code has been retrieved, the build process can be started using the following command:\n# in base directory of Hono working tree: mvn clean install -Pbuild-docker-image,metrics-prometheus  After the build process has finished, the custom container images need to be pushed to the registry so that the Kubernetes cluster can pull them from there during deployment. Assuming that the images should be tagged with 1.0.3-CUSTOM and the container registry name is my.registry.io, the following command can be used to tag the locally built images and push them to the registry:\n# in base directory of Hono working tree: ./push_hono_images.sh 1.0.3-CUSTOM my.registry.io   Note You may need to log in to the (private) container registry before pushing the images.  The image names that Hono should use for starting up containers can be configured in a YAML file:\ndeviceRegistryExample: imageName: \u0026quot;my.registry.io/eclipse/hono-service-device-registry-file:1.0.3-CUSTOM\u0026quot; authServer: imageName: \u0026quot;my.registry.io/eclipse/hono-service-auth:1.0.3-CUSTOM\u0026quot; deviceConnectionService: imageName: \u0026quot;my.registry.io/eclipse/hono-service-device-connection:1.0.3-CUSTOM\u0026quot; adapters: amqp: imageName: \u0026quot;my.registry.io/eclipse/hono-adapter-amqp-vertx:1.0.3-CUSTOM\u0026quot; mqtt: imageName: \u0026quot;my.registry.io/eclipse/hono-adapter-mqtt-vertx:1.0.3-CUSTOM\u0026quot; http: imageName: \u0026quot;my.registry.io/eclipse/hono-adapter-http-vertx:1.0.3-CUSTOM\u0026quot;  Assuming that the YAML file is called imageNames.yaml, installation can then be done using:\nhelm install --dependency-update -n hono -f imageNames.yaml eclipse-hono eclipse-iot/hono  Deploying to Minikube When using Minikube as the deployment target, things are a little easier. Minikube comes with an embedded Docker daemon which can be used to build the container images instead of using a local Docker daemon, thus eliminating the need to push the images to a registry altogether. In order to use Minikube\u0026rsquo;s Docker daemon, the following command needs to be run:\neval $(minikube docker-env)  This will set the Docker environment variables to point to Minikube\u0026rsquo;s Docker daemon which can then be used for building the container images and storing them locally in the Minikube VM.\nIn any case the build process can be started using the following command:\n# in base directory of Hono working tree: mvn clean install -Pbuild-docker-image,metrics-prometheus  The newly built images can then be deployed using Helm:\nhelm install --dependency-update -n hono eclipse-hono eclipse-iot/hono  Using Jaeger Tracing Hono\u0026rsquo;s components are instrumented using OpenTracing to allow tracking of the distributed processing of messages flowing through the system. The Hono chart can be configured to report tracing information to the Jaeger tracing system. The Spans reported by the components can then be viewed in a web browser.\nIn order for Hono\u0026rsquo;s components to use the Jaeger client for reporting tracing information, the container images need to be built with the jaeger Maven profile. Please refer to Monitoring \u0026amp; Tracing for details. The newly built images also need to be made available to the target Kubernetes cluster as described in the two previous sections.\nThe chart can be configured to deploy and use an example Jaeger back end by means of setting the jaegerBackendExample.enabled property to true when running Helm:\nhelm install --dependency-update -n hono --set jaegerBackendExample.enabled=true eclipse-hono eclipse-iot/hono  This will create a Jaeger back end instance suitable for testing purposes and will configure all deployed Hono components to use the Jaeger back end.\nThe following command can then be used to return the IP address with which the Jaeger UI can be accessed in a browser (ensure minikube tunnel is running when using minikube):\nkubectl get service eclipse-hono-jaeger-query --output=\u0026quot;jsonpath={.status.loadBalancer.ingress[0]['hostname','ip']}\u0026quot; -n hono  If no example Jaeger back end should be deployed but instead an existing Jaeger installation should be used, the chart\u0026rsquo;s jaegerAgentConf property can be set to environment variables which are passed in to the Jaeger Agent that is deployed with each of Hono\u0026rsquo;s components.\nhelm install --dependency-update -n hono --set jaegerAgentConf.REPORTER_TYPE=tchannel --set jaegerAgentConf.REPORTER_TCHANNEL_HOST_PORT=my-jaeger-collector:14267 eclipse-hono eclipse-iot/hono  Deploying to Azure Kubernetes Service (AKS) The following chapter describes how to use Azure Kubernetes Service (AKS) as a deployment target that has been set up as described in the Setting up a Kubernetes Cluster guide.\nFirst we build the docker images and push them into the ACR. Note that if you define a custom image tag you have to provide the helm with the image tags as described in the chapters above.\n# Resource group where the ACR is deployed. acr_resourcegroupname={YOUR_ACR_RG} # Name of your ACR. acr_registry_name={YOUR_ACR_NAME} # Full name of the ACR. acr_login_server=$acr_registry_name.azurecr.io # Authenticate your docker daemon with the ACR. az acr login --name $ACR_NAME # Build images. cd hono mvn install -Pbuild-docker-image -Ddocker.registry=$acr_login_server # Push images to ACR. ./push_hono_images.sh 1.0.0-SNAPSHOT $acr_login_server  Now we can retrieve settings from the deployment for the following steps:\n# Resource group of the AKS deployment resourcegroup_name=hono aks_cluster_name=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.aksClusterName.value -o tsv` http_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.httpPublicIPAddress.value -o tsv` amqp_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.amqpPublicIPAddress.value -o tsv` mqtt_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.mqttPublicIPAddress.value -o tsv` registry_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.registryPublicIPAddress.value -o tsv` network_ip_address=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.networkPublicIPAddress.value -o tsv`  Note: add the following lines in case you opted for the Azure Service Bus variant:\nservice_bus_namespace=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.serviceBusNamespaceName.value -o tsv` service_bus_key_name=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.serviceBusKeyName.value -o tsv` service_bus_key=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.serviceBusKey.value -o tsv`  Next we prepare the k8s environment:\nk8s_namespace=honons kubectl create namespace $k8s_namespace  Finally install Hono. Leveraging the managed-premium-retain storage in combination with deviceRegistry.resetFiles=false parameter is optional but ensures that Device registry storage will retain future update deployments.\n# in Hono working tree directory: hono/deploy helm install target/deploy/helm/eclipse-hono/ \\ --dep-up \\ --name hono \\ --namespace $k8s_namespace \\ --set adapters.mqtt.svc.annotations.\u0026quot;service\\.beta\\.kubernetes\\.io/azure-load-balancer-resource-group\u0026quot;=$resourcegroup_name \\ --set adapters.http.svc.annotations.\u0026quot;service\\.beta\\.kubernetes\\.io/azure-load-balancer-resource-group\u0026quot;=$resourcegroup_name \\ --set adapters.amqp.svc.annotations.\u0026quot;service\\.beta\\.kubernetes\\.io/azure-load-balancer-resource-group\u0026quot;=$resourcegroup_name \\ --set deviceRegistryExample.svc.annotations.\u0026quot;service\\.beta\\.kubernetes\\.io/azure-load-balancer-resource-group\u0026quot;=$resourcegroup_name \\ --set amqpMessagingNetworkExample.dispatchRouter.svc.annotations.\u0026quot;service\\.beta\\.kubernetes\\.io/azure-load-balancer-resource-group\u0026quot;=$resourcegroup_name \\ --set deviceRegistryExample.storageClass=managed-premium-retain \\ --set deviceRegistryExample.resetFiles=false \\ --set adapters.mqtt.svc.loadBalancerIP=$mqtt_ip_address \\ --set adapters.http.svc.loadBalancerIP=$http_ip_address \\ --set adapters.amqp.svc.loadBalancerIP=$amqp_ip_address \\ --set deviceRegistryExample.svc.loadBalancerIP=$registry_ip_address \\ --set amqpMessagingNetworkExample.dispatchRouter.svc.loadBalancerIP=$network_ip_address  Note: add the following lines in case you opted for the Azure Service Bus variant:\n# Router update required to work together with Azure Service Bus --set amqpMessagingNetworkExample.dispatchRouter.imageName=quay.io/enmasse/qdrouterd-base:1.8.0 \\ --set amqpMessagingNetworkExample.broker.type=servicebus \\ --set amqpMessagingNetworkExample.broker.servicebus.saslUsername=$service_bus_key_name \\ --set amqpMessagingNetworkExample.broker.servicebus.saslPassword=$service_bus_key \\ --set amqpMessagingNetworkExample.broker.servicebus.host=$service_bus_namespace.servicebus.windows.net \\  Have fun with Hono on Microsoft Azure!\nNext steps:\nYou can follow the steps as described in the Getting Started guide with the following differences:\nCompared to a plain k8s deployment Azure provides us DNS names with static IPs for the Hono endpoints. To retrieve them:\nHTTP_ADAPTER_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.httpPublicIPFQDN.value -o tsv` AMQP_ADAPTER_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.amqpPublicIPFQDN.value -o tsv` MQTT_ADAPTER_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.mqttPublicIPFQDN.value -o tsv` REGISTRY_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.registryPublicIPFQDN.value -o tsv` AMQP_NETWORK_IP=`az group deployment show --name HonoBasicInfrastructure --resource-group $resourcegroup_name --query properties.outputs.networkPublicIPFQDN.value -o tsv`  As Azure Service Bus does not support auto creation of queues you have to create a queue per tenant (ID), e.g. after you have created your tenant run:\naz servicebus queue create --resource-group $resourcegroup_name \\ --namespace-name $service_bus_namespace \\ --name $MY_TENANT "
 },
 {
 	"uri": "https://www.eclipse.org/hono/docs/deployment/openshift/",
diff --git a/docs/index.xml b/docs/index.xml
index f24885c..03cc733 100644
--- a/docs/index.xml
+++ b/docs/index.xml
@@ -86,11 +86,20 @@
     </item>
     
     <item>
-      <title>Device Registry</title>
-      <link>https://www.eclipse.org/hono/docs/user-guide/device-registry/</link>
+      <title>MongoDB Based Device Registry</title>
+      <link>https://www.eclipse.org/hono/docs/user-guide/mongodb-based-device-registry/</link>
       <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
       
-      <guid>https://www.eclipse.org/hono/docs/user-guide/device-registry/</guid>
+      <guid>https://www.eclipse.org/hono/docs/user-guide/mongodb-based-device-registry/</guid>
+      <description>The MongoDB based Device Registry component provides implementations of Hono&amp;rsquo;s Tenant API, Device Registration API and Credentials API. As such it exposes AMQP 1.0 based endpoints for retrieving the relevant information. Protocol adapters use these APIs to determine a device&amp;rsquo;s registration status, e.g. if it is enabled and if it is registered with a particular tenant, and to authenticate a device before accepting any data for processing from it.</description>
+    </item>
+    
+    <item>
+      <title>File Based Device Registry</title>
+      <link>https://www.eclipse.org/hono/docs/user-guide/file-based-device-registry/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/user-guide/file-based-device-registry/</guid>
       <description>&lt;p&gt;The Device Registry component provides exemplary implementations of Hono&amp;rsquo;s &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/tenant/&#34;&gt;Tenant API&lt;/a&gt;, &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/device-registration/&#34;&gt;Device Registration API&lt;/a&gt; and &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/credentials/&#34;&gt;Credentials API&lt;/a&gt;.&lt;/p&gt;</description>
     </item>
     
@@ -178,13 +187,21 @@
     </item>
     
     <item>
-      <title>Device Registry Configuration</title>
-      <link>https://www.eclipse.org/hono/docs/admin-guide/device-registry-config/</link>
+      <title>MongoDB Based Device Registry Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/admin-guide/mongodb-device-registry-config/</link>
       <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
       
-      <guid>https://www.eclipse.org/hono/docs/admin-guide/device-registry-config/</guid>
-      <description>&lt;p&gt;The Device Registry component provides an exemplary implementation of Eclipse Hono&amp;trade;&amp;rsquo;s &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/device-registration/&#34;&gt;Device Registration&lt;/a&gt;,
-&lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/credentials/&#34;&gt;Credentials&lt;/a&gt;, &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/tenant/&#34;&gt;Tenant&lt;/a&gt; and &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/device-connection/&#34;&gt;Device Connection&lt;/a&gt; APIs.&lt;/p&gt;
+      <guid>https://www.eclipse.org/hono/docs/admin-guide/mongodb-device-registry-config/</guid>
+      <description>The MongoDB based Device Registry component provides an implementation of Eclipse Hono&amp;trade;&amp;rsquo;s Device Registration, Credentials and Tenant APIs. Protocol adapters use these APIs to determine a device&amp;rsquo;s registration status, e.g. if it is enabled and if it is registered with a particular tenant, and to authenticate a device before accepting any data for processing from it. In addition to the above, this Device Registry also provides an implementation of Device Registry Management APIs for managing tenants, registration information and credentials of devices.</description>
+    </item>
+    
+    <item>
+      <title>File Based Device Registry Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/admin-guide/file-based-device-registry-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/admin-guide/file-based-device-registry-config/</guid>
+      <description>&lt;p&gt;The File based Device Registry component provides an exemplary implementation of Eclipse Hono&amp;trade;&amp;rsquo;s &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/device-registration/&#34;&gt;Device Registration&lt;/a&gt;, &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/credentials/&#34;&gt;Credentials&lt;/a&gt;, &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/tenant/&#34;&gt;Tenant&lt;/a&gt; and &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/device-connection/&#34;&gt;Device Connection&lt;/a&gt; APIs.&lt;/p&gt;
 
 &lt;p&gt;Protocol adapters use these APIs to determine a device&amp;rsquo;s registration status, e.g. if it is enabled and if it is registered with a particular tenant, and to authenticate a device before accepting any data for processing from it.&lt;/p&gt;</description>
     </item>
@@ -206,16 +223,7 @@
       <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
       
       <guid>https://www.eclipse.org/hono/docs/admin-guide/http-adapter-config/</guid>
-      <description>&lt;p&gt;The HTTP protocol adapter exposes a HTTP based API for Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry and Event endpoints.&lt;/p&gt;</description>
-    </item>
-    
-    <item>
-      <title>AMQP Adapter Configuration</title>
-      <link>https://www.eclipse.org/hono/docs/admin-guide/amqp-adapter-config/</link>
-      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
-      
-      <guid>https://www.eclipse.org/hono/docs/admin-guide/amqp-adapter-config/</guid>
-      <description>&lt;p&gt;The AMQP protocol adapter allows clients (devices and gateway components) that speaks AMQP 1.0 to publish telemetry messages and events to Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry and Event endpoints.&lt;/p&gt;</description>
+      <description>&lt;p&gt;The HTTP protocol adapter exposes HTTP based endpoints for Eclipse Hono&amp;trade;&amp;rsquo;s south bound Telemetry, Event and Command &amp;amp; Control APIs.&lt;/p&gt;</description>
     </item>
     
     <item>
@@ -224,7 +232,25 @@
       <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
       
       <guid>https://www.eclipse.org/hono/docs/admin-guide/mqtt-adapter-config/</guid>
-      <description>&lt;p&gt;The MQTT protocol adapter exposes an MQTT topic hierarchy for publishing messages and events to Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry and Event endpoints.&lt;/p&gt;</description>
+      <description>&lt;p&gt;The MQTT protocol adapter exposes an MQTT topic hierarchy for Eclipse Hono&amp;trade;&amp;rsquo;s south bound Telemetry, Event and Command &amp;amp; Control APIs.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>AMQP Adapter Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/admin-guide/amqp-adapter-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/admin-guide/amqp-adapter-config/</guid>
+      <description>&lt;p&gt;The AMQP protocol adapter exposes AMQP based endpoints for Eclipse Hono&amp;trade;&amp;rsquo;s south bound Telemetry, Event and Command &amp;amp; Control APIs.&lt;/p&gt;</description>
+    </item>
+    
+    <item>
+      <title>CoAP Adapter Configuration</title>
+      <link>https://www.eclipse.org/hono/docs/admin-guide/coap-adapter-config/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/admin-guide/coap-adapter-config/</guid>
+      <description>&lt;p&gt;The CoAP protocol adapter exposes CoAP based endpoints for Eclipse Hono&amp;trade;&amp;rsquo;s south bound Telemetry, Event and Command &amp;amp; Control APIs.&lt;/p&gt;</description>
     </item>
     
     <item>
@@ -233,7 +259,8 @@
       <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
       
       <guid>https://www.eclipse.org/hono/docs/admin-guide/kura-adapter-config/</guid>
-      <description>&lt;p&gt;The Kura protocol adapter exposes an MQTT topic hierarchy allowing Eclipse Kura&amp;trade; based gateways to publish &lt;em&gt;control&lt;/em&gt; and &lt;em&gt;data&lt;/em&gt; messages to Eclipse Hono&amp;trade;&amp;rsquo;s Telemetry and Event endpoints.&lt;/p&gt;</description>
+      <description>&lt;p&gt;The Kura protocol adapter exposes an MQTT topic hierarchy allowing Eclipse Kura&amp;trade; based gateways to access Eclipse Hono&amp;trade;&amp;rsquo;s
+south bound Telemetry, Event and Command &amp;amp; Control APIs.&lt;/p&gt;</description>
     </item>
     
     <item>
diff --git a/docs/sitemap.xml b/docs/sitemap.xml
index f3281c5..1eda393 100644
--- a/docs/sitemap.xml
+++ b/docs/sitemap.xml
@@ -7,6 +7,11 @@
 	</sitemap>
 	
 	<sitemap>
+	   	<loc>https://www.eclipse.org/hono/docs/1.2/sitemap.xml</loc>
+		
+	</sitemap>
+	
+	<sitemap>
 	   	<loc>https://www.eclipse.org/hono/docs/1.1/sitemap.xml</loc>
 		
 	</sitemap>
diff --git a/docs/stable/sitemap.xml b/docs/stable/sitemap.xml
index 3d848ba..b91c2fc 100644
--- a/docs/stable/sitemap.xml
+++ b/docs/stable/sitemap.xml
@@ -6,6 +6,11 @@
     <loc>https://www.eclipse.org/hono/docs/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/"
                 />
@@ -30,6 +35,11 @@
     <loc>https://www.eclipse.org/hono/docs/concepts/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/concepts/"
                 />
@@ -54,6 +64,11 @@
     <loc>https://www.eclipse.org/hono/docs/concepts/device-identity/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/device-identity/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/concepts/device-identity/"
                 />
@@ -78,13 +93,8 @@
     <loc>https://www.eclipse.org/hono/docs/concepts/tenancy/</loc>
     <xhtml:link
                 rel="alternate"
-                hreflang="1.1"
-                href="https://www.eclipse.org/hono/docs/1.1/concepts/tenancy/"
-                />
-    <xhtml:link
-                rel="alternate"
-                hreflang="1.0"
-                href="https://www.eclipse.org/hono/docs/1.0/concepts/tenancy/"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/concepts/tenancy/"
                 />
     <xhtml:link
                 rel="alternate"
@@ -97,6 +107,11 @@
     <loc>https://www.eclipse.org/hono/docs/concepts/device-provisioning/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/device-provisioning/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/concepts/device-provisioning/"
                 />
@@ -116,6 +131,11 @@
     <loc>https://www.eclipse.org/hono/docs/concepts/connecting-devices/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/connecting-devices/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/concepts/connecting-devices/"
                 />
@@ -135,13 +155,8 @@
     <loc>https://www.eclipse.org/hono/docs/concepts/device-notifications/</loc>
     <xhtml:link
                 rel="alternate"
-                hreflang="1.1"
-                href="https://www.eclipse.org/hono/docs/1.1/concepts/device-notifications/"
-                />
-    <xhtml:link
-                rel="alternate"
-                hreflang="1.0"
-                href="https://www.eclipse.org/hono/docs/1.0/concepts/device-notifications/"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/concepts/device-notifications/"
                 />
     <xhtml:link
                 rel="alternate"
@@ -154,13 +169,8 @@
     <loc>https://www.eclipse.org/hono/docs/concepts/command-and-control/</loc>
     <xhtml:link
                 rel="alternate"
-                hreflang="1.1"
-                href="https://www.eclipse.org/hono/docs/1.1/concepts/command-and-control/"
-                />
-    <xhtml:link
-                rel="alternate"
-                hreflang="1.0"
-                href="https://www.eclipse.org/hono/docs/1.0/concepts/command-and-control/"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/concepts/command-and-control/"
                 />
     <xhtml:link
                 rel="alternate"
@@ -173,6 +183,11 @@
     <loc>https://www.eclipse.org/hono/docs/concepts/resource-limits/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/resource-limits/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/concepts/resource-limits/"
                 />
@@ -197,6 +212,11 @@
     <loc>https://www.eclipse.org/hono/docs/concepts/connection-events/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/concepts/connection-events/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/concepts/connection-events/"
                 />
@@ -221,6 +241,11 @@
     <loc>https://www.eclipse.org/hono/docs/user-guide/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/"
                 />
@@ -242,21 +267,30 @@
   </url>
   
   <url>
-    <loc>https://www.eclipse.org/hono/docs/user-guide/device-registry/</loc>
+    <loc>https://www.eclipse.org/hono/docs/user-guide/mongodb-based-device-registry/</loc>
     <xhtml:link
                 rel="alternate"
-                hreflang="1.1"
-                href="https://www.eclipse.org/hono/docs/1.1/user-guide/device-registry/"
-                />
-    <xhtml:link
-                rel="alternate"
-                hreflang="1.0"
-                href="https://www.eclipse.org/hono/docs/1.0/user-guide/device-registry/"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/user-guide/mongodb-based-device-registry/"
                 />
     <xhtml:link
                 rel="alternate"
                 hreflang="stable"
-                href="https://www.eclipse.org/hono/docs/user-guide/device-registry/"
+                href="https://www.eclipse.org/hono/docs/user-guide/mongodb-based-device-registry/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/user-guide/file-based-device-registry/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/user-guide/file-based-device-registry/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/user-guide/file-based-device-registry/"
                 />
   </url>
   
@@ -264,6 +298,11 @@
     <loc>https://www.eclipse.org/hono/docs/user-guide/http-adapter/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/http-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/http-adapter/"
                 />
@@ -288,6 +327,11 @@
     <loc>https://www.eclipse.org/hono/docs/user-guide/mqtt-adapter/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/mqtt-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/mqtt-adapter/"
                 />
@@ -312,6 +356,11 @@
     <loc>https://www.eclipse.org/hono/docs/user-guide/amqp-adapter/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/amqp-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/amqp-adapter/"
                 />
@@ -336,6 +385,11 @@
     <loc>https://www.eclipse.org/hono/docs/user-guide/coap-adapter/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/coap-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="dev"
                 href="https://www.eclipse.org/hono/docs/dev/user-guide/coap-adapter/"
                 />
@@ -350,6 +404,11 @@
     <loc>https://www.eclipse.org/hono/docs/user-guide/kura-adapter/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/kura-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/kura-adapter/"
                 />
@@ -374,6 +433,11 @@
     <loc>https://www.eclipse.org/hono/docs/user-guide/sigfox-adapter/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/sigfox-adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/sigfox-adapter/"
                 />
@@ -398,6 +462,11 @@
     <loc>https://www.eclipse.org/hono/docs/user-guide/jmeter_load_tests/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/user-guide/jmeter_load_tests/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/user-guide/jmeter_load_tests/"
                 />
@@ -422,6 +491,11 @@
     <loc>https://www.eclipse.org/hono/docs/admin-guide/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/"
                 />
@@ -446,6 +520,11 @@
     <loc>https://www.eclipse.org/hono/docs/admin-guide/common-config/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/common-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/common-config/"
                 />
@@ -470,6 +549,11 @@
     <loc>https://www.eclipse.org/hono/docs/admin-guide/auth-server-config/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/auth-server-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/auth-server-config/"
                 />
@@ -491,21 +575,30 @@
   </url>
   
   <url>
-    <loc>https://www.eclipse.org/hono/docs/admin-guide/device-registry-config/</loc>
+    <loc>https://www.eclipse.org/hono/docs/admin-guide/mongodb-device-registry-config/</loc>
     <xhtml:link
                 rel="alternate"
-                hreflang="1.1"
-                href="https://www.eclipse.org/hono/docs/1.1/admin-guide/device-registry-config/"
-                />
-    <xhtml:link
-                rel="alternate"
-                hreflang="1.0"
-                href="https://www.eclipse.org/hono/docs/1.0/admin-guide/device-registry-config/"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/admin-guide/mongodb-device-registry-config/"
                 />
     <xhtml:link
                 rel="alternate"
                 hreflang="stable"
-                href="https://www.eclipse.org/hono/docs/admin-guide/device-registry-config/"
+                href="https://www.eclipse.org/hono/docs/admin-guide/mongodb-device-registry-config/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/admin-guide/file-based-device-registry-config/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/admin-guide/file-based-device-registry-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/admin-guide/file-based-device-registry-config/"
                 />
   </url>
   
@@ -513,6 +606,11 @@
     <loc>https://www.eclipse.org/hono/docs/admin-guide/device-connection-config/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/device-connection-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/device-connection-config/"
                 />
@@ -537,6 +635,11 @@
     <loc>https://www.eclipse.org/hono/docs/admin-guide/http-adapter-config/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/http-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/http-adapter-config/"
                 />
@@ -558,33 +661,14 @@
   </url>
   
   <url>
-    <loc>https://www.eclipse.org/hono/docs/admin-guide/amqp-adapter-config/</loc>
-    <xhtml:link
-                rel="alternate"
-                hreflang="1.1"
-                href="https://www.eclipse.org/hono/docs/1.1/admin-guide/amqp-adapter-config/"
-                />
-    <xhtml:link
-                rel="alternate"
-                hreflang="1.0"
-                href="https://www.eclipse.org/hono/docs/1.0/admin-guide/amqp-adapter-config/"
-                />
-    <xhtml:link
-                rel="alternate"
-                hreflang="dev"
-                href="https://www.eclipse.org/hono/docs/dev/admin-guide/amqp-adapter-config/"
-                />
-    <xhtml:link
-                rel="alternate"
-                hreflang="stable"
-                href="https://www.eclipse.org/hono/docs/admin-guide/amqp-adapter-config/"
-                />
-  </url>
-  
-  <url>
     <loc>https://www.eclipse.org/hono/docs/admin-guide/mqtt-adapter-config/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/mqtt-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/mqtt-adapter-config/"
                 />
@@ -606,9 +690,57 @@
   </url>
   
   <url>
+    <loc>https://www.eclipse.org/hono/docs/admin-guide/amqp-adapter-config/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.1"
+                href="https://www.eclipse.org/hono/docs/1.1/admin-guide/amqp-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="1.0"
+                href="https://www.eclipse.org/hono/docs/1.0/admin-guide/amqp-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/admin-guide/amqp-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/admin-guide/amqp-adapter-config/"
+                />
+  </url>
+  
+  <url>
+    <loc>https://www.eclipse.org/hono/docs/admin-guide/coap-adapter-config/</loc>
+    <xhtml:link
+                rel="alternate"
+                hreflang="dev"
+                href="https://www.eclipse.org/hono/docs/dev/admin-guide/coap-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
+                hreflang="stable"
+                href="https://www.eclipse.org/hono/docs/admin-guide/coap-adapter-config/"
+                />
+  </url>
+  
+  <url>
     <loc>https://www.eclipse.org/hono/docs/admin-guide/kura-adapter-config/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/kura-adapter-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/kura-adapter-config/"
                 />
@@ -633,6 +765,11 @@
     <loc>https://www.eclipse.org/hono/docs/admin-guide/hono-client-configuration/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/hono-client-configuration/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/hono-client-configuration/"
                 />
@@ -657,6 +794,11 @@
     <loc>https://www.eclipse.org/hono/docs/admin-guide/amqp-network-config/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/amqp-network-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/amqp-network-config/"
                 />
@@ -681,6 +823,11 @@
     <loc>https://www.eclipse.org/hono/docs/admin-guide/secure_communication/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/secure_communication/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/secure_communication/"
                 />
@@ -705,6 +852,11 @@
     <loc>https://www.eclipse.org/hono/docs/admin-guide/monitoring-tracing-config/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/admin-guide/monitoring-tracing-config/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/admin-guide/monitoring-tracing-config/"
                 />
@@ -729,6 +881,11 @@
     <loc>https://www.eclipse.org/hono/docs/dev-guide/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/dev-guide/"
                 />
@@ -753,6 +910,11 @@
     <loc>https://www.eclipse.org/hono/docs/dev-guide/building_hono/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/building_hono/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/dev-guide/building_hono/"
                 />
@@ -777,6 +939,11 @@
     <loc>https://www.eclipse.org/hono/docs/dev-guide/amqp_adapter_client/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/amqp_adapter_client/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="dev"
                 href="https://www.eclipse.org/hono/docs/dev/dev-guide/amqp_adapter_client/"
                 />
@@ -791,6 +958,11 @@
     <loc>https://www.eclipse.org/hono/docs/dev-guide/java_client_consumer/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/java_client_consumer/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/dev-guide/java_client_consumer/"
                 />
@@ -815,6 +987,11 @@
     <loc>https://www.eclipse.org/hono/docs/dev-guide/custom_http_adapter/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/dev-guide/custom_http_adapter/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/dev-guide/custom_http_adapter/"
                 />
@@ -839,6 +1016,11 @@
     <loc>https://www.eclipse.org/hono/docs/api/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/"
                 />
@@ -863,6 +1045,11 @@
     <loc>https://www.eclipse.org/hono/docs/api/telemetry/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/telemetry/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/telemetry/"
                 />
@@ -887,6 +1074,11 @@
     <loc>https://www.eclipse.org/hono/docs/api/event/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/event/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/event/"
                 />
@@ -911,6 +1103,11 @@
     <loc>https://www.eclipse.org/hono/docs/api/command-and-control/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/command-and-control/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/command-and-control/"
                 />
@@ -935,6 +1132,11 @@
     <loc>https://www.eclipse.org/hono/docs/api/tenant/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/tenant/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/tenant/"
                 />
@@ -959,6 +1161,11 @@
     <loc>https://www.eclipse.org/hono/docs/api/device-connection/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/device-connection/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/device-connection/"
                 />
@@ -983,6 +1190,11 @@
     <loc>https://www.eclipse.org/hono/docs/api/device-registration/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/device-registration/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/device-registration/"
                 />
@@ -1007,6 +1219,11 @@
     <loc>https://www.eclipse.org/hono/docs/api/credentials/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/credentials/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/credentials/"
                 />
@@ -1031,6 +1248,11 @@
     <loc>https://www.eclipse.org/hono/docs/api/authentication/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/authentication/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/authentication/"
                 />
@@ -1055,6 +1277,11 @@
     <loc>https://www.eclipse.org/hono/docs/api/management/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/management/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/management/"
                 />
@@ -1079,6 +1306,11 @@
     <loc>https://www.eclipse.org/hono/docs/api/metrics/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/api/metrics/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/api/metrics/"
                 />
@@ -1103,6 +1335,11 @@
     <loc>https://www.eclipse.org/hono/docs/deployment/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/deployment/"
                 />
@@ -1127,6 +1364,11 @@
     <loc>https://www.eclipse.org/hono/docs/deployment/helm-based-deployment/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/helm-based-deployment/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/deployment/helm-based-deployment/"
                 />
@@ -1151,6 +1393,11 @@
     <loc>https://www.eclipse.org/hono/docs/deployment/openshift/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/openshift/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/deployment/openshift/"
                 />
@@ -1175,6 +1422,11 @@
     <loc>https://www.eclipse.org/hono/docs/deployment/create-kubernetes-cluster/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/create-kubernetes-cluster/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/deployment/create-kubernetes-cluster/"
                 />
@@ -1199,6 +1451,11 @@
     <loc>https://www.eclipse.org/hono/docs/deployment/resource-limitation/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/deployment/resource-limitation/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/deployment/resource-limitation/"
                 />
@@ -1223,6 +1480,11 @@
     <loc>https://www.eclipse.org/hono/docs/architecture/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/architecture/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/architecture/"
                 />
@@ -1247,6 +1509,11 @@
     <loc>https://www.eclipse.org/hono/docs/architecture/component-view/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/architecture/component-view/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/architecture/component-view/"
                 />
@@ -1271,6 +1538,11 @@
     <loc>https://www.eclipse.org/hono/docs/architecture/auth/</loc>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/architecture/auth/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/architecture/auth/"
                 />
@@ -1296,6 +1568,11 @@
     <priority>0</priority>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/categories/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/categories/"
                 />
@@ -1321,6 +1598,11 @@
     <priority>0</priority>
     <xhtml:link
                 rel="alternate"
+                hreflang="1.2"
+                href="https://www.eclipse.org/hono/docs/1.2/tags/"
+                />
+    <xhtml:link
+                rel="alternate"
                 hreflang="1.1"
                 href="https://www.eclipse.org/hono/docs/1.1/tags/"
                 />
diff --git a/docs/tags/index.html b/docs/tags/index.html
index bf7034f..9981e1e 100644
--- a/docs/tags/index.html
+++ b/docs/tags/index.html
@@ -21,19 +21,19 @@
     <title>Tags :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/tags/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/tags/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/tags/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/tags/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/tags/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/tags/">dev</option>
@@ -1756,6 +1839,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -1964,6 +2063,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2366,20 +2497,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/user-guide/amqp-adapter/index.html b/docs/user-guide/amqp-adapter/index.html
index fa03eb2..93828d8 100644
--- a/docs/user-guide/amqp-adapter/index.html
+++ b/docs/user-guide/amqp-adapter/index.html
@@ -21,19 +21,19 @@
     <title>AMQP Adapter :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/amqp-adapter/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/amqp-adapter/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/amqp-adapter/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/amqp-adapter/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/amqp-adapter/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/amqp-adapter/">dev</option>
@@ -1456,7 +1539,7 @@
 <li><a href="#connection-duration-limits">Connection Duration Limits</a></li>
 <li><a href="#message-limits">Message Limits</a></li>
 </ul></li>
-<li><a href="#connection-event">Connection Event</a></li>
+<li><a href="#connection-events">Connection Events</a></li>
 <li><a href="#link-establishment">Link Establishment</a></li>
 <li><a href="#error-handling">Error Handling</a></li>
 <li><a href="#amqp-command-line-client">AMQP Command-line Client</a></li>
@@ -1503,62 +1586,82 @@
 
 <h2 id="device-authentication">Device Authentication</h2>
 
-<p>By default, all Hono protocol adapters require clients (devices or gateway components) to authenticate during connection establishment. This is the preferred way for devices to publish data via protocol adapters. The AMQP adapter supports both the <a href="https://tools.ietf.org/html/rfc4616">SASL PLAIN</a> and <a href="https://tools.ietf.org/html/rfc4422">SASL EXTERNAL</a> authentication mechanisms. The former uses a <em>username</em> and <em>password</em> to authenticate to the adapter while the latter uses a client certificate.</p>
+<p>By default, all Hono protocol adapters require clients (devices or gateway components) to authenticate during connection establishment.
+This is the preferred way for devices to publish data via protocol adapters. The AMQP adapter supports both the
+<a href="https://tools.ietf.org/html/rfc4616">SASL PLAIN</a> and <a href="https://tools.ietf.org/html/rfc4422">SASL EXTERNAL</a> authentication mechanisms.
+The former uses a <em>username</em> and <em>password</em> to authenticate to the adapter while the latter uses an X.509 client certificate.</p>
 
-<p>In this guide, we will give examples for publishing telemetry data and events for <em>authenticated</em> (using SASL PLAIN) and <em>unauthenticated</em> clients.</p>
+<p>This guide provides examples for publishing telemetry and events for <em>authenticated</em> (using SASL PLAIN) and <em>unauthenticated</em> clients.</p>
 
-<p><strong>NB</strong> The AMQP adapter can be configured to <em>allow</em> unauthenticated devices to connect by setting configuration variable <code>HONO_AMQP_AUTHENTICATION_REQUIRED</code> to <code>false</code>.</p>
+<p><strong>NB</strong> The AMQP adapter can be configured to <em>allow</em> unauthenticated devices to connect by setting configuration variable
+<code>HONO_AMQP_AUTHENTICATION_REQUIRED</code> to <code>false</code>.</p>
 
 <h3 id="sasl-plain-authentication">SASL PLAIN Authentication</h3>
 
-<p>The AMQP adapter supports authenticating clients using a <em>username</em> and <em>password</em>. This means that clients need to provide a <em>username</em> and a <em>password</em> when connecting to the AMQP adapter. If the adapter is configured for multi-tenancy (i.e <code>HONO_AMQP_SINGLE_TENANT</code> is set to <code>false</code>), then the <em>username</em> must match the pattern [<em>auth-id@tenant</em>], e.g. <code>sensor1@DEFAULT_TENANT</code>. Otherwise the <code>DEFAULT_TENANT</code> is assumed and the tenant-id can be omitted from the username.</p>
+<p>The AMQP adapter supports authenticating clients using a <em>username</em> and <em>password</em>. This means that clients need to provide a <em>username</em> and a <em>password</em>
+when connecting to the AMQP adapter. If the adapter is configured for multi-tenancy (i.e <code>HONO_AMQP_SINGLE_TENANT</code> is set to <code>false</code>),
+then the <em>username</em> must match the pattern [<em>auth-id@tenant</em>], e.g. <code>sensor1@DEFAULT_TENANT</code>. Otherwise, the tenant-id can be omitted from the username
+and the client is assumed to belong to the <code>DEFAULT_TENANT</code>.</p>
 
-<p>The adapter verifies the credentials provided by the client against the credentials the <a href="/hono/docs/admin-guide/common-config/#credentials-service-connection-configuration">configured Credentials service</a> has on record for the client. If the credentials match, then authentication is successful and the client device can proceed to publish messages to Hono.</p>
+<p>The adapter verifies the credentials provided by the client against the credentials that the
+<a href="/hono/docs/admin-guide/common-config/#credentials-service-connection-configuration">configured Credentials service</a> has on record for the client.
+If the credentials match, the client device can proceed to publish messages to Hono.</p>
 
-<p>The examples below refer to devices <code>4711</code> and <code>gw-1</code> of tenant <code>DEFAULT_TENANT</code> using <em>auth-ids</em> <code>sensor1</code> and <code>gw1</code> and corresponding passwords. The example deployment as described in the <a href="/hono/docs/deployment/">Deployment Guides</a> comes pre-configured with the corresponding entities in its device registry component.</p>
+<p>The examples below refer to devices <code>4711</code> and <code>gw-1</code> of tenant <code>DEFAULT_TENANT</code> using <em>auth-ids</em> <code>sensor1</code> and <code>gw1</code> and corresponding passwords.
+The example deployment as described in the <a href="/hono/docs/deployment/">Deployment Guide</a> comes pre-configured with the corresponding entities in its
+device registry component.</p>
 
-<p><strong>NB</strong> There is a subtle difference between the <em>device identifier</em> (<em>device-id</em>) and the <em>auth-id</em> a device uses for authentication. See <a href="/hono/docs/concepts/device-identity/">Device Identity</a> for a discussion of the concepts.</p>
+<p><strong>NB</strong> There is a subtle difference between the <em>device identifier</em> (<em>device-id</em>) and the <em>auth-id</em> a device uses for authentication.
+See <a href="/hono/docs/concepts/device-identity/">Device Identity</a> for a discussion of the concepts.</p>
 
 <h3 id="sasl-external-authentication">SASL EXTERNAL Authentication</h3>
 
-<p>When a device uses a client certificate for authentication, the TLS handshake is initiated during TCP connection establishment. If no trust anchor is configured for the AMQP adapter, the TLS handshake will succeed only if the certificate has not yet expired. Once the TLS handshake completes and a secure connection is established, the certificate&rsquo;s signature is checked during the SASL handshake. To complete the SASL handshake and authenticate the client, the adapter performs the following steps:</p>
+<p>When a device uses a client certificate for authentication, the TLS handshake is initiated during TCP connection establishment.
+If no trust anchor is configured for the AMQP adapter, the TLS handshake will succeed only if the certificate has not yet expired.
+Once the TLS handshake completes and a secure connection is established, the certificate&rsquo;s signature is checked during the SASL handshake.
+To complete the SASL handshake and authenticate the client, the adapter performs the following steps:</p>
 
-<ul>
-<li>Adapter extracts the client certificate&rsquo;s <em>Issuer DN</em> and uses it to</li>
-<li>us the Tenant service to look up the tenant that the client belongs to. In order for the lookup to succeed, the tenant’s trust anchor needs to be configured by means of registering the <a href="/hono/docs/api/tenant/#trusted-ca-format">trusted certificate authority</a>.</li>
-<li>If the lookup succeeds, the Tenant service returns the tenant, thus implicitly establishing the tenant that the device belongs to.</li>
-<li>Adapter validates the device’s client certificate using the registered trust anchor for the tenant.</li>
-<li>Finally, adapter authenticates the client certificate using Hono&rsquo;s credentials API. In this step, the adapter uses the client certificate’s <em>Subject DN</em> (as authentication identifier) and <code>x509-cert</code> (for the credentials type) in order to determine the device ID.</li>
-</ul>
+<ol>
+<li>The adapter extracts the client certificate&rsquo;s <em>Issuer DN</em> from the client certificate</li>
+<li>The adapter invokes the Tenant service to look up the tenant matching the DN.
+In order for the lookup to succeed, the tenant’s trust anchor needs to be configured by means of registering the
+<a href="/hono/docs/api/tenant/#trusted-ca-format">trusted certificate authority</a>.</li>
+<li>If the lookup succeeds, the tenant returned by the Tenant service is the tenant that the device belongs to.</li>
+<li>The adapter verifies the device’s client certificate&rsquo;s signature using the trust anchor registered for the tenant.</li>
+<li>Finally, the adapter authenticates the client certificate using Hono&rsquo;s credentials API. In this step, the adapter
+uses the client certificate’s <em>Subject DN</em> (as authentication identifier) and <code>x509-cert</code> (for the credentials type)
+in order to determine the device ID.</li>
+</ol>
 
 <p><strong>NB</strong> The AMQP adapter needs to be configured for TLS in order to support this mechanism.</p>
 
 <h2 id="resource-limit-checks">Resource Limit Checks</h2>
 
-<p>The adapter performs additional checks regarding <a href="/hono/docs/concepts/resource-limits/">resource limits</a> when a client tries to connect and/or
-send a message to the adapter.</p>
+<p>The adapter performs additional checks regarding resource limits when a client tries to connect and/or send a message to the adapter.</p>
 
 <h3 id="connection-limits">Connection Limits</h3>
 
-<p>The adapter fails the SASL handshake with a client</p>
+<p>The adapter immediately closes a newly established connection with an <code>amqp:unauthorized-access</code> error if</p>
 
 <ul>
-<li>if the maximum number of simultaneously connected devices for the client&rsquo;s tenant is reached, or</li>
-<li>if the maximum number of connections per protocol adapter instance is reached.</li>
+<li>the maximum number of connections per protocol adapter instance is reached, or</li>
+<li>if the maximum number of simultaneously connected devices for the client&rsquo;s tenant is reached.</li>
 </ul>
 
+<p>Please refer to <a href="/hono/docs/concepts/resource-limits/">resource-limits</a> for details.</p>
+
 <h3 id="connection-duration-limits">Connection Duration Limits</h3>
 
-<p>The adapter fails the SASL handshake with a client if the
-<a href="/hono/docs/concepts/resource-limits/#connection-duration-limit">connection duration limit</a> that has been configured
-for the client’s tenant is exceeded.</p>
+<p>The adapter immediately closes a newly established connection with an <code>amqp:unauthorized-access</code> error if the
+<a href="/hono/docs/concepts/resource-limits/#connection-duration-limit">connection duration limit</a> that has been configured for
+the client&rsquo;s tenant is exceeded.</p>
 
 <h3 id="message-limits">Message Limits</h3>
 
 <p>The adapter</p>
 
 <ul>
-<li>fails the SASL handshake with a client and</li>
+<li>immediately closes a newly established connection with an <code>amqp:unauthorized-access</code> error and</li>
 <li>rejects any AMQP 1.0 message containing
 
 <ul>
@@ -1567,11 +1670,15 @@
 </ul></li>
 </ul>
 
-<p>if the <a href="/hono/docs/concepts/resource-limits/">message limit</a> that has been configured for the device’s tenant is exceeded.</p>
+<p>if the <a href="/hono/docs/concepts/resource-limits/">message limit</a> that has been configured for the device&rsquo;s tenant is exceeded.</p>
 
-<h2 id="connection-event">Connection Event</h2>
+<h2 id="connection-events">Connection Events</h2>
 
-<p>The AMQP Adapter can send a <a href="/hono/docs/api/event/#connection-event">Connection Event</a> once the connection with a device has been successfully established or ended. Note that this requires the <a href="/hono/docs/admin-guide/mqtt-adapter-config/#service-configuration"><code>HONO_CONNECTION_EVENTS_PRODUCER</code></a> configuration property to be explicitly set to <code>events</code>.</p>
+<p>The adapter can emit <a href="/hono/docs/api/event/#connection-event">Connection Events</a> for client connections being established and/or terminated.
+Please refer to the <a href="/hono/docs/admin-guide/common-config/#connection-event-producer-configuration">common configuration options</a>
+for details regarding how to enable this behavior.</p>
+
+<p>The adapter includes the client&rsquo;s AMQP <em>container-id</em> as the Connection Event&rsquo;s <em>remote-id</em>.</p>
 
 <h2 id="link-establishment">Link Establishment</h2>
 
@@ -1934,7 +2041,7 @@
 </tbody>
 </table>
 
-<p>Authenticated gateways will receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway. Corresponding devices have to be configured so that they can be used with a gateway. See <a href="/hono/docs/admin-guide/device-registry-config/#configuring-gateway-devices">Configuring Gateway Devices</a> for details.</p>
+<p>Authenticated gateways will receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway. Corresponding devices have to be configured so that they can be used with a gateway. See <a href="/hono/docs/admin-guide/file-based-device-registry-config/#configuring-gateway-devices">Configuring Gateway Devices</a> for details.</p>
 
 <p>A gateway can open a link to receive commands for <em>all</em> devices it acts on behalf of. An authenticated gateway can also open a receiver link for commands targeted at a <em>specific</em> device.</p>
 
@@ -2357,6 +2464,22 @@
             
                 
                     
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
                     
                 
                 
@@ -2644,6 +2767,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -3046,20 +3201,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/user-guide/coap-adapter/index.html b/docs/user-guide/coap-adapter/index.html
index 54e9ee0..d19d4f5 100644
--- a/docs/user-guide/coap-adapter/index.html
+++ b/docs/user-guide/coap-adapter/index.html
@@ -21,19 +21,19 @@
     <title>CoAP Adapter :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/coap-adapter/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/coap-adapter/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/coap-adapter/">1.2</option>
                     
                   
               
@@ -1297,6 +1374,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/coap-adapter/">dev</option>
@@ -1491,8 +1570,14 @@
 
 <h2 id="message-limits">Message Limits</h2>
 
-<p>Before accepting any telemetry or event or command messages, the CoAP adapter verifies that the configured <a href="/hono/docs/concepts/resource-limits/#messages-limit">message limit</a> is not exceeded.
-For CoAP currently only the messages limit is verified, the connections limit is not available. If the limit is exceeded then the incoming message is discarded with the status code <code>429 Too Many Requests</code>.</p>
+<p>The adapter rejects</p>
+
+<ul>
+<li>a client&rsquo;s request to upload data with status code <code>429 Too Many Requests</code> and</li>
+<li>any AMQP 1.0 message containing a command sent by a north bound application</li>
+</ul>
+
+<p>if the <a href="/hono/docs/concepts/resource-limits/">message limit</a> that has been configured for the device&rsquo;s tenant is exceeded.</p>
 
 <h2 id="coap-content-format-codes">CoAP Content Format Codes</h2>
 
@@ -2130,7 +2215,7 @@
 
 <h3 id="commands-handled-by-gateways">Commands handled by gateways</h3>
 
-<p>Authenticated gateways will receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway. Corresponding devices have to be configured so that they can be used with a gateway. See <a href="/hono/docs/admin-guide/device-registry-config/#configuring-gateway-devices">Configuring Gateway Devices</a> for details.</p>
+<p>Authenticated gateways will receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway. Corresponding devices have to be configured so that they can be used with a gateway. See <a href="/hono/docs/admin-guide/file-based-device-registry-config/#configuring-gateway-devices">Configuring Gateway Devices</a> for details.</p>
 
 <p>A gateway can send a request with the <code>hono-ttd</code> query parameter on the <code>/event</code> or <code>/telemetry</code> URI, indicating its readiness to receive a command for <em>any</em> device it acts on behalf of. Note that in this case, the business application will be notified with the gateway id in the <code>device_id</code> property of the downstream message.</p>
 
@@ -2683,6 +2768,22 @@
             
                 
                     
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
                     
                 
                 
@@ -2954,6 +3055,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -3356,20 +3489,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/user-guide/device-registry/index.html b/docs/user-guide/file-based-device-registry/index.html
similarity index 65%
copy from docs/user-guide/device-registry/index.html
copy to docs/user-guide/file-based-device-registry/index.html
index 5ff6a71..ba73e0a 100644
--- a/docs/user-guide/device-registry/index.html
+++ b/docs/user-guide/file-based-device-registry/index.html
@@ -18,22 +18,22 @@
 <meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
 <meta name="theme-color" content="#ffffff">
 
-    <title>Device Registry :: Eclipse Hono&trade;</title>
+    <title>File Based Device Registry :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -53,18 +53,18 @@
 
 <meta name="twitter:card" content="summary_large_image">
 <meta name="twitter:site" content="@EclipseHono">
-<meta name="twitter:title" content="Device Registry :: Eclipse Hono&amp;trade;">
+<meta name="twitter:title" content="File Based Device Registry :: Eclipse Hono&amp;trade;">
 <meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
 <meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
 
 
-<meta property="og:title" content="Device Registry :: Eclipse Hono&amp;trade;" />
+<meta property="og:title" content="File Based Device Registry :: Eclipse Hono&amp;trade;" />
 <meta property="og:type" content="website" />
-<meta property="og:url" content="https://www.eclipse.org/hono/docs/user-guide/device-registry//" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/user-guide/file-based-device-registry//" />
 <meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
 
   </head>
-  <body class="" data-url="/hono/docs/user-guide/device-registry/">
+  <body class="" data-url="/hono/docs/user-guide/file-based-device-registry/">
     <nav id="sidebar" class="">
 
 
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item active">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item active">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,7 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/device-registry/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/file-based-device-registry/" selected>stable (1.3)</option>
                     
                   
               
@@ -1287,24 +1344,14 @@
               
                   
               
+                  
+              
           
               
               
                   
               
                   
-                    
-                    
-                      <option id="1.1" value="/hono/docs/1.1/user-guide/device-registry/">1.1</option>
-                    
-                  
-              
-                  
-              
-                  
-              
-          
-              
               
                   
               
@@ -1313,12 +1360,10 @@
                   
                     
                     
-                      <option id="1.0" value="/hono/docs/1.0/user-guide/device-registry/">1.0</option>
+                      <option id="dev" value="/hono/docs/dev/user-guide/file-based-device-registry/">dev</option>
                     
                   
               
-                  
-              
           
         </select>
         <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
@@ -1381,7 +1426,7 @@
                   
                   
                   <div id="top-github-link">
-                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/user-guide/device-registry.md" target="blank">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/user-guide/file-based-device-registry.md" target="blank">
                       <i class="fas fa-code-branch"></i>
                       <span id="top-github-link-text">Edit this page</span>
                     </a>
@@ -1412,7 +1457,7 @@
             
           
           
-            <a href='/hono/docs/'>Documentation</a> > <a href='/hono/docs/user-guide/'>User Guide</a> > Device Registry
+            <a href='/hono/docs/'>Documentation</a> > <a href='/hono/docs/user-guide/'>User Guide</a> > File Based Device Registry
           
          
           
@@ -1429,25 +1474,9 @@
 <ul>
 <li>
 <ul>
-<li><a href="#managing-tenants">Managing Tenants</a>
-<ul>
-<li><a href="#add-a-tenant">Add a Tenant</a></li>
-<li><a href="#get-configuration-details-of-a-tenant">Get configuration details of a Tenant</a></li>
-<li><a href="#update-tenant">Update Tenant</a></li>
-<li><a href="#delete-tenant">Delete Tenant</a></li>
-</ul></li>
-<li><a href="#managing-device-registration-information">Managing Device Registration Information</a>
-<ul>
-<li><a href="#register-device">Register Device</a></li>
-<li><a href="#read-device">Read Device</a></li>
-<li><a href="#update-device">Update Device</a></li>
-<li><a href="#delete-device">Delete Device</a></li>
-</ul></li>
-<li><a href="#managing-credentials">Managing Credentials</a>
-<ul>
-<li><a href="#update-credentials-for-a-device">Update Credentials for a Device</a></li>
-<li><a href="#get-all-credentials-for-a-device">Get all Credentials for a Device</a></li>
-</ul></li>
+<li><a href="#managing-tenants">Managing Tenants</a></li>
+<li><a href="#managing-devices">Managing Devices</a></li>
+<li><a href="#managing-credentials">Managing Credentials</a></li>
 </ul></li>
 </ul>
 </nav>
@@ -1462,7 +1491,7 @@
         
         <div id="body-inner">
           
-            <h1>Device Registry</h1>
+            <h1>File Based Device Registry</h1>
           
 
         
@@ -1485,518 +1514,15 @@
 
 <h2 id="managing-tenants">Managing Tenants</h2>
 
-<p>The following sections describe the resources representing the operations of the Tenant API and how they can be used to manage tenants.
-Please refer to the <a href="/hono/docs/api/management/">Device Registry HTTP API</a> for the specific elements that are explained in detail there.</p>
+<p>Please refer to the <a href="/hono/docs/api/management/#tenants">Device Registry Management API</a> for information about managing tenants.</p>
 
-<h3 id="add-a-tenant">Add a Tenant</h3>
+<h2 id="managing-devices">Managing Devices</h2>
 
-<ul>
-<li>URI: <code>/v1/tenants/${tenantId}</code></li>
-<li>Method: <code>POST</code></li>
-<li>Request Headers:
-
-<ul>
-<li>(required) <code>Content-Type</code>: <code>application/json</code> (no other type supported)</li>
-</ul></li>
-<li>Request Body:
-
-<ul>
-<li>(Optional) A JSON object as specified by <a href="/hono/docs/api/management/">Tenant schema</a> of the HTTP API specification.</li>
-</ul></li>
-<li>Status Codes:
-
-<ul>
-<li>201 (Created): Tenant has been added successfully under the resource indicated by <code>Location</code> header.</li>
-<li>400 (Bad Request): The tenant has not been created because the request was malformed, e .g. because the payload was malformed. The response body may contain hints regarding the cause of the problem.</li>
-<li>409 (Conflict): A tenant with the given <code>tenantId</code> already exists. The request has not been processed.</li>
-</ul></li>
-<li>Response Headers:
-
-<ul>
-<li><code>Location</code>: The URI under which the newly created resource can be accessed.</li>
-<li><code>ETag</code>: Version of the resource</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<p>The following commands add some tenants with different adapter configurations:</p>
-
-<p>Add a tenant that has all adapters set to enabled:</p>
-
-<pre><code class="language-sh">curl -i -X POST http://localhost:28080/v1/tenants/tenantAllAdapters
-
-HTTP/1.1 201 Created
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4
-Location: /v1/tenants/tenantAllAdapters
-Content-Type: application/json; charset=utf-8
-
-{&quot;id&quot;: &quot;tenantAllAdapters&quot;}
-</code></pre>
-
-<p>Add a tenant that can only use the MQTT adapter:</p>
-
-<pre><code class="language-sh">curl -i -X POST -H 'Content-Type: application/json' --data-binary '{
-    &quot;adapters&quot;: [ {
-        &quot;type&quot;: &quot;hono-mqtt&quot;,
-        &quot;enabled&quot;: true
-        } ]
-  }' http://localhost:28080/v1/tenants/tenantMqttAdapter
-
-HTTP/1.1 201 Created
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4
-Location:  /v1/tenants/tenantMqttAdapter
-Content-Type: application/json; charset=utf-8
-
-{&quot;id&quot;: &quot;tenantMqttAdapter&quot;}
-</code></pre>
-
-<h3 id="get-configuration-details-of-a-tenant">Get configuration details of a Tenant</h3>
-
-<ul>
-<li>URI: <code>/v1/tenants/${tenantId}</code></li>
-<li>Method: <code>GET</code></li>
-<li>Status Codes:
-
-<ul>
-<li>200 (OK): A tenant with the given identifier has been found. The response body contains the tenant data as specified by <a href="/hono/docs/api/management/">Tenant schema</a> of the HTTP API specification.</li>
-<li>404 (Not Found): No tenant with the given identifier is registered.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<p>The following command retrieves the details for the tenant <code>tenantMqttAdapter</code>:</p>
-
-<pre><code class="language-sh">curl -i http://localhost:28080/v1/tenants/tenantMqttAdapter
-
-HTTP/1.1 200 OK
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4
-Content-Type: application/json; charset=utf-8
-
-{
-     &quot;enabled&quot;: true,
-     &quot;adapters&quot;: [ {
-         &quot;type&quot;: &quot;hono-mqtt&quot;,
-         &quot;enabled&quot;: true
-     } ]
-}
-</code></pre>
-
-<p><strong>NB</strong> A tenant can be created without specifying a tenant identifier. The device registry will generate a tenant ID:</p>
-
-<pre><code class="language-sh">curl -i  -X POST http://localhost:28080/v1/tenants/
-
-HTTP/1.1 201 Created
-Etag: edc93899-7838-4dd1-93c8-839748c2fa42
-location: /v1/tenants/0b2df55f-1a02-43f7-a1c0-f3dbd25041e0
-content-type: application/json; charset=utf-8
-content-length: 45
-
-{&quot;id&quot;:&quot;0b2df55f-1a02-43f7-a1c0-f3dbd25041e0&quot;}
-</code></pre>
-
-<h3 id="update-tenant">Update Tenant</h3>
-
-<ul>
-<li>URI: <code>/v1/tenants/${tenantId}</code></li>
-<li>Method: <code>PUT</code></li>
-<li>Request Headers:
-
-<ul>
-<li>(required) <code>Content-Type</code>: <code>application/json</code> (no other type supported)</li>
-</ul></li>
-<li>Request Body:
-
-<ul>
-<li>(required) A JSON object as specified by <a href="/hono/docs/api/management/">Tenant schema</a> of the HTTP API specification.</li>
-</ul></li>
-<li>Status Codes:
-
-<ul>
-<li>204 (No Content): The tenant has been updated successfully.</li>
-<li>400 (Bad Request): The tenant has not been updated because the request was malformed, e .g. because the payload was malformed. The response body may contain hints regarding the cause of the problem.</li>
-<li>404 (Not Found): The request could not be processed because no tenant with the given identifier exists.</li>
-</ul></li>
-</ul>
-
-<p>This resource can be used to change the configuration of a particular tenant.</p>
-
-<p><strong>Example</strong></p>
-
-<p>The following command disables the MQTT adapter for devices that belong to the tenant <code>tenantMqttAdapter</code>:</p>
-
-<pre><code class="language-sh">curl -i -X PUT -H 'Content-Type: application/json' --data-binary '{
-      &quot;adapters&quot;: [ {
-          &quot;type&quot;: &quot;hono-mqtt&quot;,
-          &quot;enabled&quot;: true
-          } ]
-  }' http://localhost:28080/v1/tenants/tenantMqttAdapter
-
-HTTP/1.1 204 No Content
-ETag: 8919c736-30aa-40ce-a45a-830b90c4cd42
-Content-Length: 0
-</code></pre>
-
-<h3 id="delete-tenant">Delete Tenant</h3>
-
-<ul>
-<li>URI: <code>/v1/tenants/${tenantId}</code></li>
-<li>Method: <code>DELETE</code></li>
-<li>Status Codes:
-
-<ul>
-<li>204 (No Content): The tenant with the given identifier has been deleted.</li>
-<li>404 (Not Found): The request could not be processed because no tenant with the given identifier exists.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<pre><code class="language-sh">curl -i -X DELETE http://localhost:28080/v1/tenants/tenantMqttAdapter
-
-HTTP/1.1 204 No Content
-Content-Length: 0
-</code></pre>
-
-<h2 id="managing-device-registration-information">Managing Device Registration Information</h2>
-
-<p>The following sections describe the resources representing the operations of the <a href="/hono/docs/api/device-registration/">Device Registration API</a> and how they can be used to manage device registration information.
-Please refer to the <a href="/hono/docs/api/management/">Device Registry HTTP API</a> for the specific elements that are explained in detail there.</p>
-
-<h3 id="register-device">Register Device</h3>
-
-<ul>
-<li>URI: <code>/v1/devices/${tenantId}/${deviceId}</code></li>
-<li>Method: <code>POST</code></li>
-<li>Headers:
-
-<ul>
-<li>(required) <code>Content-Type</code>: <code>application/json</code></li>
-</ul></li>
-<li>Request Body:
-
-<ul>
-<li>(Optional) A JSON object as specified by <a href="/hono/docs/api/management/">Device schema</a> of the HTTP API specification.</li>
-</ul></li>
-<li>Status Codes:
-
-<ul>
-<li>201 (Created): Device has been registered successfully under resource indicated by <code>Location</code> header.</li>
-<li>400 (Bad Request): Device has not been registered because the request was malformed, e .g. a required header is missing (the body may contain hints regarding the problem).</li>
-<li>409 (Conflict): There already exists a device with the given ID. The request has not been processed.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<p>The following command registers a device with ID <code>4711</code> for tenant <code>DEFAULT_TENANT</code></p>
-
-<pre><code class="language-sh">curl -i -X POST -H 'Content-Type: application/json' --data-binary '{
-    &quot;ext&quot;: {
-        &quot;ep&quot;: &quot;IMEI4711&quot;
-    }
-}' http://localhost:28080/v1/devices/DEFAULT_TENANT/4711
-</code></pre>
-
-<p>The response will contain a <code>Location</code> header containing the resource path created for the device. In this example it will look
-like this:</p>
-
-<pre><code class="language-sh">HTTP/1.1 201 Created
-Location: /v1/devices/DEFAULT_TENANT/4711
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4
-Content-Type: application/json; charset=utf-8
-
-{&quot;id&quot;: &quot;4711&quot;}
-</code></pre>
-
-<p><strong>NB</strong> A device can be created without specifying a device identifier. The device registry will generate a device identifier:</p>
-
-<pre><code class="language-sh">curl -i -X POST http://localhost:28080/v1/devices/DEFAULT_TENANT
-
-HTTP/1.1 201 Created
-Etag: 0d615bcd-0825-44d9-9ef5-54a7b12165d8
-location: /v1/devices/DEFAULT_TENANT/98d25103-d49d-44b0-bdd0-0de84743c522
-content-type: application/json; charset=utf-8
-content-length: 45
-
-{&quot;id&quot;:&quot;98d25103-d49d-44b0-bdd0-0de84743c522&quot;}
-</code></pre>
-
-<h3 id="read-device">Read Device</h3>
-
-<ul>
-<li>URI: <code>/v1/devices/${tenantId}/${deviceId}</code></li>
-<li>Method: <code>GET</code></li>
-<li>Status Codes:
-
-<ul>
-<li>200 (OK): A device with the given identifier has been found. The response body contains the registration information as specified by <a href="/hono/docs/api/management/">Device schema</a> of the HTTP API specification.</li>
-<li>404 (Not Found): No device with the given identifier is registered for the given tenant.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<p>The following command retrieves registration data for device <code>4711</code>:</p>
-
-<pre><code class="language-sh">curl -i http://localhost:28080/v1/devices/DEFAULT_TENANT/4711
-
-HTTP/1.1 200 OK
-Content-Type: application/json; charset=utf-8
-
-{
-    &quot;enabled&quot;: true,
-    &quot;ext&quot;: {
-        &quot;ep&quot;: &quot;IMEI4711&quot;
-    }
-}
-</code></pre>
-
-<h3 id="update-device">Update Device</h3>
-
-<ul>
-<li>URI: <code>/devices/v1/${tenantId}/${deviceId}</code></li>
-<li>Method: <code>PUT</code></li>
-<li>Headers:
-
-<ul>
-<li>(required) <code>Content-Type</code>: <code>application/json</code></li>
-</ul></li>
-<li>Parameters (encoded as a JSON object in the request body):</li>
-<li>Request Body:
-
-<ul>
-<li>(required) A JSON object as specified by <a href="/hono/docs/api/management/">Device schema</a> of the HTTP API specification. All existing registration information will be replaced by the data provided in the object.</li>
-</ul></li>
-<li>Status Codes:
-
-<ul>
-<li>204 (No Content): Device registration data has been updated.</li>
-<li>400 (Bad Request): Device registration has not been updated because the request was malformed, e .g. a required header is missing (the body may contain hints regarding the problem).</li>
-<li>404 (Not Found): No device with the given identifier is registered for the given tenant.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<pre><code class="language-sh">curl -i -X PUT -H 'Content-Type: application/json' --data-binary '{
-    &quot;ext&quot;: {
-        &quot;ep&quot;: &quot;IMEI4711&quot;,
-        &quot;psk-id&quot;: &quot;psk4711&quot;
-    }
-}' http://localhost:28080/v1/devices/DEFAULT_TENANT/4711
-
-HTTP/1.1 204 No Content
-Content-Length: 0
-</code></pre>
-
-<h3 id="delete-device">Delete Device</h3>
-
-<ul>
-<li>URI: <code>/v1/devices/${tenantId}/${deviceId}</code></li>
-<li>Method: <code>DELETE</code></li>
-<li>Status Codes:
-
-<ul>
-<li>204 (No Content): Device registration has been deleted.</li>
-<li>404 (Not Found): No device with the given identifier is registered for the given tenant.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<pre><code class="language-sh">curl -i -X DELETE http://localhost:28080/v1/devices/DEFAULT_TENANT/4711
-
-HTTP/1.1 204 No Content
-Content-Length: 0
-</code></pre>
+<p>Please refer to the <a href="/hono/docs/api/management/#devices">Device Registry Management API</a> for information about managing devices.</p>
 
 <h2 id="managing-credentials">Managing Credentials</h2>
 
-<p>The following sections describe the resources representing the operations of the Credentials API and how they can be used to manage credentials for devices.
-Please refer to the <a href="/hono/docs/api/management/">Device Registry HTTP API</a> for the specific elements that are explained in detail there.</p>
-
-<h3 id="update-credentials-for-a-device">Update Credentials for a Device</h3>
-
-<ul>
-<li>URI: <code>/v1/credentials/${tenantId}/${deviceId}</code></li>
-<li>Method: <code>PUT</code></li>
-<li>Request Headers:
-
-<ul>
-<li>(required) <code>Content-Type</code>: <code>application/json</code> (no other type supported)</li>
-</ul></li>
-<li>Request Body:
-
-<ul>
-<li>(required) A JSON object as specified by <a href="/hono/docs/api/management/">Credentials schema</a> of the HTTP API specification.</li>
-</ul></li>
-<li>Status Codes:
-
-<ul>
-<li>204 (No Content): Credentials have been updated successfully.</li>
-<li>400 (Bad Request): The credentials have not been added because the request was malformed, e .g. because the payload did not contain required values. The response body may contain hints regarding the cause of the problem.</li>
-</ul></li>
-<li>Response Headers:
-
-<ul>
-<li><code>ETag</code>: Version of the resource</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<p>The following command adds some <code>hashed-password</code> credentials from a given plain text password for device <code>4710</code> using authentication identifier <code>sensor10</code>:</p>
-
-<pre><code class="language-sh">curl -i -X PUT -H 'Content-Type: application/json' --data-binary '[{
-  &quot;type&quot;: &quot;hashed-password&quot;,
-  &quot;auth-id&quot;: &quot;sensor10&quot;,
-  &quot;secrets&quot;: [{
-      &quot;pwd-plain&quot;: &quot;mylittlesecret&quot;
-  }]
-}]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4710
-  
-HTTP/1.1 204 No Content
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4x
-</code></pre>
-
-<p>This uses a convenient option which lets the Device Registry do the hashing of the password. The following command retrieves the credentials that are stored by the Device Registry as a result of the command above:</p>
-
-<pre><code class="language-sh">curl -i http://localhost:28080/v1/credentials/DEFAULT_TENANT/4710
-
-HTTP/1.1 200 OK
-Content-Type: application/json; charset=utf-8
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4x
-
-[{
-  &quot;type&quot;: &quot;hashed-password&quot;,
-  &quot;auth-id&quot;: &quot;sensor10&quot;,
-  &quot;enabled&quot;: true,
-  &quot;secrets&quot;: [
-    {
-      &quot;id&quot;: &quot;349556ea-4902-47c7-beb0-1009ab693fb4&quot;
-    }
-  ]
-}]
-</code></pre>
-
-<p>The above result does not contain <code>pwd_hash</code> and <code>hash_function</code> of the secret, as these values are confidential.</p>
-
-<p>The following commands set some <code>hashed-password</code> credentials for device <code>4720</code> using authentication identifier <code>sensor20</code>:</p>
-
-<pre><code class="language-sh">curl -i -X PUT -H 'Content-Type: application/json' --data-binary '[{
-    &quot;type&quot;: &quot;hashed-password&quot;,
-    &quot;auth-id&quot;: &quot;sensor20&quot;,
-    &quot;secrets&quot;: [{
-        &quot;pwd-plain&quot;: &quot;mylittlesecret&quot;
-    }]
-  }]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720
-
-HTTP/1.1 204 No Content
-ETag: 02c99fb5-af8c-409f-8520-b405e224b27f
-</code></pre>
-
-<p>The following command adds an expiration date to the <code>hashed-password</code> credentials for authentication identifier <code>sensor20</code>:</p>
-
-<pre><code class="language-sh">curl -i -X PUT -H 'Content-Type: application/json' --data-binary '{
-    &quot;device-id&quot;: &quot;4720&quot;,
-    &quot;type&quot;: &quot;hashed-password&quot;,
-    &quot;auth-id&quot;: &quot;sensor20&quot;,
-    &quot;secrets&quot;: [{
-        &quot;pwd-plain&quot;: &quot;mylittlesecret&quot;,
-        &quot;not-after&quot;: &quot;2018-01-01T00:00:00+01:00&quot;
-    }]
-}' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720
-
-HTTP/1.1 204 No Content
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4x
-</code></pre>
-
-<p>Multiple credentials of different type can be registered for the same authentication identifier.
-The following commands add <code>psk</code> credentials for the same device <code>4720</code> using authentication identifier <code>sensor20</code>:</p>
-
-<pre><code class="language-sh">SHARED_KEY=$(echo -n &quot;TheSharedKey&quot; | base64 -w 0)
-curl -i -X PUT -H 'Content-Type: application/json' --data-binary '[
-{
-    &quot;type&quot;: &quot;hashed-password&quot;,
-    &quot;auth-id&quot;: &quot;sensor20&quot;,
-    &quot;secrets&quot;: [{
-        &quot;pwd-plain&quot;: &quot;mylittlesecret&quot;
-    }]
-},
-{
-   &quot;device-id&quot;: &quot;4720&quot;,
-   &quot;type&quot;: &quot;psk&quot;,
-   &quot;auth-id&quot;: &quot;sensor20&quot;,
-   &quot;secrets&quot;: [{
-     &quot;key&quot;: &quot;'$SHARED_KEY'&quot;
-     }]
-  }]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720
-
-HTTP/1.1 204 No Content
-ETag: 122c971a-505a-4336-8f7d-640360e909bc
-</code></pre>
-
-<p>The following command deletes all credentials for device <code>4710</code>:</p>
-
-<pre><code class="language-sh">curl -i -X PUT -H 'Content-Type: application/json' --data-binary '[]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4710
-
-HTTP/1.1 204 No Content
-ETag: d383ba4d-1853-4d03-b322-b7ff5af05ae2
-</code></pre>
-
-<h3 id="get-all-credentials-for-a-device">Get all Credentials for a Device</h3>
-
-<ul>
-<li>URI: <code>/v1/credentials/${tenantId}/${deviceId}</code></li>
-<li>Method: <code>GET</code></li>
-<li>Status Codes:
-
-<ul>
-<li>200 (OK): Credentials for the device have been found, body contains the credentials. The response body contains the registration information as specified by <a href="/hono/docs/api/management/">Credentials schema</a> of the HTTP API specification.</li>
-<li>404 (Not Found): No credentials for the device are registered.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<p>The following command retrieves credentials metadata for device <code>4720</code>:</p>
-
-<pre><code class="language-sh">curl -i http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720
-
-HTTP/1.1 200 OK
-Content-Type: application/json; charset=utf-8
-ETag: f3449b77-2c84-4b09-8d04-2b305876e0cb
-
-{[
-    {
-        &quot;auth-id&quot;: &quot;sensor20&quot;,
-        &quot;enabled&quot;: true,
-        &quot;secrets&quot;: [
-            {
-                &quot;id&quot;: &quot;d383ba4d-1853-4d03-b322-b7ff5af05ae2&quot;
-                &quot;not-after&quot;: &quot;2020-02-1T00:00:00+01:00&quot;
-            },
-            {
-                &quot;id&quot;: &quot;46810d5c-133e-4c1c-994d-ed7745516b8e&quot;
-                &quot;not-before&quot;: &quot;2020-01-01T00:00:00+01:00&quot;
-            }
-        ],
-        &quot;type&quot;: &quot;hashed-password&quot;
-    },
-    {
-        &quot;auth-id&quot;: &quot;sensor20&quot;,
-        &quot;enabled&quot;: true,
-        &quot;secrets&quot;: [
-            {
-                &quot;key&quot;: &quot;VGhlU2hhcmVkS2V5&quot;
-            }
-        ],
-        &quot;type&quot;: &quot;psk&quot;
-    }
-]}
-</code></pre>
+<p>Please refer to the <a href="/hono/docs/api/management/#credentials">Device Registry Management API</a> for information about managing credentials.</p>
 
 <footer class=" footline" >
 	
@@ -2195,6 +1721,25 @@
             
                 
                     
+                        
+                        
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
                     
                 
                 
@@ -2530,6 +2075,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2932,20 +2509,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/user-guide/http-adapter/index.html b/docs/user-guide/http-adapter/index.html
index d176283..c8ef0e0 100644
--- a/docs/user-guide/http-adapter/index.html
+++ b/docs/user-guide/http-adapter/index.html
@@ -21,19 +21,19 @@
     <title>HTTP Adapter :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/http-adapter/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/http-adapter/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/http-adapter/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/http-adapter/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/http-adapter/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/http-adapter/">dev</option>
@@ -1519,7 +1602,14 @@
 
 <h2 id="message-limits">Message Limits</h2>
 
-<p>Before accepting any telemetry or event or command messages, the HTTP adapter verifies that the configured <a href="/hono/docs/concepts/resource-limits/">message limit</a> is not exceeded. If the limit is exceeded then the incoming message is discarded with the status code <code>429 Too Many Requests</code>.</p>
+<p>The adapter rejects</p>
+
+<ul>
+<li>a client&rsquo;s request to upload data with status code <code>429 Too Many Requests</code> and</li>
+<li>any AMQP 1.0 message containing a command sent by a north bound application</li>
+</ul>
+
+<p>if the <a href="/hono/docs/concepts/resource-limits/">message limit</a> that has been configured for the device&rsquo;s tenant is exceeded.</p>
 
 <h2 id="publish-telemetry-data-authenticated-device">Publish Telemetry Data (authenticated Device)</h2>
 
@@ -2060,7 +2150,7 @@
 
 <h3 id="commands-handled-by-gateways">Commands handled by gateways</h3>
 
-<p>Authenticated gateways will receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway. Corresponding devices have to be configured so that they can be used with a gateway. See <a href="/hono/docs/admin-guide/device-registry-config/#configuring-gateway-devices">Configuring Gateway Devices</a> for details.</p>
+<p>Authenticated gateways will receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway. Corresponding devices have to be configured so that they can be used with a gateway. See <a href="/hono/docs/admin-guide/file-based-device-registry-config/#configuring-gateway-devices">Configuring Gateway Devices</a> for details.</p>
 
 <p>A gateway can send a request with the <code>hono-ttd</code> header or query parameter on the <code>/event</code> or <code>/telemetry</code> URI, indicating its readiness to receive a command for <em>any</em> device it acts on behalf of. Note that in this case, the business application will be notified with the gateway id in the <code>device_id</code> property of the downstream message.</p>
 
@@ -2546,6 +2636,22 @@
             
                 
                     
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
                     
                 
                 
@@ -2865,6 +2971,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -3267,20 +3405,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/user-guide/index.html b/docs/user-guide/index.html
index c25de80..427829d 100644
--- a/docs/user-guide/index.html
+++ b/docs/user-guide/index.html
@@ -21,19 +21,19 @@
     <title>User Guide :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/">dev</option>
@@ -1775,6 +1858,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -1983,6 +2082,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2385,20 +2516,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/user-guide/index.xml b/docs/user-guide/index.xml
index b8b60c8..757ebc3 100644
--- a/docs/user-guide/index.xml
+++ b/docs/user-guide/index.xml
@@ -11,11 +11,20 @@
     
     
     <item>
-      <title>Device Registry</title>
-      <link>https://www.eclipse.org/hono/docs/user-guide/device-registry/</link>
+      <title>MongoDB Based Device Registry</title>
+      <link>https://www.eclipse.org/hono/docs/user-guide/mongodb-based-device-registry/</link>
       <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
       
-      <guid>https://www.eclipse.org/hono/docs/user-guide/device-registry/</guid>
+      <guid>https://www.eclipse.org/hono/docs/user-guide/mongodb-based-device-registry/</guid>
+      <description>The MongoDB based Device Registry component provides implementations of Hono&amp;rsquo;s Tenant API, Device Registration API and Credentials API. As such it exposes AMQP 1.0 based endpoints for retrieving the relevant information. Protocol adapters use these APIs to determine a device&amp;rsquo;s registration status, e.g. if it is enabled and if it is registered with a particular tenant, and to authenticate a device before accepting any data for processing from it.</description>
+    </item>
+    
+    <item>
+      <title>File Based Device Registry</title>
+      <link>https://www.eclipse.org/hono/docs/user-guide/file-based-device-registry/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://www.eclipse.org/hono/docs/user-guide/file-based-device-registry/</guid>
       <description>&lt;p&gt;The Device Registry component provides exemplary implementations of Hono&amp;rsquo;s &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/tenant/&#34;&gt;Tenant API&lt;/a&gt;, &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/device-registration/&#34;&gt;Device Registration API&lt;/a&gt; and &lt;a href=&#34;https://www.eclipse.org/hono/docs/hono/docs/api/credentials/&#34;&gt;Credentials API&lt;/a&gt;.&lt;/p&gt;</description>
     </item>
     
diff --git a/docs/user-guide/jmeter_load_tests/index.html b/docs/user-guide/jmeter_load_tests/index.html
index 4f9b62e..692c549 100644
--- a/docs/user-guide/jmeter_load_tests/index.html
+++ b/docs/user-guide/jmeter_load_tests/index.html
@@ -21,19 +21,19 @@
     <title>Load Tests with JMeter :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/jmeter_load_tests/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/jmeter_load_tests/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/jmeter_load_tests/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/jmeter_load_tests/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/jmeter_load_tests/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/jmeter_load_tests/">dev</option>
@@ -1811,6 +1894,22 @@
             
                 
                     
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
                     
                 
                 
@@ -2034,6 +2133,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2436,20 +2567,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/user-guide/kura-adapter/index.html b/docs/user-guide/kura-adapter/index.html
index 333b335..d2ca0c3 100644
--- a/docs/user-guide/kura-adapter/index.html
+++ b/docs/user-guide/kura-adapter/index.html
@@ -21,19 +21,19 @@
     <title>Kura Adapter :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/kura-adapter/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/kura-adapter/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/kura-adapter/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/kura-adapter/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/kura-adapter/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/kura-adapter/">dev</option>
@@ -1445,6 +1528,19 @@
 <ul>
 <li>
 <ul>
+<li><a href="#authentication">Authentication</a>
+<ul>
+<li><a href="#client-certificate">Client Certificate</a></li>
+<li><a href="#username-password">Username/Password</a></li>
+</ul></li>
+<li><a href="#resource-limit-checks">Resource Limit Checks</a>
+<ul>
+<li><a href="#connection-limits">Connection Limits</a></li>
+<li><a href="#connection-duration-limits">Connection Duration Limits</a></li>
+<li><a href="#message-limits">Message Limits</a></li>
+</ul></li>
+<li><a href="#connection-events">Connection Events</a></li>
+<li><a href="#publishing-data">Publishing Data</a></li>
 <li><a href="#downstream-meta-data">Downstream Meta Data</a>
 <ul>
 <li><a href="#event-message-time-to-live">Event Message Time-to-live</a></li>
@@ -1478,18 +1574,95 @@
 </div>
 
 
-<p>The Kura adapter by default requires devices (gateways) to authenticate during connection establishment. In order to do so, gateways need to provide a <em>username</em> and a <em>password</em> in the MQTT <em>CONNECT</em> packet. The <em>username</em> must have the form <em>auth-id@tenant</em>, e.g. <code>sensor1@DEFAULT_TENANT</code>. The adapter verifies the credentials provided by the gateway against the credentials the <a href="/hono/docs/admin-guide/common-config/#credentials-service-connection-configuration">configured Credentials service</a> has on record for the gateway. The adapter uses the Credentials API&rsquo;s <em>get</em> operation to retrieve the credentials-on-record with the <em>tenant</em> and <em>auth-id</em> provided by the device in the <em>username</em> and <code>hashed-password</code> as the <em>type</em> of secret as query parameters.</p>
+<h2 id="authentication">Authentication</h2>
 
-<p>Please refer to the <a href="http://eclipse.github.io/kura/config/cloud-services.html">Eclipse Kura documentation</a> on how to configure the gateway&rsquo;s cloud service connection accordingly. It is important to set the gateway&rsquo;s <em>topic.context.account-name</em> to the ID of the Hono tenant that the gateway has been registered with whereas the gateway&rsquo;s <em>client-id</em> needs to be set to the corresponding Hono device ID. The <em>auth-id</em> used as part of the gateway&rsquo;s <em>username</em> property needs to match the authentication identifier of a set of credentials registered for the device ID in Hono&rsquo;s Credentials service. In other words, the credentials configured on the gateway need to belong to the corresponding device ID.</p>
+<p>The Kura adapter by default requires devices (gateways) to authenticate during connection establishment.
+The adapter supports both the authentication based on the username/password provided in an MQTT CONNECT packet as well as client
+certificate based authentication as part of a TLS handshake for that purpose.</p>
 
-<p>After verifying the credentials, the number of existing connections and the overall amount of time that the devices have already been connected are checked against the configured <a href="/hono/docs/concepts/resource-limits/">resource-limits</a> by the Kura adapter.  If the limit is exceeded then a return code <code>0x05</code> indicating <code>Connection Refused: not authorised</code> is sent back.</p>
+<p>The adapter tries to authenticate the device using these mechanisms in the following order</p>
 
-<p>Once the gateway has established a connection to the Kura adapter, all <em>control</em> and <em>data</em> messages published by applications running on the gateway are sent to the adapter and mapped to Hono&rsquo;s Telemetry and Event API endpoints as follows:</p>
+<h3 id="client-certificate">Client Certificate</h3>
+
+<p>When a device uses a client certificate for authentication during the TLS handshake, the adapter tries to determine the tenant
+that the device belongs to based on the <em>issuer DN</em> contained in the certificate.
+In order for the lookup to succeed, the tenant&rsquo;s trust anchor needs to be configured by means of registering the
+<a href="/hono/docs/api/tenant/#tenant-information-format">trusted certificate authority</a>. The device&rsquo;s client certificate will then be
+validated using the registered trust anchor, thus implicitly establishing the tenant that the device belongs to.
+In a second step, the adapter uses the Credentials API&rsquo;s <em>get</em> operation to retrieve the credentials on record, including the client
+certificate&rsquo;s <em>subject DN</em> as the <em>auth-id</em>, <code>x509-cert</code> as the <em>type</em> of secret and the MQTT client identifier as <em>client-id</em> in the
+request payload.</p>
+
+<p><strong>NB</strong> The adapter needs to be <a href="/hono/docs/admin-guide/secure_communication/#mqtt-adapter">configured for TLS</a> in order to support this mechanism.</p>
+
+<h3 id="username-password">Username/Password</h3>
+
+<p>When a device wants to authenticate using this mechanism, it needs to provide a <em>username</em> and a <em>password</em> in the MQTT <em>CONNECT</em> packet
+it sends in order to initiate the connection. The <em>username</em> must have the form <em>auth-id@tenant</em>, e.g. <code>sensor1@DEFAULT_TENANT</code>.
+The adapter verifies the credentials provided by the client against the credentials that the
+<a href="/hono/docs/admin-guide/common-config/#credentials-service-connection-configuration">configured Credentials service</a> has on record for the client.
+The adapter uses the Credentials API&rsquo;s <em>get</em> operation to retrieve the credentials on record, including the <em>tenant</em> and <em>auth-id</em> provided
+by the client in the <em>username</em>, <code>hashed-password</code> as the <em>type</em> of secret and the MQTT client identifier as <em>client-id</em> in the request payload.</p>
+
+<p>Please refer to the <a href="http://eclipse.github.io/kura/config/cloud-services.html">Eclipse Kura documentation</a> on how to configure the
+gateway&rsquo;s cloud service connection accordingly. It is important to set the gateway&rsquo;s <em>topic.context.account-name</em> to the ID of the
+Hono tenant that the gateway has been registered with whereas the gateway&rsquo;s <em>client-id</em> needs to be set to the corresponding Hono
+device ID. The <em>auth-id</em> used as part of the gateway&rsquo;s <em>username</em> property needs to match the authentication identifier of a set of
+credentials registered for the device ID in Hono&rsquo;s Credentials service. In other words, the credentials configured on the gateway
+need to belong to the corresponding device ID.</p>
+
+<p><strong>NB</strong> There is a subtle difference between the <em>device identifier</em> (<em>device-id</em>) and the <em>auth-id</em> a device uses for authentication.
+See <a href="/hono/docs/concepts/device-identity/">Device Identity</a> for a discussion of the concepts.</p>
+
+<h2 id="resource-limit-checks">Resource Limit Checks</h2>
+
+<p>The adapter performs additional checks regarding resource limits when a client tries to connect and/or send a message to the adapter.</p>
+
+<h3 id="connection-limits">Connection Limits</h3>
+
+<p>The adapter rejects a client&rsquo;s connection attempt with return code <code>0x05</code>, indicating <code>Connection Refused: not authorized</code>, if
+* the maximum number of connections per protocol adapter instance is reached, or
+* if the maximum number of simultaneously connected devices for the tenant is reached.</p>
+
+<p>Please refer to <a href="/hono/docs/concepts/resource-limits/">resource-limits</a> for details.</p>
+
+<h3 id="connection-duration-limits">Connection Duration Limits</h3>
+
+<p>The adapter rejects a client&rsquo;s connection attempt with return code <code>0x05</code>, indicating <code>Connection Refused: not authorized</code>, if the
+<a href="/hono/docs/concepts/resource-limits/#connection-duration-limit">connection duration limit</a> that has been configured for
+the client&rsquo;s tenant is exceeded.</p>
+
+<h3 id="message-limits">Message Limits</h3>
+
+<p>The adapter</p>
+
+<ul>
+<li>discards any MQTT PUBLISH packet containing telemetry data or an event that is sent by a client and</li>
+<li>rejects any AMQP 1.0 message containing a command sent by a north bound application</li>
+</ul>
+
+<p>if the <a href="/hono/docs/concepts/resource-limits/">message limit</a> that has been configured for the device&rsquo;s tenant is exceeded.</p>
+
+<h2 id="connection-events">Connection Events</h2>
+
+<p>The adapter can emit <a href="/hono/docs/api/event/#connection-event">Connection Events</a> for client connections being established and/or terminated.
+Please refer to the <a href="/hono/docs/admin-guide/common-config/#connection-event-producer-configuration">common configuration options</a>
+for details regarding how to enable this behavior.</p>
+
+<p>The adapter includes the <em>client identifier</em> from the client&rsquo;s MQTT CONNECT packet as the Connection Event&rsquo;s <em>remote-id</em>.</p>
+
+<h2 id="publishing-data">Publishing Data</h2>
+
+<p>Once the gateway has established a connection to the Kura adapter, all <em>control</em> and <em>data</em> messages published by applications running on
+the gateway are sent to the adapter and mapped to Hono&rsquo;s Telemetry and Event API endpoints as follows:</p>
 
 <ol>
-<li>The adapter treats all messages that are published to a topic starting with the configured <code>HONO_KURA_CONTROL_PREFIX</code> as control messages. All other messages are considered to be data messages.</li>
-<li><em>control</em> messages with QoS 0 are forwarded to Hono&rsquo;s telemetry endpoint whereas messages with QoS 1 are forwarded to the event endpoint. The corresponding AMQP 1.0 messages that are sent downstream have a content type of <code>application/vnd.eclipse.kura-control</code>.</li>
-<li><em>data</em> messages with QoS 0 are forwarded to the telemetry endpoint whereas messages with QoS 1 are forwarded to the event endpoint. The corresponding AMQP 1.0 messages that are sent downstream have a content type of <code>application/vnd.eclipse.kura-data</code>.</li>
+<li>The adapter treats all messages that are published to a topic starting with the configured <code>HONO_KURA_CONTROL_PREFIX</code> as control messages.
+All other messages are considered to be data messages.</li>
+<li><em>control</em> messages with QoS 0 are forwarded to Hono&rsquo;s telemetry endpoint whereas messages with QoS 1 are forwarded to the event endpoint.
+The corresponding AMQP 1.0 messages that are sent downstream have a content type of <code>application/vnd.eclipse.kura-control</code>.</li>
+<li><em>data</em> messages with QoS 0 are forwarded to the telemetry endpoint whereas messages with QoS 1 are forwarded to the event endpoint.
+The corresponding AMQP 1.0 messages that are sent downstream have a content type of <code>application/vnd.eclipse.kura-data</code>.</li>
 </ol>
 
 <h2 id="downstream-meta-data">Downstream Meta Data</h2>
@@ -1854,6 +2027,22 @@
             
                 
                     
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
                     
                 
                 
@@ -2109,6 +2298,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2511,20 +2732,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/user-guide/device-registry/index.html b/docs/user-guide/mongodb-based-device-registry/index.html
similarity index 63%
copy from docs/user-guide/device-registry/index.html
copy to docs/user-guide/mongodb-based-device-registry/index.html
index 5ff6a71..7b7b4a0 100644
--- a/docs/user-guide/device-registry/index.html
+++ b/docs/user-guide/mongodb-based-device-registry/index.html
@@ -18,22 +18,22 @@
 <meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
 <meta name="theme-color" content="#ffffff">
 
-    <title>Device Registry :: Eclipse Hono&trade;</title>
+    <title>MongoDB Based Device Registry :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -53,18 +53,18 @@
 
 <meta name="twitter:card" content="summary_large_image">
 <meta name="twitter:site" content="@EclipseHono">
-<meta name="twitter:title" content="Device Registry :: Eclipse Hono&amp;trade;">
+<meta name="twitter:title" content="MongoDB Based Device Registry :: Eclipse Hono&amp;trade;">
 <meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
 <meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
 
 
-<meta property="og:title" content="Device Registry :: Eclipse Hono&amp;trade;" />
+<meta property="og:title" content="MongoDB Based Device Registry :: Eclipse Hono&amp;trade;" />
 <meta property="og:type" content="website" />
-<meta property="og:url" content="https://www.eclipse.org/hono/docs/user-guide/device-registry//" />
+<meta property="og:url" content="https://www.eclipse.org/hono/docs/user-guide/mongodb-based-device-registry//" />
 <meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
 
   </head>
-  <body class="" data-url="/hono/docs/user-guide/device-registry/">
+  <body class="" data-url="/hono/docs/user-guide/mongodb-based-device-registry/">
     <nav id="sidebar" class="">
 
 
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item active">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item active">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,7 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/device-registry/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/mongodb-based-device-registry/" selected>stable (1.3)</option>
                     
                   
               
@@ -1287,24 +1344,14 @@
               
                   
               
+                  
+              
           
               
               
                   
               
                   
-                    
-                    
-                      <option id="1.1" value="/hono/docs/1.1/user-guide/device-registry/">1.1</option>
-                    
-                  
-              
-                  
-              
-                  
-              
-          
-              
               
                   
               
@@ -1313,12 +1360,10 @@
                   
                     
                     
-                      <option id="1.0" value="/hono/docs/1.0/user-guide/device-registry/">1.0</option>
+                      <option id="dev" value="/hono/docs/dev/user-guide/mongodb-based-device-registry/">dev</option>
                     
                   
               
-                  
-              
           
         </select>
         <svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
@@ -1381,7 +1426,7 @@
                   
                   
                   <div id="top-github-link">
-                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/user-guide/device-registry.md" target="blank">
+                    <a class="github-link" title='Edit this page' href="https://github.com/eclipse/hono/edit/master/site/documentation/content/user-guide/mongodb-based-device-registry.md" target="blank">
                       <i class="fas fa-code-branch"></i>
                       <span id="top-github-link-text">Edit this page</span>
                     </a>
@@ -1412,7 +1457,7 @@
             
           
           
-            <a href='/hono/docs/'>Documentation</a> > <a href='/hono/docs/user-guide/'>User Guide</a> > Device Registry
+            <a href='/hono/docs/'>Documentation</a> > <a href='/hono/docs/user-guide/'>User Guide</a> > MongoDB Based Device Registry
           
          
           
@@ -1429,25 +1474,10 @@
 <ul>
 <li>
 <ul>
-<li><a href="#managing-tenants">Managing Tenants</a>
-<ul>
-<li><a href="#add-a-tenant">Add a Tenant</a></li>
-<li><a href="#get-configuration-details-of-a-tenant">Get configuration details of a Tenant</a></li>
-<li><a href="#update-tenant">Update Tenant</a></li>
-<li><a href="#delete-tenant">Delete Tenant</a></li>
-</ul></li>
-<li><a href="#managing-device-registration-information">Managing Device Registration Information</a>
-<ul>
-<li><a href="#register-device">Register Device</a></li>
-<li><a href="#read-device">Read Device</a></li>
-<li><a href="#update-device">Update Device</a></li>
-<li><a href="#delete-device">Delete Device</a></li>
-</ul></li>
-<li><a href="#managing-credentials">Managing Credentials</a>
-<ul>
-<li><a href="#update-credentials-for-a-device">Update Credentials for a Device</a></li>
-<li><a href="#get-all-credentials-for-a-device">Get all Credentials for a Device</a></li>
-</ul></li>
+<li><a href="#authentication">Authentication</a></li>
+<li><a href="#managing-tenants">Managing Tenants</a></li>
+<li><a href="#managing-devices">Managing Devices</a></li>
+<li><a href="#managing-credentials">Managing Credentials</a></li>
 </ul></li>
 </ul>
 </nav>
@@ -1462,541 +1492,34 @@
         
         <div id="body-inner">
           
-            <h1>Device Registry</h1>
+            <h1>MongoDB Based Device Registry</h1>
           
 
         
 
 
-<p>The Device Registry component provides exemplary implementations of Hono&rsquo;s <a href="/hono/docs/api/tenant/">Tenant API</a>, <a href="/hono/docs/api/device-registration/">Device Registration API</a> and <a href="/hono/docs/api/credentials/">Credentials API</a>.</p>
 
-<p>As such it exposes AMQP 1.0 based endpoints for retrieving the relevant information and persists data in the local filesystem.</p>
 
-<p>In addition, the Device Registry also exposes HTTP resources for managing the contents of the registry according to the <a href="/hono/docs/api/management/">Device Registry HTTP API</a>.</p>
+<p>The MongoDB based Device Registry component provides implementations of Hono&rsquo;s <a href="/hono/docs/api/tenant/">Tenant API</a>, <a href="/hono/docs/api/device-registration/">Device Registration API</a> and <a href="/hono/docs/api/credentials/">Credentials API</a>. As such it exposes AMQP 1.0 based endpoints for retrieving the relevant information. Protocol adapters use these APIs to determine a device&rsquo;s registration status, e.g. if it is enabled and if it is registered with a particular tenant, and to authenticate a device before accepting any data for processing from it.</p>
 
-<div class="alert alert-warning">
-    <h4 class="alert-heading"><i class="fas fa-exclamation-triangle"></i> Warning</h4>
-    <div><p>The Device Registry is not intended to be used in production environments. In particular, access to the HTTP resources described below is not restricted to authorized clients only.</p>
+<p>In addition to the above APIs, this Device Registry also exposes HTTP endpoints for managing the contents of the Device Registry according to the <a href="/hono/docs/api/management/">Device Registry Management API</a>. It uses a MongoDB database to persist the data. The credentials, device and tenant information are stored in separate collections in a MongoDB database. For more information on how to configure the MongoDB based device registry, see <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">MongoDB based Device Registry configuration</a>.</p>
 
-<p>The resources have been designed to provide convenient access to the registry&rsquo;s content using command line tools like <em>curl</em> or <em>HTTPie</em>.</p>
-</div>
-</div>
+<h2 id="authentication">Authentication</h2>
 
+<p>This Device Registry secures its HTTP Endpoints using basic authentication mechanism. Thereby the clients connecting to the MongoDB based Device Registry are required to authenticate. For more information on how to enable the authentication and configure it, please refer to the <code>hono.registry.http.authenticationRequired</code> property in the <a href="/hono/docs/admin-guide/mongodb-device-registry-config/#service-configuration">MongoDB based Device Registry configuration</a>.</p>
 
 <h2 id="managing-tenants">Managing Tenants</h2>
 
-<p>The following sections describe the resources representing the operations of the Tenant API and how they can be used to manage tenants.
-Please refer to the <a href="/hono/docs/api/management/">Device Registry HTTP API</a> for the specific elements that are explained in detail there.</p>
+<p>Please refer to the <a href="/hono/docs/api/management/#tenants">Device Registry Management API</a> for information about managing tenants.</p>
 
-<h3 id="add-a-tenant">Add a Tenant</h3>
+<h2 id="managing-devices">Managing Devices</h2>
 
-<ul>
-<li>URI: <code>/v1/tenants/${tenantId}</code></li>
-<li>Method: <code>POST</code></li>
-<li>Request Headers:
-
-<ul>
-<li>(required) <code>Content-Type</code>: <code>application/json</code> (no other type supported)</li>
-</ul></li>
-<li>Request Body:
-
-<ul>
-<li>(Optional) A JSON object as specified by <a href="/hono/docs/api/management/">Tenant schema</a> of the HTTP API specification.</li>
-</ul></li>
-<li>Status Codes:
-
-<ul>
-<li>201 (Created): Tenant has been added successfully under the resource indicated by <code>Location</code> header.</li>
-<li>400 (Bad Request): The tenant has not been created because the request was malformed, e .g. because the payload was malformed. The response body may contain hints regarding the cause of the problem.</li>
-<li>409 (Conflict): A tenant with the given <code>tenantId</code> already exists. The request has not been processed.</li>
-</ul></li>
-<li>Response Headers:
-
-<ul>
-<li><code>Location</code>: The URI under which the newly created resource can be accessed.</li>
-<li><code>ETag</code>: Version of the resource</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<p>The following commands add some tenants with different adapter configurations:</p>
-
-<p>Add a tenant that has all adapters set to enabled:</p>
-
-<pre><code class="language-sh">curl -i -X POST http://localhost:28080/v1/tenants/tenantAllAdapters
-
-HTTP/1.1 201 Created
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4
-Location: /v1/tenants/tenantAllAdapters
-Content-Type: application/json; charset=utf-8
-
-{&quot;id&quot;: &quot;tenantAllAdapters&quot;}
-</code></pre>
-
-<p>Add a tenant that can only use the MQTT adapter:</p>
-
-<pre><code class="language-sh">curl -i -X POST -H 'Content-Type: application/json' --data-binary '{
-    &quot;adapters&quot;: [ {
-        &quot;type&quot;: &quot;hono-mqtt&quot;,
-        &quot;enabled&quot;: true
-        } ]
-  }' http://localhost:28080/v1/tenants/tenantMqttAdapter
-
-HTTP/1.1 201 Created
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4
-Location:  /v1/tenants/tenantMqttAdapter
-Content-Type: application/json; charset=utf-8
-
-{&quot;id&quot;: &quot;tenantMqttAdapter&quot;}
-</code></pre>
-
-<h3 id="get-configuration-details-of-a-tenant">Get configuration details of a Tenant</h3>
-
-<ul>
-<li>URI: <code>/v1/tenants/${tenantId}</code></li>
-<li>Method: <code>GET</code></li>
-<li>Status Codes:
-
-<ul>
-<li>200 (OK): A tenant with the given identifier has been found. The response body contains the tenant data as specified by <a href="/hono/docs/api/management/">Tenant schema</a> of the HTTP API specification.</li>
-<li>404 (Not Found): No tenant with the given identifier is registered.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<p>The following command retrieves the details for the tenant <code>tenantMqttAdapter</code>:</p>
-
-<pre><code class="language-sh">curl -i http://localhost:28080/v1/tenants/tenantMqttAdapter
-
-HTTP/1.1 200 OK
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4
-Content-Type: application/json; charset=utf-8
-
-{
-     &quot;enabled&quot;: true,
-     &quot;adapters&quot;: [ {
-         &quot;type&quot;: &quot;hono-mqtt&quot;,
-         &quot;enabled&quot;: true
-     } ]
-}
-</code></pre>
-
-<p><strong>NB</strong> A tenant can be created without specifying a tenant identifier. The device registry will generate a tenant ID:</p>
-
-<pre><code class="language-sh">curl -i  -X POST http://localhost:28080/v1/tenants/
-
-HTTP/1.1 201 Created
-Etag: edc93899-7838-4dd1-93c8-839748c2fa42
-location: /v1/tenants/0b2df55f-1a02-43f7-a1c0-f3dbd25041e0
-content-type: application/json; charset=utf-8
-content-length: 45
-
-{&quot;id&quot;:&quot;0b2df55f-1a02-43f7-a1c0-f3dbd25041e0&quot;}
-</code></pre>
-
-<h3 id="update-tenant">Update Tenant</h3>
-
-<ul>
-<li>URI: <code>/v1/tenants/${tenantId}</code></li>
-<li>Method: <code>PUT</code></li>
-<li>Request Headers:
-
-<ul>
-<li>(required) <code>Content-Type</code>: <code>application/json</code> (no other type supported)</li>
-</ul></li>
-<li>Request Body:
-
-<ul>
-<li>(required) A JSON object as specified by <a href="/hono/docs/api/management/">Tenant schema</a> of the HTTP API specification.</li>
-</ul></li>
-<li>Status Codes:
-
-<ul>
-<li>204 (No Content): The tenant has been updated successfully.</li>
-<li>400 (Bad Request): The tenant has not been updated because the request was malformed, e .g. because the payload was malformed. The response body may contain hints regarding the cause of the problem.</li>
-<li>404 (Not Found): The request could not be processed because no tenant with the given identifier exists.</li>
-</ul></li>
-</ul>
-
-<p>This resource can be used to change the configuration of a particular tenant.</p>
-
-<p><strong>Example</strong></p>
-
-<p>The following command disables the MQTT adapter for devices that belong to the tenant <code>tenantMqttAdapter</code>:</p>
-
-<pre><code class="language-sh">curl -i -X PUT -H 'Content-Type: application/json' --data-binary '{
-      &quot;adapters&quot;: [ {
-          &quot;type&quot;: &quot;hono-mqtt&quot;,
-          &quot;enabled&quot;: true
-          } ]
-  }' http://localhost:28080/v1/tenants/tenantMqttAdapter
-
-HTTP/1.1 204 No Content
-ETag: 8919c736-30aa-40ce-a45a-830b90c4cd42
-Content-Length: 0
-</code></pre>
-
-<h3 id="delete-tenant">Delete Tenant</h3>
-
-<ul>
-<li>URI: <code>/v1/tenants/${tenantId}</code></li>
-<li>Method: <code>DELETE</code></li>
-<li>Status Codes:
-
-<ul>
-<li>204 (No Content): The tenant with the given identifier has been deleted.</li>
-<li>404 (Not Found): The request could not be processed because no tenant with the given identifier exists.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<pre><code class="language-sh">curl -i -X DELETE http://localhost:28080/v1/tenants/tenantMqttAdapter
-
-HTTP/1.1 204 No Content
-Content-Length: 0
-</code></pre>
-
-<h2 id="managing-device-registration-information">Managing Device Registration Information</h2>
-
-<p>The following sections describe the resources representing the operations of the <a href="/hono/docs/api/device-registration/">Device Registration API</a> and how they can be used to manage device registration information.
-Please refer to the <a href="/hono/docs/api/management/">Device Registry HTTP API</a> for the specific elements that are explained in detail there.</p>
-
-<h3 id="register-device">Register Device</h3>
-
-<ul>
-<li>URI: <code>/v1/devices/${tenantId}/${deviceId}</code></li>
-<li>Method: <code>POST</code></li>
-<li>Headers:
-
-<ul>
-<li>(required) <code>Content-Type</code>: <code>application/json</code></li>
-</ul></li>
-<li>Request Body:
-
-<ul>
-<li>(Optional) A JSON object as specified by <a href="/hono/docs/api/management/">Device schema</a> of the HTTP API specification.</li>
-</ul></li>
-<li>Status Codes:
-
-<ul>
-<li>201 (Created): Device has been registered successfully under resource indicated by <code>Location</code> header.</li>
-<li>400 (Bad Request): Device has not been registered because the request was malformed, e .g. a required header is missing (the body may contain hints regarding the problem).</li>
-<li>409 (Conflict): There already exists a device with the given ID. The request has not been processed.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<p>The following command registers a device with ID <code>4711</code> for tenant <code>DEFAULT_TENANT</code></p>
-
-<pre><code class="language-sh">curl -i -X POST -H 'Content-Type: application/json' --data-binary '{
-    &quot;ext&quot;: {
-        &quot;ep&quot;: &quot;IMEI4711&quot;
-    }
-}' http://localhost:28080/v1/devices/DEFAULT_TENANT/4711
-</code></pre>
-
-<p>The response will contain a <code>Location</code> header containing the resource path created for the device. In this example it will look
-like this:</p>
-
-<pre><code class="language-sh">HTTP/1.1 201 Created
-Location: /v1/devices/DEFAULT_TENANT/4711
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4
-Content-Type: application/json; charset=utf-8
-
-{&quot;id&quot;: &quot;4711&quot;}
-</code></pre>
-
-<p><strong>NB</strong> A device can be created without specifying a device identifier. The device registry will generate a device identifier:</p>
-
-<pre><code class="language-sh">curl -i -X POST http://localhost:28080/v1/devices/DEFAULT_TENANT
-
-HTTP/1.1 201 Created
-Etag: 0d615bcd-0825-44d9-9ef5-54a7b12165d8
-location: /v1/devices/DEFAULT_TENANT/98d25103-d49d-44b0-bdd0-0de84743c522
-content-type: application/json; charset=utf-8
-content-length: 45
-
-{&quot;id&quot;:&quot;98d25103-d49d-44b0-bdd0-0de84743c522&quot;}
-</code></pre>
-
-<h3 id="read-device">Read Device</h3>
-
-<ul>
-<li>URI: <code>/v1/devices/${tenantId}/${deviceId}</code></li>
-<li>Method: <code>GET</code></li>
-<li>Status Codes:
-
-<ul>
-<li>200 (OK): A device with the given identifier has been found. The response body contains the registration information as specified by <a href="/hono/docs/api/management/">Device schema</a> of the HTTP API specification.</li>
-<li>404 (Not Found): No device with the given identifier is registered for the given tenant.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<p>The following command retrieves registration data for device <code>4711</code>:</p>
-
-<pre><code class="language-sh">curl -i http://localhost:28080/v1/devices/DEFAULT_TENANT/4711
-
-HTTP/1.1 200 OK
-Content-Type: application/json; charset=utf-8
-
-{
-    &quot;enabled&quot;: true,
-    &quot;ext&quot;: {
-        &quot;ep&quot;: &quot;IMEI4711&quot;
-    }
-}
-</code></pre>
-
-<h3 id="update-device">Update Device</h3>
-
-<ul>
-<li>URI: <code>/devices/v1/${tenantId}/${deviceId}</code></li>
-<li>Method: <code>PUT</code></li>
-<li>Headers:
-
-<ul>
-<li>(required) <code>Content-Type</code>: <code>application/json</code></li>
-</ul></li>
-<li>Parameters (encoded as a JSON object in the request body):</li>
-<li>Request Body:
-
-<ul>
-<li>(required) A JSON object as specified by <a href="/hono/docs/api/management/">Device schema</a> of the HTTP API specification. All existing registration information will be replaced by the data provided in the object.</li>
-</ul></li>
-<li>Status Codes:
-
-<ul>
-<li>204 (No Content): Device registration data has been updated.</li>
-<li>400 (Bad Request): Device registration has not been updated because the request was malformed, e .g. a required header is missing (the body may contain hints regarding the problem).</li>
-<li>404 (Not Found): No device with the given identifier is registered for the given tenant.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<pre><code class="language-sh">curl -i -X PUT -H 'Content-Type: application/json' --data-binary '{
-    &quot;ext&quot;: {
-        &quot;ep&quot;: &quot;IMEI4711&quot;,
-        &quot;psk-id&quot;: &quot;psk4711&quot;
-    }
-}' http://localhost:28080/v1/devices/DEFAULT_TENANT/4711
-
-HTTP/1.1 204 No Content
-Content-Length: 0
-</code></pre>
-
-<h3 id="delete-device">Delete Device</h3>
-
-<ul>
-<li>URI: <code>/v1/devices/${tenantId}/${deviceId}</code></li>
-<li>Method: <code>DELETE</code></li>
-<li>Status Codes:
-
-<ul>
-<li>204 (No Content): Device registration has been deleted.</li>
-<li>404 (Not Found): No device with the given identifier is registered for the given tenant.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<pre><code class="language-sh">curl -i -X DELETE http://localhost:28080/v1/devices/DEFAULT_TENANT/4711
-
-HTTP/1.1 204 No Content
-Content-Length: 0
-</code></pre>
+<p>Please refer to the <a href="/hono/docs/api/management/#devices">Device Registry Management API</a> for information about managing devices.</p>
 
 <h2 id="managing-credentials">Managing Credentials</h2>
 
-<p>The following sections describe the resources representing the operations of the Credentials API and how they can be used to manage credentials for devices.
-Please refer to the <a href="/hono/docs/api/management/">Device Registry HTTP API</a> for the specific elements that are explained in detail there.</p>
+<p>Please refer to the <a href="/hono/docs/api/management/#credentials">Device Registry Management API</a> for information about managing credentials.</p>
 
-<h3 id="update-credentials-for-a-device">Update Credentials for a Device</h3>
-
-<ul>
-<li>URI: <code>/v1/credentials/${tenantId}/${deviceId}</code></li>
-<li>Method: <code>PUT</code></li>
-<li>Request Headers:
-
-<ul>
-<li>(required) <code>Content-Type</code>: <code>application/json</code> (no other type supported)</li>
-</ul></li>
-<li>Request Body:
-
-<ul>
-<li>(required) A JSON object as specified by <a href="/hono/docs/api/management/">Credentials schema</a> of the HTTP API specification.</li>
-</ul></li>
-<li>Status Codes:
-
-<ul>
-<li>204 (No Content): Credentials have been updated successfully.</li>
-<li>400 (Bad Request): The credentials have not been added because the request was malformed, e .g. because the payload did not contain required values. The response body may contain hints regarding the cause of the problem.</li>
-</ul></li>
-<li>Response Headers:
-
-<ul>
-<li><code>ETag</code>: Version of the resource</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<p>The following command adds some <code>hashed-password</code> credentials from a given plain text password for device <code>4710</code> using authentication identifier <code>sensor10</code>:</p>
-
-<pre><code class="language-sh">curl -i -X PUT -H 'Content-Type: application/json' --data-binary '[{
-  &quot;type&quot;: &quot;hashed-password&quot;,
-  &quot;auth-id&quot;: &quot;sensor10&quot;,
-  &quot;secrets&quot;: [{
-      &quot;pwd-plain&quot;: &quot;mylittlesecret&quot;
-  }]
-}]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4710
-  
-HTTP/1.1 204 No Content
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4x
-</code></pre>
-
-<p>This uses a convenient option which lets the Device Registry do the hashing of the password. The following command retrieves the credentials that are stored by the Device Registry as a result of the command above:</p>
-
-<pre><code class="language-sh">curl -i http://localhost:28080/v1/credentials/DEFAULT_TENANT/4710
-
-HTTP/1.1 200 OK
-Content-Type: application/json; charset=utf-8
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4x
-
-[{
-  &quot;type&quot;: &quot;hashed-password&quot;,
-  &quot;auth-id&quot;: &quot;sensor10&quot;,
-  &quot;enabled&quot;: true,
-  &quot;secrets&quot;: [
-    {
-      &quot;id&quot;: &quot;349556ea-4902-47c7-beb0-1009ab693fb4&quot;
-    }
-  ]
-}]
-</code></pre>
-
-<p>The above result does not contain <code>pwd_hash</code> and <code>hash_function</code> of the secret, as these values are confidential.</p>
-
-<p>The following commands set some <code>hashed-password</code> credentials for device <code>4720</code> using authentication identifier <code>sensor20</code>:</p>
-
-<pre><code class="language-sh">curl -i -X PUT -H 'Content-Type: application/json' --data-binary '[{
-    &quot;type&quot;: &quot;hashed-password&quot;,
-    &quot;auth-id&quot;: &quot;sensor20&quot;,
-    &quot;secrets&quot;: [{
-        &quot;pwd-plain&quot;: &quot;mylittlesecret&quot;
-    }]
-  }]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720
-
-HTTP/1.1 204 No Content
-ETag: 02c99fb5-af8c-409f-8520-b405e224b27f
-</code></pre>
-
-<p>The following command adds an expiration date to the <code>hashed-password</code> credentials for authentication identifier <code>sensor20</code>:</p>
-
-<pre><code class="language-sh">curl -i -X PUT -H 'Content-Type: application/json' --data-binary '{
-    &quot;device-id&quot;: &quot;4720&quot;,
-    &quot;type&quot;: &quot;hashed-password&quot;,
-    &quot;auth-id&quot;: &quot;sensor20&quot;,
-    &quot;secrets&quot;: [{
-        &quot;pwd-plain&quot;: &quot;mylittlesecret&quot;,
-        &quot;not-after&quot;: &quot;2018-01-01T00:00:00+01:00&quot;
-    }]
-}' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720
-
-HTTP/1.1 204 No Content
-ETag: becc93d7-ab0f-48ec-ad26-debdf339cbf4x
-</code></pre>
-
-<p>Multiple credentials of different type can be registered for the same authentication identifier.
-The following commands add <code>psk</code> credentials for the same device <code>4720</code> using authentication identifier <code>sensor20</code>:</p>
-
-<pre><code class="language-sh">SHARED_KEY=$(echo -n &quot;TheSharedKey&quot; | base64 -w 0)
-curl -i -X PUT -H 'Content-Type: application/json' --data-binary '[
-{
-    &quot;type&quot;: &quot;hashed-password&quot;,
-    &quot;auth-id&quot;: &quot;sensor20&quot;,
-    &quot;secrets&quot;: [{
-        &quot;pwd-plain&quot;: &quot;mylittlesecret&quot;
-    }]
-},
-{
-   &quot;device-id&quot;: &quot;4720&quot;,
-   &quot;type&quot;: &quot;psk&quot;,
-   &quot;auth-id&quot;: &quot;sensor20&quot;,
-   &quot;secrets&quot;: [{
-     &quot;key&quot;: &quot;'$SHARED_KEY'&quot;
-     }]
-  }]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720
-
-HTTP/1.1 204 No Content
-ETag: 122c971a-505a-4336-8f7d-640360e909bc
-</code></pre>
-
-<p>The following command deletes all credentials for device <code>4710</code>:</p>
-
-<pre><code class="language-sh">curl -i -X PUT -H 'Content-Type: application/json' --data-binary '[]' http://localhost:28080/v1/credentials/DEFAULT_TENANT/4710
-
-HTTP/1.1 204 No Content
-ETag: d383ba4d-1853-4d03-b322-b7ff5af05ae2
-</code></pre>
-
-<h3 id="get-all-credentials-for-a-device">Get all Credentials for a Device</h3>
-
-<ul>
-<li>URI: <code>/v1/credentials/${tenantId}/${deviceId}</code></li>
-<li>Method: <code>GET</code></li>
-<li>Status Codes:
-
-<ul>
-<li>200 (OK): Credentials for the device have been found, body contains the credentials. The response body contains the registration information as specified by <a href="/hono/docs/api/management/">Credentials schema</a> of the HTTP API specification.</li>
-<li>404 (Not Found): No credentials for the device are registered.</li>
-</ul></li>
-</ul>
-
-<p><strong>Example</strong></p>
-
-<p>The following command retrieves credentials metadata for device <code>4720</code>:</p>
-
-<pre><code class="language-sh">curl -i http://localhost:28080/v1/credentials/DEFAULT_TENANT/4720
-
-HTTP/1.1 200 OK
-Content-Type: application/json; charset=utf-8
-ETag: f3449b77-2c84-4b09-8d04-2b305876e0cb
-
-{[
-    {
-        &quot;auth-id&quot;: &quot;sensor20&quot;,
-        &quot;enabled&quot;: true,
-        &quot;secrets&quot;: [
-            {
-                &quot;id&quot;: &quot;d383ba4d-1853-4d03-b322-b7ff5af05ae2&quot;
-                &quot;not-after&quot;: &quot;2020-02-1T00:00:00+01:00&quot;
-            },
-            {
-                &quot;id&quot;: &quot;46810d5c-133e-4c1c-994d-ed7745516b8e&quot;
-                &quot;not-before&quot;: &quot;2020-01-01T00:00:00+01:00&quot;
-            }
-        ],
-        &quot;type&quot;: &quot;hashed-password&quot;
-    },
-    {
-        &quot;auth-id&quot;: &quot;sensor20&quot;,
-        &quot;enabled&quot;: true,
-        &quot;secrets&quot;: [
-            {
-                &quot;key&quot;: &quot;VGhlU2hhcmVkS2V5&quot;
-            }
-        ],
-        &quot;type&quot;: &quot;psk&quot;
-    }
-]}
-</code></pre>
 
 <footer class=" footline" >
 	
@@ -2322,6 +1845,22 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2530,6 +2069,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2932,20 +2503,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/user-guide/mqtt-adapter/index.html b/docs/user-guide/mqtt-adapter/index.html
index fdac290..627559d 100644
--- a/docs/user-guide/mqtt-adapter/index.html
+++ b/docs/user-guide/mqtt-adapter/index.html
@@ -21,19 +21,19 @@
     <title>MQTT Adapter :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/mqtt-adapter/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/mqtt-adapter/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/mqtt-adapter/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/mqtt-adapter/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/mqtt-adapter/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/mqtt-adapter/">dev</option>
@@ -1456,7 +1539,7 @@
 <li><a href="#connection-duration-limits">Connection Duration Limits</a></li>
 <li><a href="#message-limits">Message Limits</a></li>
 </ul></li>
-<li><a href="#connection-event">Connection Event</a></li>
+<li><a href="#connection-events">Connection Events</a></li>
 <li><a href="#publishing-telemetry-data">Publishing Telemetry Data</a></li>
 <li><a href="#publish-telemetry-data-authenticated-device">Publish Telemetry Data (authenticated Device)</a></li>
 <li><a href="#publish-telemetry-data-unauthenticated-device">Publish Telemetry Data (unauthenticated Device)</a></li>
@@ -1474,6 +1557,7 @@
 <li><a href="#sending-a-response-to-a-command-unauthenticated-device">Sending a Response to a Command (unauthenticated Device)</a></li>
 <li><a href="#sending-a-response-to-a-command-authenticated-gateway">Sending a Response to a Command (authenticated Gateway)</a></li>
 </ul></li>
+<li><a href="#custom-message-mapping">Custom Message Mapping</a></li>
 <li><a href="#downstream-meta-data">Downstream Meta Data</a>
 <ul>
 <li><a href="#event-message-time-to-live">Event Message Time-to-live</a></li>
@@ -1513,28 +1597,39 @@
 
 <h2 id="authentication">Authentication</h2>
 
-<p>The MQTT adapter by default requires clients (devices or gateway components) to authenticate during connection establishment. The adapter supports both the authentication based on the username/password provided in an MQTT CONNECT packet as well as client certificate based authentication as part of a TLS handshake for that purpose.</p>
+<p>The MQTT adapter by default requires clients (devices or gateway components) to authenticate during connection establishment.
+The adapter supports both the authentication based on the username/password provided in an MQTT CONNECT packet as well as client
+certificate based authentication as part of a TLS handshake for that purpose.</p>
 
 <p>The adapter tries to authenticate the device using these mechanisms in the following order</p>
 
 <h3 id="client-certificate">Client Certificate</h3>
 
-<p>When a device uses a client certificate for authentication during the TLS handshake, the adapter tries to determine the tenant that the device belongs to based on the <em>issuer DN</em> contained in the certificate.
-In order for the lookup to succeed, the tenant&rsquo;s trust anchor needs to be configured by means of registering the <a href="/hono/docs/api/tenant/#tenant-information-format">trusted certificate authority</a>.
-The device&rsquo;s client certificate will then be validated using the registered trust anchor, thus implicitly establishing the tenant that the device belongs to.
-In a second step, the adapter uses the Credentials API&rsquo;s <em>get</em> operation to retrieve the credentials on record, including the client certificate&rsquo;s <em>subject DN</em> as the <em>auth-id</em>, <code>x509-cert</code> as the <em>type</em> of secret and the MQTT client identifier as <em>client-id</em> in the request payload.</p>
+<p>When a device uses a client certificate for authentication during the TLS handshake, the adapter tries to determine the tenant
+that the device belongs to based on the <em>issuer DN</em> contained in the certificate.
+In order for the lookup to succeed, the tenant&rsquo;s trust anchor needs to be configured by means of registering the
+<a href="/hono/docs/api/tenant/#tenant-information-format">trusted certificate authority</a>. The device&rsquo;s client certificate will then be
+validated using the registered trust anchor, thus implicitly establishing the tenant that the device belongs to.
+In a second step, the adapter uses the Credentials API&rsquo;s <em>get</em> operation to retrieve the credentials on record, including the client
+certificate&rsquo;s <em>subject DN</em> as the <em>auth-id</em>, <code>x509-cert</code> as the <em>type</em> of secret and the MQTT client identifier as <em>client-id</em> in the
+request payload.</p>
 
 <p><strong>NB</strong> The adapter needs to be <a href="/hono/docs/admin-guide/secure_communication/#mqtt-adapter">configured for TLS</a> in order to support this mechanism.</p>
 
 <h3 id="username-password">Username/Password</h3>
 
-<p>When a device wants to authenticate using this mechanism, it needs to provide a <em>username</em> and a <em>password</em> in the MQTT <em>CONNECT</em> packet it sends in order to initiate the connection. The <em>username</em> must have the form <em>auth-id@tenant</em>, e.g. <code>sensor1@DEFAULT_TENANT</code>.
-The adapter verifies the credentials provided by the client against the credentials that the <a href="/hono/docs/admin-guide/common-config/#credentials-service-connection-configuration">configured Credentials service</a> has on record for the client.
-The adapter uses the Credentials API&rsquo;s <em>get</em> operation to retrieve the credentials on record, including the <em>tenant</em> and <em>auth-id</em> provided by the client in the <em>username</em>, <code>hashed-password</code> as the <em>type</em> of secret and the MQTT client identifier as <em>client-id</em> in the request payload.</p>
+<p>When a device wants to authenticate using this mechanism, it needs to provide a <em>username</em> and a <em>password</em> in the MQTT <em>CONNECT</em> packet
+it sends in order to initiate the connection. The <em>username</em> must have the form <em>auth-id@tenant</em>, e.g. <code>sensor1@DEFAULT_TENANT</code>.
+The adapter verifies the credentials provided by the client against the credentials that the
+<a href="/hono/docs/admin-guide/common-config/#credentials-service-connection-configuration">configured Credentials service</a> has on record for the client.
+The adapter uses the Credentials API&rsquo;s <em>get</em> operation to retrieve the credentials on record, including the <em>tenant</em> and <em>auth-id</em> provided
+by the client in the <em>username</em>, <code>hashed-password</code> as the <em>type</em> of secret and the MQTT client identifier as <em>client-id</em> in the request payload.</p>
 
-<p>The examples below refer to devices <code>4711</code> and <code>gw-1</code> of tenant <code>DEFAULT_TENANT</code> using <em>auth-ids</em> <code>sensor1</code> and <code>gw1</code> and corresponding passwords. The example deployment as described in the <a href="/hono/docs/deployment/">Deployment Guides</a> comes pre-configured with the corresponding entities in its device registry component.</p>
+<p>The examples below refer to devices <code>4711</code> and <code>gw-1</code> of tenant <code>DEFAULT_TENANT</code> using <em>auth-ids</em> <code>sensor1</code> and <code>gw1</code> and corresponding passwords.
+The example deployment as described in the <a href="/hono/docs/deployment/">Deployment Guides</a> comes pre-configured with the corresponding entities in its device registry component.</p>
 
-<p><strong>NB</strong> There is a subtle difference between the <em>device identifier</em> (<em>device-id</em>) and the <em>auth-id</em> a device uses for authentication. See <a href="/hono/docs/concepts/device-identity/">Device Identity</a> for a discussion of the concepts.</p>
+<p><strong>NB</strong> There is a subtle difference between the <em>device identifier</em> (<em>device-id</em>) and the <em>auth-id</em> a device uses for authentication.
+See <a href="/hono/docs/concepts/device-identity/">Device Identity</a> for a discussion of the concepts.</p>
 
 <h2 id="resource-limit-checks">Resource Limit Checks</h2>
 
@@ -1567,9 +1662,13 @@
 
 <p>if the <a href="/hono/docs/concepts/resource-limits/">message limit</a> that has been configured for the device’s tenant is exceeded.</p>
 
-<h2 id="connection-event">Connection Event</h2>
+<h2 id="connection-events">Connection Events</h2>
 
-<p>The MQTT Adapter can send a <a href="/hono/docs/api/event/#connection-event">Connection Event</a> once the connection with a device has been successfully established or ended. Note that this requires the <a href="/hono/docs/admin-guide/mqtt-adapter-config/#service-configuration"><code>HONO_CONNECTION_EVENTS_PRODUCER</code></a> configuration property to be explicitly set to <code>events</code>.</p>
+<p>The adapter can emit <a href="/hono/docs/api/event/#connection-event">Connection Events</a> for client connections being established and/or terminated.
+Please refer to the <a href="/hono/docs/admin-guide/common-config/#connection-event-producer-configuration">common configuration options</a>
+for details regarding how to enable this behavior.</p>
+
+<p>The adapter includes the <em>client identifier</em> from the client&rsquo;s MQTT CONNECT packet as the Connection Event&rsquo;s <em>remote-id</em>.</p>
 
 <h2 id="publishing-telemetry-data">Publishing Telemetry Data</h2>
 
@@ -1852,7 +1951,7 @@
 
 <h3 id="receiving-commands-authenticated-gateway">Receiving Commands (authenticated Gateway)</h3>
 
-<p><em>Gateway</em> components can receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like <a href="https://www.sigfox.com">SigFox</a> or <a href="https://lora-alliance.org/">LoRa</a>. Corresponding devices have to be configured so that they can be used with a gateway. See <a href="/hono/docs/admin-guide/device-registry-config/#configuring-gateway-devices">Configuring Gateway Devices</a> for details.</p>
+<p><em>Gateway</em> components can receive commands for devices which do not connect to a protocol adapter directly but instead are connected to the gateway, e.g. using some low-bandwidth radio based technology like <a href="https://www.sigfox.com">SigFox</a> or <a href="https://lora-alliance.org/">LoRa</a>. Corresponding devices have to be configured so that they can be used with a gateway. See <a href="/hono/docs/admin-guide/file-based-device-registry-config/#configuring-gateway-devices">Configuring Gateway Devices</a> for details.</p>
 
 <p>An authenticated gateway MUST use the topic filter <code>command//+/req/#</code> to subscribe to commands for all devices in whose behalf it acts.</p>
 
@@ -1937,6 +2036,45 @@
 <pre><code class="language-sh">mosquitto_pub -u 'gw@DEFAULT_TENANT' -P gw-secret -t command//4711/res/1010f8ab0b53-bd96-4d99-9d9c-56b868474a6a/200 -m '{&quot;lumen&quot;: 200}'
 </code></pre>
 
+<h2 id="custom-message-mapping">Custom Message Mapping</h2>
+
+<p>This protocol adapter supports transformation of messages that have been uploaded by devices before they get forwarded to downstream consumers.</p>
+
+<div class="alert alert-notice">
+    <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Experimental</h4>
+    <div>This is an experimental feature. The names of the configuration properties, potential values and the overall functionality are therefore
+subject to change without prior notice.</div>
+</div>
+
+
+<p>This feature is useful in scenarios where devices are connected to the adapter via a gateway but the gateway is not able to include
+the device ID in the topic that the gateway publishes data to. The gateway will use the plain <code>telemetry</code> or <code>event</code> topics in this case.
+The message payload will usually contain the identifier of the device that the data originates from.</p>
+
+<p>The same functionality can also be used to transform the payload of messages uploaded by a device. This can be used for example to
+transform binary encoded data into a JSON document which can be consumed more easily by downstream consumers.</p>
+
+<p>The mechanism works as follows:
+1. A client uploads a message to the MQTT adapter.
+1. The adapter invokes the Device Registration service&rsquo;s <em>assert Registration</em> operation using either
+   the authenticated device&rsquo;s identifier, if the topic does not contain a device ID, or the device ID from the
+   topic.
+1. If the assertion succeeds, the adapter creates the downstream message using the original message&rsquo;s payload and
+   the asserted device ID as the origin device.
+1. If the response payload contains a value for the <em>mapper</em> property, the adapter tries to find a <em>mapper endpoint</em> configuration
+   for the given value. If a mapper endpoint with a matching name has been configured for the adapter,
+   1. the adapter sends an HTTP request to the endpoint which contains the original message&rsquo;s payload in the request body.
+   1. If the response body is not empty, it is used as the downstream message&rsquo;s payload.
+   1. If the response contains a <em>device_id</em> header and its value is different from the original device ID, then the adapter
+      invokes the <em>assert Registration</em> operation again, this time using the mapped device ID instead of the original device ID.
+      If the assertion succeeds, the adapter uses the asserted (mapped) device ID for the downstream message.
+1. The adapter forwards the downstream message.</p>
+
+<p>Please refer to the <a href="/hono/docs/api/management/#/devices/createDeviceRegistration">Device Registry Management API</a>
+for how to register a <em>mapper</em> for a device.
+Please refer to the <a href="/hono/docs/admin-guide/mqtt-adapter-config/#custom-message-mapping">MQTT Adapter Admin Guide</a>
+for how to configure custom mapper endpoints.</p>
+
 <h2 id="downstream-meta-data">Downstream Meta Data</h2>
 
 <p>The adapter includes the following meta data in messages being sent downstream:</p>
@@ -1975,14 +2113,16 @@
 
 <tr>
 <td align="left"><em>x-opt-retain</em></td>
-<td align="left">* <em>message-annotations</em></td>
+<td align="left"><em>message-annotations</em></td>
 <td align="left"><em>boolean</em></td>
 <td align="left">Contains <code>true</code> if the device has published an event or telemetry message with its <em>retain</em> flag set to <code>1</code></td>
 </tr>
 </tbody>
 </table>
 
-<p>The adapter also considers <em>defaults</em> registered for the device at either the <a href="/hono/docs/api/tenant/#tenant-information-format">tenant</a> or the <a href="/hono/docs/api/device-registration/#assert-device-registration">device level</a>. The values of the default properties are determined as follows:</p>
+<p>The adapter also considers <em>defaults</em> registered for the device at either the <a href="/hono/docs/api/tenant/#tenant-information-format">tenant</a>
+or the <a href="/hono/docs/api/device-registration/#assert-device-registration">device level</a>.
+The values of the default properties are determined as follows:</p>
 
 <ol>
 <li>If the message already contains a non-empty property of the same name, the value if unchanged.</li>
@@ -2259,6 +2399,22 @@
             
                 
                     
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
                     
                 
                 
@@ -2562,6 +2718,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2964,20 +3152,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/docs/user-guide/sigfox-adapter/index.html b/docs/user-guide/sigfox-adapter/index.html
index 85a6027..69fbc80 100644
--- a/docs/user-guide/sigfox-adapter/index.html
+++ b/docs/user-guide/sigfox-adapter/index.html
@@ -21,19 +21,19 @@
     <title>Sigfox Adapter :: Eclipse Hono&trade;</title>
 
     
-    <link href="/hono/docs/css/nucleus.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/fontawesome-all.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hybrid.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/featherlight.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/auto-complete.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/theme.css?1595208214" rel="stylesheet">
-    <link href="/hono/docs/css/hugo-theme.css?1595208214" rel="stylesheet">
+    <link href="/hono/docs/css/nucleus.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/fontawesome-all.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hybrid.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/featherlight.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/perfect-scrollbar.min.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/auto-complete.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/theme.css?1595294628" rel="stylesheet">
+    <link href="/hono/docs/css/hugo-theme.css?1595294628" rel="stylesheet">
     
-      <link href="/hono/docs/css/theme-hono.css?1595208214" rel="stylesheet">
+      <link href="/hono/docs/css/theme-hono.css?1595294628" rel="stylesheet">
     
 
-    <script src="/hono/docs/js/jquery-2.x.min.js?1595208214"></script>
+    <script src="/hono/docs/js/jquery-2.x.min.js?1595294628"></script>
 
     <style type="text/css">
       :root #header + #content > #left > #rlblock_left{
@@ -83,14 +83,14 @@
     <span data-search-clear=""><i class="fas fa-times"></i></span>
 </div>
 
-<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595208214"></script>
-<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1595294628"></script>
+<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1595294628"></script>
 <script type="text/javascript">
     
         var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/";
     
 </script>
-<script type="text/javascript" src="/hono/docs/js/search.js?1595208214"></script>
+<script type="text/javascript" src="/hono/docs/js/search.js?1595294628"></script>
 
     
   </div>
@@ -315,9 +315,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/user-guide/device-registry/" title="Device Registry" class="dd-item ">
-        <a href="/hono/docs/user-guide/device-registry/">
-        Device Registry
+      <li data-nav-id="/hono/docs/user-guide/mongodb-based-device-registry/" title="MongoDB Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/mongodb-based-device-registry/">
+        MongoDB Based Device Registry
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/user-guide/file-based-device-registry/" title="File Based Device Registry" class="dd-item ">
+        <a href="/hono/docs/user-guide/file-based-device-registry/">
+        File Based Device Registry
         
         </a>
     </li>
@@ -537,9 +556,28 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/device-registry-config/">
-        Device Registry Configuration
+      <li data-nav-id="/hono/docs/admin-guide/mongodb-device-registry-config/" title="MongoDB Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mongodb-device-registry-config/">
+        MongoDB Based Device Registry Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
+      <li data-nav-id="/hono/docs/admin-guide/file-based-device-registry-config/" title="File Based Device Registry Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/file-based-device-registry-config/">
+        File Based Device Registry Configuration
         
         </a>
     </li>
@@ -594,6 +632,25 @@
  
   
     
+      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
+        MQTT Adapter Configuration
+        
+        </a>
+    </li>
+     
+  
+ 
+
+            
+          
+            
+            
+
+
+ 
+  
+    
       <li data-nav-id="/hono/docs/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
         <a href="/hono/docs/admin-guide/amqp-adapter-config/">
         AMQP Adapter Configuration
@@ -613,9 +670,9 @@
  
   
     
-      <li data-nav-id="/hono/docs/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
-        <a href="/hono/docs/admin-guide/mqtt-adapter-config/">
-        MQTT Adapter Configuration
+      <li data-nav-id="/hono/docs/admin-guide/coap-adapter-config/" title="CoAP Adapter Configuration" class="dd-item ">
+        <a href="/hono/docs/admin-guide/coap-adapter-config/">
+        CoAP Adapter Configuration
         
         </a>
     </li>
@@ -1277,7 +1334,27 @@
                   
                     
                     
-                      <option id="stable" value="/hono/docs/user-guide/sigfox-adapter/" selected>stable (1.2)</option>
+                      <option id="stable" value="/hono/docs/user-guide/sigfox-adapter/" selected>stable (1.3)</option>
+                    
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+                  
+              
+          
+              
+              
+                  
+              
+                  
+                    
+                    
+                      <option id="1.2" value="/hono/docs/1.2/user-guide/sigfox-adapter/">1.2</option>
                     
                   
               
@@ -1293,6 +1370,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.1" value="/hono/docs/1.1/user-guide/sigfox-adapter/">1.1</option>
@@ -1311,6 +1390,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="1.0" value="/hono/docs/1.0/user-guide/sigfox-adapter/">1.0</option>
@@ -1329,6 +1410,8 @@
                   
               
                   
+              
+                  
                     
                     
                       <option id="dev" value="/hono/docs/dev/user-guide/sigfox-adapter/">dev</option>
@@ -1913,6 +1996,22 @@
             
                 
                     
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
                     
                 
                 
@@ -2152,6 +2251,38 @@
             
         
                     
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
+                        
+            
+            
+                
+                    
+                
+                
+
+                    
+                    
+                    
+
+                    
+            
+        
+                    
             
         
                     
@@ -2554,20 +2685,20 @@
     <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
       <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
     </div>
-    <script src="/hono/docs/js/clipboard.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595208214"></script>
-    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595208214"></script>
-    <script src="/hono/docs/js/jquery.sticky.js?1595208214"></script>
-    <script src="/hono/docs/js/featherlight.min.js?1595208214"></script>
-    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595208214"></script>
-    <script src="/hono/docs/js/highlight.pack.js?1595208214"></script>
+    <script src="/hono/docs/js/clipboard.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.min.js?1595294628"></script>
+    <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1595294628"></script>
+    <script src="/hono/docs/js/jquery.sticky.js?1595294628"></script>
+    <script src="/hono/docs/js/featherlight.min.js?1595294628"></script>
+    <script src="/hono/docs/js/html5shiv-printshiv.min.js?1595294628"></script>
+    <script src="/hono/docs/js/highlight.pack.js?1595294628"></script>
     <script>hljs.initHighlightingOnLoad();</script>
-    <script src="/hono/docs/js/modernizr.custom.71422.js?1595208214"></script>
-    <script src="/hono/docs/js/learn.js?1595208214"></script>
-    <script src="/hono/docs/js/hugo-learn.js?1595208214"></script>
+    <script src="/hono/docs/js/modernizr.custom.71422.js?1595294628"></script>
+    <script src="/hono/docs/js/learn.js?1595294628"></script>
+    <script src="/hono/docs/js/hugo-learn.js?1595294628"></script>
 
-    <link href="/hono/docs/mermaid/mermaid.css?1595208214" type="text/css" rel="stylesheet" />
-    <script src="/hono/docs/mermaid/mermaid.js?1595208214"></script>
+    <link href="/hono/docs/mermaid/mermaid.css?1595294628" type="text/css" rel="stylesheet" />
+    <script src="/hono/docs/mermaid/mermaid.js?1595294628"></script>
     <script>
         mermaid.initialize({ startOnLoad: true });
     </script>
diff --git a/downloads/index.html b/downloads/index.html
index 0338fc3..d5db8b5 100644
--- a/downloads/index.html
+++ b/downloads/index.html
@@ -251,7 +251,7 @@
 <p>A Java based command line client for consuming telemetry data and events from Hono is available for download from</p>
 
 <ul>
-<li><a href="https://www.eclipse.org/downloads/download.php?file=/hono/hono-cli-1.2.4-exec.jar">Eclipse Hono 1.2.4 Command Line Client</a></li>
+<li><a href="https://www.eclipse.org/downloads/download.php?file=/hono/hono-cli-1.3.0-exec.jar">Eclipse Hono 1.3.0 Command Line Client</a></li>
 </ul>
 
 <p>The client requires a Java 11 runtime environment to run.</p>
@@ -260,22 +260,6 @@
 ">Admin Guide</a> for details regarding the command
 line options that the client supports.</p>
 
-<h3 id="milestones">Milestones</h3>
-
-<p>The newest features and bug fixes are available in <em>milestones</em> that are published every 4 -6 weeks.
-Please note that these milestones represent the latest <em>state of development</em> which also means that APIs or features may
-change from one milestone to the other. Milestones are mainly intended for testing purposes and should generally not
-be used in a production environment.</p>
-
-<ul>
-<li><a href="https://www.eclipse.org/downloads/download.php?file=/hono/hono-cli-1.3.0-M3-exec.jar">Eclipse Hono 1.3.0-M3 Command Line Client</a></li>
-<li><a href="https://www.eclipse.org/downloads/download.php?file=/hono/hono-cli-1.3.0-M2-exec.jar">Eclipse Hono 1.3.0-M2 Command Line Client</a></li>
-<li><a href="https://www.eclipse.org/downloads/download.php?file=/hono/hono-cli-1.3.0-M1-exec.jar">Eclipse Hono 1.3.0-M1 Command Line Client</a></li>
-</ul>
-
-<p>Please refer to the <em>Using specific Container Images</em> section of <a href="https://github.com/eclipse/packages/tree/master/charts/hono">Hono&rsquo;s Helm chart</a>
-for information regarding the installation of milestone container images.</p>
-
 <h2 id="source-code">Source Code</h2>
 
 <p>The source code can be cloned or downloaded from <a href="https://github.com/eclipse/hono">Hono&rsquo;s GitHub repository</a>.
@@ -289,6 +273,7 @@
 <h2 id="previous-versions">Previous versions</h2>
 
 <ul>
+<li><a href="https://www.eclipse.org/downloads/download.php?file=/hono/hono-cli-1.2.4-exec.jar">Eclipse Hono 1.2.4 Command Line Client</a></li>
 <li><a href="https://www.eclipse.org/downloads/download.php?file=/hono/hono-cli-1.2.3-exec.jar">Eclipse Hono 1.2.3 Command Line Client</a></li>
 <li><a href="https://www.eclipse.org/downloads/download.php?file=/hono/hono-cli-1.2.2-exec.jar">Eclipse Hono 1.2.2 Command Line Client</a></li>
 <li><a href="https://www.eclipse.org/downloads/download.php?file=/hono/hono-cli-1.2.1-exec.jar">Eclipse Hono 1.2.1 Command Line Client</a></li>
diff --git a/index.xml b/index.xml
index 979a1fd..e3c26d7 100644
--- a/index.xml
+++ b/index.xml
@@ -92,7 +92,7 @@
       <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
       
       <guid>https://www.eclipse.org/hono/release-notes/</guid>
-      <description>1.3.0 (not yet released) New Features  The LoraWAN protocol adapter has been extended with support for the ChirpStack provider. Hono&amp;rsquo;s integration tests can now be run with a Jaeger back end in order to collect tracing information. The AMQP 1.0 event message based Connection Event producer now sets a TTL on the event messages it produces. The TTL is the max TTL configured at the tenant level. A new Device Registry implementation based on MongoDB database is now available in Hono.</description>
+      <description>1.3.0 New Features  The LoraWAN protocol adapter has been extended with support for the ChirpStack provider. Hono&amp;rsquo;s integration tests can now be run with a Jaeger back end in order to collect tracing information. The AMQP 1.0 event message based Connection Event producer now sets a TTL on the event messages it produces. The TTL is the max TTL configured at the tenant level. A new Device Registry implementation based on MongoDB database is now available in Hono.</description>
     </item>
     
     <item>
diff --git a/release-notes/index.html b/release-notes/index.html
index c42cb95..132615c 100644
--- a/release-notes/index.html
+++ b/release-notes/index.html
@@ -234,7 +234,7 @@
                         <div>
                           
 
-<h2 id="1-3-0-not-yet-released">1.3.0 (not yet released)</h2>
+<h2 id="1-3-0">1.3.0</h2>
 
 <h3 id="new-features">New Features</h3>