blob: ef81479ea44ae19dfdcf9f4c0deb60f5ea2b38a4 [file] [log] [blame]
hono Bot8ac17b42020-07-20 21:23:51 -04001<!DOCTYPE html>
2<html lang="1.2" class="js csstransforms3d">
3 <head>
4 <meta charset="utf-8">
5 <meta name="viewport" content="width=device-width, initial-scale=1.0">
Hono Botef930712021-04-08 01:12:09 +00006 <meta name="generator" content="Hugo 0.81.0" />
hono Bot8ac17b42020-07-20 21:23:51 -04007 <meta name="description" content="A set of micro-services for connecting millions of devices.">
8<meta name="author" content="The Eclipse Hono Project">
9
10 <link rel="apple-touch-icon" sizes="180x180" href="/hono/docs/favicon/apple-touch-icon.png">
11<link rel="icon" type="image/png" sizes="48x48" href="/hono/docs/favicon/favicon-48x48.png">
12<link rel="icon" type="image/png" sizes="32x32" href="/hono/docs/favicon/favicon-32x32.png">
13<link rel="icon" type="image/png" sizes="16x16" href="/hono/docs/favicon/favicon-16x16.png">
14<link rel="manifest" href="/hono/docs/favicon/site.webmanifest">
15<link rel="mask-icon" href="/hono/docs/favicon/safari-pinned-tab.svg" color="#5bbad5">
16<link rel="shortcut icon" href="/hono/docs/favicon/favicon.ico">
17<meta name="msapplication-TileColor" content="#da532c">
18<meta name="msapplication-config" content="/hono/docs/favicon/browserconfig.xml">
19<meta name="theme-color" content="#ffffff">
20
21 <title>HTTP Adapter Configuration :: Eclipse Hono&trade; Vers.: 1.2</title>
22
23
Hono Botd107b6f2021-07-28 01:13:41 +000024 <link href="/hono/docs/css/nucleus.css?1627434803" rel="stylesheet">
25 <link href="/hono/docs/css/fontawesome-all.min.css?1627434803" rel="stylesheet">
26 <link href="/hono/docs/css/hybrid.css?1627434803" rel="stylesheet">
27 <link href="/hono/docs/css/featherlight.min.css?1627434803" rel="stylesheet">
28 <link href="/hono/docs/css/perfect-scrollbar.min.css?1627434803" rel="stylesheet">
29 <link href="/hono/docs/css/auto-complete.css?1627434803" rel="stylesheet">
30 <link href="/hono/docs/css/atom-one-dark-reasonable.css?1627434803" rel="stylesheet">
31 <link href="/hono/docs/css/theme.css?1627434803" rel="stylesheet">
32 <link href="/hono/docs/css/hugo-theme.css?1627434803" rel="stylesheet">
hono Bot8ac17b42020-07-20 21:23:51 -040033
Hono Botd107b6f2021-07-28 01:13:41 +000034 <link href="/hono/docs/css/theme-hono.css?1627434803" rel="stylesheet">
hono Bot8ac17b42020-07-20 21:23:51 -040035
Hono Botd107b6f2021-07-28 01:13:41 +000036 <link href="/hono/docs/css/hono.css?1627434803" rel="stylesheet">
hono Bot8ac17b42020-07-20 21:23:51 -040037
Hono Botd107b6f2021-07-28 01:13:41 +000038 <script src="/hono/docs/js/jquery-3.3.1.min.js?1627434803"></script>
hono Bot8ac17b42020-07-20 21:23:51 -040039
Hono Botbf26a122021-02-10 02:11:36 +000040 <style>
hono Bot8ac17b42020-07-20 21:23:51 -040041 :root #header + #content > #left > #rlblock_left{
42 display:none !important;
43 }
44
45 :not(pre) > code + span.copy-to-clipboard {
46 display: none;
47 }
48
49 </style>
50
hono Bot8ac17b42020-07-20 21:23:51 -040051<link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css">
hono Bot8ac17b42020-07-20 21:23:51 -040052
53
54<meta name="twitter:card" content="summary_large_image">
55<meta name="twitter:site" content="@EclipseHono">
56<meta name="twitter:title" content="HTTP Adapter Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2">
57<meta name="twitter:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png">
58<meta name="twitter:description" content="A set of micro-services for connecting millions of devices.">
59
60
61<meta property="og:title" content="HTTP Adapter Configuration :: Eclipse Hono&amp;trade; Vers.: 1.2" />
62<meta property="og:type" content="website" />
63<meta property="og:url" content="https://www.eclipse.org/hono/docs/1.2/admin-guide/http-adapter-config//" />
64<meta property="og:image" content="https://www.eclipse.org/hono/docs/images/twitter_image.png" />
65
66 </head>
67 <body class="" data-url="/hono/docs/1.2/admin-guide/http-adapter-config/">
68 <nav id="sidebar" class="">
69
70
71
72 <div id="header-wrapper">
73 <div id="header">
74 <a href="https://www.eclipse.org/hono/">
75 <img src="/hono/docs/images/HONO-Logo_Bild-Wort_quer-w-310x120px.svg" alt="Hono logo" class="logo-img">
76</a>
77
78 </div>
79
80 <div class="searchbox">
81 <label for="search-by"><i class="fas fa-search"></i></label>
82 <input data-search-input id="search-by" type="search" placeholder="Search...">
83 <span data-search-clear=""><i class="fas fa-times"></i></span>
84</div>
85
Hono Botd107b6f2021-07-28 01:13:41 +000086<script type="text/javascript" src="/hono/docs/js/lunr.min.js?1627434803"></script>
87<script type="text/javascript" src="/hono/docs/js/auto-complete.js?1627434803"></script>
hono Bot8ac17b42020-07-20 21:23:51 -040088<script type="text/javascript">
89
90 var baseurl = "https:\/\/www.eclipse.org\/hono\/docs\/\/1.2";
91
92</script>
Hono Botd107b6f2021-07-28 01:13:41 +000093<script type="text/javascript" src="/hono/docs/js/search.js?1627434803"></script>
hono Bot8ac17b42020-07-20 21:23:51 -040094
95
96 </div>
97
98 <div class="highlightable">
99 <ul class="topics">
100
101
102
103
104
105
Hono Botbf26a122021-02-10 02:11:36 +0000106
107
hono Bot8ac17b42020-07-20 21:23:51 -0400108
109
110
111 <li data-nav-id="/hono/docs/1.2/concepts/" title="Concepts" class="dd-item
112
113
114
115 ">
116 <a href="/hono/docs/1.2/concepts/">
117 <i class="far fa-lightbulb"></i> Concepts
118
119 </a>
120
121
122 <ul>
123
124
125
126
127
128
129
130
131
132
Hono Botbf26a122021-02-10 02:11:36 +0000133
134
hono Bot8ac17b42020-07-20 21:23:51 -0400135
136
137
138 <li data-nav-id="/hono/docs/1.2/concepts/device-identity/" title="Device Identity" class="dd-item ">
139 <a href="/hono/docs/1.2/concepts/device-identity/">
140 Device Identity
141
142 </a>
143 </li>
144
145
146
147
148
149
150
151
152
153
Hono Botbf26a122021-02-10 02:11:36 +0000154
155
hono Bot8ac17b42020-07-20 21:23:51 -0400156
157
158
159 <li data-nav-id="/hono/docs/1.2/concepts/tenancy/" title="Multi-Tenancy" class="dd-item ">
160 <a href="/hono/docs/1.2/concepts/tenancy/">
161 Multi-Tenancy
162
163 </a>
164 </li>
165
166
167
168
169
170
171
172
173
174
Hono Botbf26a122021-02-10 02:11:36 +0000175
176
hono Bot8ac17b42020-07-20 21:23:51 -0400177
178
179
180 <li data-nav-id="/hono/docs/1.2/concepts/device-provisioning/" title="Device Provisioning" class="dd-item ">
181 <a href="/hono/docs/1.2/concepts/device-provisioning/">
182 Device Provisioning
183
184 </a>
185 </li>
186
187
188
189
190
191
192
193
194
195
Hono Botbf26a122021-02-10 02:11:36 +0000196
197
hono Bot8ac17b42020-07-20 21:23:51 -0400198
199
200
201 <li data-nav-id="/hono/docs/1.2/concepts/connecting-devices/" title="Connecting Devices" class="dd-item ">
202 <a href="/hono/docs/1.2/concepts/connecting-devices/">
203 Connecting Devices
204
205 </a>
206 </li>
207
208
209
210
211
212
213
214
215
216
Hono Botbf26a122021-02-10 02:11:36 +0000217
218
hono Bot8ac17b42020-07-20 21:23:51 -0400219
220
221
222 <li data-nav-id="/hono/docs/1.2/concepts/device-notifications/" title="Device Notifications" class="dd-item ">
223 <a href="/hono/docs/1.2/concepts/device-notifications/">
224 Device Notifications
225
226 </a>
227 </li>
228
229
230
231
232
233
234
235
236
237
Hono Botbf26a122021-02-10 02:11:36 +0000238
239
hono Bot8ac17b42020-07-20 21:23:51 -0400240
241
242
243 <li data-nav-id="/hono/docs/1.2/concepts/command-and-control/" title="Command &amp; Control" class="dd-item ">
244 <a href="/hono/docs/1.2/concepts/command-and-control/">
245 Command &amp; Control
246
247 </a>
248 </li>
249
250
251
252
253
254
255
256
257
258
Hono Botbf26a122021-02-10 02:11:36 +0000259
260
hono Bot8ac17b42020-07-20 21:23:51 -0400261
262
263
264 <li data-nav-id="/hono/docs/1.2/concepts/resource-limits/" title="Resource limits" class="dd-item ">
265 <a href="/hono/docs/1.2/concepts/resource-limits/">
266 Resource limits
267
268 </a>
269 </li>
270
271
272
273
274
275
276
277
278
279
Hono Botbf26a122021-02-10 02:11:36 +0000280
281
hono Bot8ac17b42020-07-20 21:23:51 -0400282
283
284
285 <li data-nav-id="/hono/docs/1.2/concepts/connection-events/" title="Connection Events" class="dd-item ">
286 <a href="/hono/docs/1.2/concepts/connection-events/">
287 Connection Events
288
289 </a>
290 </li>
291
292
293
294
295
296
297
298 </ul>
Hono Botbf26a122021-02-10 02:11:36 +0000299
hono Bot8ac17b42020-07-20 21:23:51 -0400300 </li>
301
302
303
304
305
306
307
Hono Botbf26a122021-02-10 02:11:36 +0000308
309
hono Bot8ac17b42020-07-20 21:23:51 -0400310
311
312
313 <li data-nav-id="/hono/docs/1.2/user-guide/" title="User Guide" class="dd-item
314
315
316
317 ">
318 <a href="/hono/docs/1.2/user-guide/">
319 <i class="fas fa-book-reader"></i> User Guide
320
321 </a>
322
323
324 <ul>
325
326
327
328
329
330
331
332
333
334
Hono Botbf26a122021-02-10 02:11:36 +0000335
336
hono Bot8ac17b42020-07-20 21:23:51 -0400337
338
339
340 <li data-nav-id="/hono/docs/1.2/user-guide/device-registry/" title="Device Registry" class="dd-item ">
341 <a href="/hono/docs/1.2/user-guide/device-registry/">
342 Device Registry
343
344 </a>
345 </li>
346
347
348
349
350
351
352
353
354
355
Hono Botbf26a122021-02-10 02:11:36 +0000356
357
hono Bot8ac17b42020-07-20 21:23:51 -0400358
359
360
361 <li data-nav-id="/hono/docs/1.2/user-guide/http-adapter/" title="HTTP Adapter" class="dd-item ">
362 <a href="/hono/docs/1.2/user-guide/http-adapter/">
363 HTTP Adapter
364
365 </a>
366 </li>
367
368
369
370
371
372
373
374
375
376
Hono Botbf26a122021-02-10 02:11:36 +0000377
378
hono Bot8ac17b42020-07-20 21:23:51 -0400379
380
381
382 <li data-nav-id="/hono/docs/1.2/user-guide/mqtt-adapter/" title="MQTT Adapter" class="dd-item ">
383 <a href="/hono/docs/1.2/user-guide/mqtt-adapter/">
384 MQTT Adapter
385
386 </a>
387 </li>
388
389
390
391
392
393
394
395
396
397
Hono Botbf26a122021-02-10 02:11:36 +0000398
399
hono Bot8ac17b42020-07-20 21:23:51 -0400400
401
402
403 <li data-nav-id="/hono/docs/1.2/user-guide/amqp-adapter/" title="AMQP Adapter" class="dd-item ">
404 <a href="/hono/docs/1.2/user-guide/amqp-adapter/">
405 AMQP Adapter
406
407 </a>
408 </li>
409
410
411
412
413
414
415
416
417
418
Hono Botbf26a122021-02-10 02:11:36 +0000419
420
hono Bot8ac17b42020-07-20 21:23:51 -0400421
422
423
424 <li data-nav-id="/hono/docs/1.2/user-guide/coap-adapter/" title="CoAP Adapter" class="dd-item ">
425 <a href="/hono/docs/1.2/user-guide/coap-adapter/">
426 CoAP Adapter
427
428 </a>
429 </li>
430
431
432
433
434
435
436
437
438
439
Hono Botbf26a122021-02-10 02:11:36 +0000440
441
hono Bot8ac17b42020-07-20 21:23:51 -0400442
443
444
445 <li data-nav-id="/hono/docs/1.2/user-guide/kura-adapter/" title="Kura Adapter" class="dd-item ">
446 <a href="/hono/docs/1.2/user-guide/kura-adapter/">
447 Kura Adapter
448
449 </a>
450 </li>
451
452
453
454
455
456
457
458
459
460
Hono Botbf26a122021-02-10 02:11:36 +0000461
462
hono Bot8ac17b42020-07-20 21:23:51 -0400463
464
465
466 <li data-nav-id="/hono/docs/1.2/user-guide/sigfox-adapter/" title="Sigfox Adapter" class="dd-item ">
467 <a href="/hono/docs/1.2/user-guide/sigfox-adapter/">
468 Sigfox Adapter
469
470 </a>
471 </li>
472
473
474
475
476
477
478
479
480
481
Hono Botbf26a122021-02-10 02:11:36 +0000482
483
hono Bot8ac17b42020-07-20 21:23:51 -0400484
485
486
487 <li data-nav-id="/hono/docs/1.2/user-guide/jmeter_load_tests/" title="Load Tests with JMeter" class="dd-item ">
488 <a href="/hono/docs/1.2/user-guide/jmeter_load_tests/">
489 Load Tests with JMeter
490
491 </a>
492 </li>
493
494
495
496
497
498
499
500 </ul>
Hono Botbf26a122021-02-10 02:11:36 +0000501
hono Bot8ac17b42020-07-20 21:23:51 -0400502 </li>
503
504
505
506
507
508
509
Hono Botbf26a122021-02-10 02:11:36 +0000510
511
hono Bot8ac17b42020-07-20 21:23:51 -0400512
513
514
515 <li data-nav-id="/hono/docs/1.2/admin-guide/" title="Admin Guide" class="dd-item
516 parent
517
518
519 ">
520 <a href="/hono/docs/1.2/admin-guide/">
521 <i class="fas fa-sliders-h"></i> Admin Guide
522
523 </a>
524
525
526 <ul>
527
528
529
530
531
532
533
534
535
536
Hono Botbf26a122021-02-10 02:11:36 +0000537
538
hono Bot8ac17b42020-07-20 21:23:51 -0400539
540
541
542 <li data-nav-id="/hono/docs/1.2/admin-guide/common-config/" title="Common Configuration" class="dd-item ">
543 <a href="/hono/docs/1.2/admin-guide/common-config/">
544 Common Configuration
545
546 </a>
547 </li>
548
549
550
551
552
553
554
555
556
557
Hono Botbf26a122021-02-10 02:11:36 +0000558
559
hono Bot8ac17b42020-07-20 21:23:51 -0400560
561
562
563 <li data-nav-id="/hono/docs/1.2/admin-guide/auth-server-config/" title="Auth Server Configuration" class="dd-item ">
564 <a href="/hono/docs/1.2/admin-guide/auth-server-config/">
565 Auth Server Configuration
566
567 </a>
568 </li>
569
570
571
572
573
574
575
576
577
578
Hono Botbf26a122021-02-10 02:11:36 +0000579
580
hono Bot8ac17b42020-07-20 21:23:51 -0400581
582
583
584 <li data-nav-id="/hono/docs/1.2/admin-guide/device-registry-config/" title="Device Registry Configuration" class="dd-item ">
585 <a href="/hono/docs/1.2/admin-guide/device-registry-config/">
586 Device Registry Configuration
587
588 </a>
589 </li>
590
591
592
593
594
595
596
597
598
599
Hono Botbf26a122021-02-10 02:11:36 +0000600
601
hono Bot8ac17b42020-07-20 21:23:51 -0400602
603
604
605 <li data-nav-id="/hono/docs/1.2/admin-guide/device-connection-config/" title="Configuring the Device Connection Service" class="dd-item ">
606 <a href="/hono/docs/1.2/admin-guide/device-connection-config/">
607 Device Connection Service Configuration
608
609 </a>
610 </li>
611
612
613
614
615
616
617
618
619
620
Hono Botbf26a122021-02-10 02:11:36 +0000621
622
hono Bot8ac17b42020-07-20 21:23:51 -0400623
624
625
626 <li data-nav-id="/hono/docs/1.2/admin-guide/http-adapter-config/" title="HTTP Adapter Configuration" class="dd-item active">
627 <a href="/hono/docs/1.2/admin-guide/http-adapter-config/">
628 HTTP Adapter Configuration
629
630 </a>
631 </li>
632
633
634
635
636
637
638
639
640
641
Hono Botbf26a122021-02-10 02:11:36 +0000642
643
hono Bot8ac17b42020-07-20 21:23:51 -0400644
645
646
647 <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-adapter-config/" title="AMQP Adapter Configuration" class="dd-item ">
648 <a href="/hono/docs/1.2/admin-guide/amqp-adapter-config/">
649 AMQP Adapter Configuration
650
651 </a>
652 </li>
653
654
655
656
657
658
659
660
661
662
Hono Botbf26a122021-02-10 02:11:36 +0000663
664
hono Bot8ac17b42020-07-20 21:23:51 -0400665
666
667
668 <li data-nav-id="/hono/docs/1.2/admin-guide/mqtt-adapter-config/" title="MQTT Adapter Configuration" class="dd-item ">
669 <a href="/hono/docs/1.2/admin-guide/mqtt-adapter-config/">
670 MQTT Adapter Configuration
671
672 </a>
673 </li>
674
675
676
677
678
679
680
681
682
683
Hono Botbf26a122021-02-10 02:11:36 +0000684
685
hono Bot8ac17b42020-07-20 21:23:51 -0400686
687
688
689 <li data-nav-id="/hono/docs/1.2/admin-guide/kura-adapter-config/" title="Kura Adapter Configuration" class="dd-item ">
690 <a href="/hono/docs/1.2/admin-guide/kura-adapter-config/">
691 Kura Adapter Configuration
692
693 </a>
694 </li>
695
696
697
698
699
700
701
702
703
704
Hono Botbf26a122021-02-10 02:11:36 +0000705
706
hono Bot8ac17b42020-07-20 21:23:51 -0400707
708
709
710 <li data-nav-id="/hono/docs/1.2/admin-guide/hono-client-configuration/" title="Hono Client Configuration" class="dd-item ">
711 <a href="/hono/docs/1.2/admin-guide/hono-client-configuration/">
712 Hono Client Configuration
713
714 </a>
715 </li>
716
717
718
719
720
721
722
723
724
725
Hono Botbf26a122021-02-10 02:11:36 +0000726
727
hono Bot8ac17b42020-07-20 21:23:51 -0400728
729
730
731 <li data-nav-id="/hono/docs/1.2/admin-guide/amqp-network-config/" title="AMQP 1.0 Messaging Network Configuration" class="dd-item ">
732 <a href="/hono/docs/1.2/admin-guide/amqp-network-config/">
733 AMQP 1.0 Messaging Network Configuration
734
735 </a>
736 </li>
737
738
739
740
741
742
743
744
745
746
Hono Botbf26a122021-02-10 02:11:36 +0000747
748
hono Bot8ac17b42020-07-20 21:23:51 -0400749
750
751
752 <li data-nav-id="/hono/docs/1.2/admin-guide/secure_communication/" title="Secure Communication" class="dd-item ">
753 <a href="/hono/docs/1.2/admin-guide/secure_communication/">
754 Secure Communication
755
756 </a>
757 </li>
758
759
760
761
762
763
764
765
766
767
Hono Botbf26a122021-02-10 02:11:36 +0000768
769
hono Bot8ac17b42020-07-20 21:23:51 -0400770
771
772
773 <li data-nav-id="/hono/docs/1.2/admin-guide/monitoring-tracing-config/" title="Monitoring &amp; Tracing" class="dd-item ">
774 <a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">
775 Monitoring &amp; Tracing
776
777 </a>
778 </li>
779
780
781
782
783
784
785
786 </ul>
Hono Botbf26a122021-02-10 02:11:36 +0000787
hono Bot8ac17b42020-07-20 21:23:51 -0400788 </li>
789
790
791
792
793
794
795
Hono Botbf26a122021-02-10 02:11:36 +0000796
797
hono Bot8ac17b42020-07-20 21:23:51 -0400798
799
800
801 <li data-nav-id="/hono/docs/1.2/dev-guide/" title="Developer Guide" class="dd-item
802
803
804
805 ">
806 <a href="/hono/docs/1.2/dev-guide/">
807 <i class="fas fa-tools"></i> Developer Guide
808
809 </a>
810
811
812 <ul>
813
814
815
816
817
818
819
820
821
822
Hono Botbf26a122021-02-10 02:11:36 +0000823
824
hono Bot8ac17b42020-07-20 21:23:51 -0400825
826
827
828 <li data-nav-id="/hono/docs/1.2/dev-guide/building_hono/" title="Building from Source" class="dd-item ">
829 <a href="/hono/docs/1.2/dev-guide/building_hono/">
830 Building from Source
831
832 </a>
833 </li>
834
835
836
837
838
839
840
841
842
843
Hono Botbf26a122021-02-10 02:11:36 +0000844
845
hono Bot8ac17b42020-07-20 21:23:51 -0400846
847
848
849 <li data-nav-id="/hono/docs/1.2/dev-guide/amqp_adapter_client/" title="AMQP Adapter Client for Java" class="dd-item ">
850 <a href="/hono/docs/1.2/dev-guide/amqp_adapter_client/">
851 AMQP Adapter Client for Java
852
853 </a>
854 </li>
855
856
857
858
859
860
861
862
863
864
Hono Botbf26a122021-02-10 02:11:36 +0000865
866
hono Bot8ac17b42020-07-20 21:23:51 -0400867
868
869
870 <li data-nav-id="/hono/docs/1.2/dev-guide/java_client_consumer/" title="Consuming Messages from Java" class="dd-item ">
871 <a href="/hono/docs/1.2/dev-guide/java_client_consumer/">
872 Consuming Messages from Java
873
874 </a>
875 </li>
876
877
878
879
880
881
882
883
884
885
Hono Botbf26a122021-02-10 02:11:36 +0000886
887
hono Bot8ac17b42020-07-20 21:23:51 -0400888
889
890
891 <li data-nav-id="/hono/docs/1.2/dev-guide/custom_http_adapter/" title="Implement a Custom Hono HTTP Protocol Adapter" class="dd-item ">
892 <a href="/hono/docs/1.2/dev-guide/custom_http_adapter/">
893 Implement a Custom Hono HTTP Protocol Adapter
894
895 </a>
896 </li>
897
898
899
900
901
902
903
904 </ul>
Hono Botbf26a122021-02-10 02:11:36 +0000905
hono Bot8ac17b42020-07-20 21:23:51 -0400906 </li>
907
908
909
910
911
912
913
Hono Botbf26a122021-02-10 02:11:36 +0000914
915
hono Bot8ac17b42020-07-20 21:23:51 -0400916
917
918
919 <li data-nav-id="/hono/docs/1.2/api/" title="API" class="dd-item
920
921
922
923 ">
924 <a href="/hono/docs/1.2/api/">
925 &nbsp;<i class='fas fa-plug'></i>&nbsp;API
926
927 </a>
928
929
930 <ul>
931
932
933
934
935
936
937
938
939
940
Hono Botbf26a122021-02-10 02:11:36 +0000941
942
hono Bot8ac17b42020-07-20 21:23:51 -0400943
944
945
946 <li data-nav-id="/hono/docs/1.2/api/telemetry/" title="Telemetry API Specification" class="dd-item ">
947 <a href="/hono/docs/1.2/api/telemetry/">
948 Telemetry API
949
950 </a>
951 </li>
952
953
954
955
956
957
958
959
960
961
Hono Botbf26a122021-02-10 02:11:36 +0000962
963
hono Bot8ac17b42020-07-20 21:23:51 -0400964
965
966
967 <li data-nav-id="/hono/docs/1.2/api/event/" title="Event API Specification" class="dd-item ">
968 <a href="/hono/docs/1.2/api/event/">
969 Event API
970
971 </a>
972 </li>
973
974
975
976
977
978
979
980
981
982
Hono Botbf26a122021-02-10 02:11:36 +0000983
984
hono Bot8ac17b42020-07-20 21:23:51 -0400985
986
987
988 <li data-nav-id="/hono/docs/1.2/api/command-and-control/" title="Command &amp; Control API Specification" class="dd-item ">
989 <a href="/hono/docs/1.2/api/command-and-control/">
990 Command &amp; Control API
991
992 </a>
993 </li>
994
995
996
997
998
999
1000
1001
1002
1003
Hono Botbf26a122021-02-10 02:11:36 +00001004
1005
hono Bot8ac17b42020-07-20 21:23:51 -04001006
1007
1008
1009 <li data-nav-id="/hono/docs/1.2/api/tenant/" title="Tenant API Specification" class="dd-item ">
1010 <a href="/hono/docs/1.2/api/tenant/">
1011 Tenant API
1012
1013 </a>
1014 </li>
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
Hono Botbf26a122021-02-10 02:11:36 +00001025
1026
hono Bot8ac17b42020-07-20 21:23:51 -04001027
1028
1029
1030 <li data-nav-id="/hono/docs/1.2/api/device-connection/" title="Device Connection API Specification" class="dd-item ">
1031 <a href="/hono/docs/1.2/api/device-connection/">
1032 Device Connection API
1033
1034 </a>
1035 </li>
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
Hono Botbf26a122021-02-10 02:11:36 +00001046
1047
hono Bot8ac17b42020-07-20 21:23:51 -04001048
1049
1050
1051 <li data-nav-id="/hono/docs/1.2/api/device-registration/" title="Device Registration API Specification" class="dd-item ">
1052 <a href="/hono/docs/1.2/api/device-registration/">
1053 Device Registration API
1054
1055 </a>
1056 </li>
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
Hono Botbf26a122021-02-10 02:11:36 +00001067
1068
hono Bot8ac17b42020-07-20 21:23:51 -04001069
1070
1071
1072 <li data-nav-id="/hono/docs/1.2/api/credentials/" title="Credentials API Specification" class="dd-item ">
1073 <a href="/hono/docs/1.2/api/credentials/">
1074 Credentials API
1075
1076 </a>
1077 </li>
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
Hono Botbf26a122021-02-10 02:11:36 +00001088
1089
hono Bot8ac17b42020-07-20 21:23:51 -04001090
1091
1092
1093 <li data-nav-id="/hono/docs/1.2/api/authentication/" title="Authentication API Specification" class="dd-item ">
1094 <a href="/hono/docs/1.2/api/authentication/">
1095 Authentication API
1096
1097 </a>
1098 </li>
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
Hono Botbf26a122021-02-10 02:11:36 +00001109
1110
hono Bot8ac17b42020-07-20 21:23:51 -04001111
1112
1113
1114 <li data-nav-id="/hono/docs/1.2/api/management/" title="Device Registry Management API Specification" class="dd-item ">
1115 <a href="/hono/docs/1.2/api/management/">
1116 Device Registry Management API
1117
1118 </a>
1119 </li>
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
Hono Botbf26a122021-02-10 02:11:36 +00001130
1131
hono Bot8ac17b42020-07-20 21:23:51 -04001132
1133
1134
1135 <li data-nav-id="/hono/docs/1.2/api/metrics/" title="Metrics" class="dd-item ">
1136 <a href="/hono/docs/1.2/api/metrics/">
1137 Metrics
1138
1139 </a>
1140 </li>
1141
1142
1143
1144
1145
1146
1147
1148 </ul>
Hono Botbf26a122021-02-10 02:11:36 +00001149
hono Bot8ac17b42020-07-20 21:23:51 -04001150 </li>
1151
1152
1153
1154
1155
1156
1157
Hono Botbf26a122021-02-10 02:11:36 +00001158
1159
hono Bot8ac17b42020-07-20 21:23:51 -04001160
1161
1162
1163 <li data-nav-id="/hono/docs/1.2/deployment/" title="Deployment" class="dd-item
1164
1165
1166
1167 ">
1168 <a href="/hono/docs/1.2/deployment/">
1169 <i class="fas fa-shipping-fast"></i> Deployment
1170
1171 </a>
1172
1173
1174 <ul>
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
Hono Botbf26a122021-02-10 02:11:36 +00001185
1186
hono Bot8ac17b42020-07-20 21:23:51 -04001187
1188
1189
1190 <li data-nav-id="/hono/docs/1.2/deployment/helm-based-deployment/" title="Helm based Deployment" class="dd-item ">
1191 <a href="/hono/docs/1.2/deployment/helm-based-deployment/">
1192 Helm based Deployment
1193
1194 </a>
1195 </li>
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
Hono Botbf26a122021-02-10 02:11:36 +00001206
1207
hono Bot8ac17b42020-07-20 21:23:51 -04001208
1209
1210
1211 <li data-nav-id="/hono/docs/1.2/deployment/openshift/" title="OpenShift / OKD" class="dd-item ">
1212 <a href="/hono/docs/1.2/deployment/openshift/">
1213 OpenShift / OKD
1214
1215 </a>
1216 </li>
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
Hono Botbf26a122021-02-10 02:11:36 +00001227
1228
hono Bot8ac17b42020-07-20 21:23:51 -04001229
1230
1231
1232 <li data-nav-id="/hono/docs/1.2/deployment/create-kubernetes-cluster/" title="Setting up a Kubernetes Cluster" class="dd-item ">
1233 <a href="/hono/docs/1.2/deployment/create-kubernetes-cluster/">
1234 Setting up a Kubernetes Cluster
1235
1236 </a>
1237 </li>
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
Hono Botbf26a122021-02-10 02:11:36 +00001248
1249
hono Bot8ac17b42020-07-20 21:23:51 -04001250
1251
1252
1253 <li data-nav-id="/hono/docs/1.2/deployment/resource-limitation/" title="Limiting Resource Usage" class="dd-item ">
1254 <a href="/hono/docs/1.2/deployment/resource-limitation/">
1255 Limiting Resource Usage
1256
1257 </a>
1258 </li>
1259
1260
1261
1262
1263
1264
1265
1266 </ul>
Hono Botbf26a122021-02-10 02:11:36 +00001267
hono Bot8ac17b42020-07-20 21:23:51 -04001268 </li>
1269
1270
1271
1272
1273
1274
1275
Hono Botbf26a122021-02-10 02:11:36 +00001276
1277
hono Bot8ac17b42020-07-20 21:23:51 -04001278
1279
1280
1281 <li data-nav-id="/hono/docs/1.2/architecture/" title="Architecture" class="dd-item
1282
1283
1284
1285 ">
1286 <a href="/hono/docs/1.2/architecture/">
1287 <i class="fas fa-landmark"></i> Architecture
1288
1289 </a>
1290
1291
1292 <ul>
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
Hono Botbf26a122021-02-10 02:11:36 +00001303
1304
hono Bot8ac17b42020-07-20 21:23:51 -04001305
1306
1307
1308 <li data-nav-id="/hono/docs/1.2/architecture/component-view/" title="Component View" class="dd-item ">
1309 <a href="/hono/docs/1.2/architecture/component-view/">
1310 Component View
1311
1312 </a>
1313 </li>
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
Hono Botbf26a122021-02-10 02:11:36 +00001324
1325
hono Bot8ac17b42020-07-20 21:23:51 -04001326
1327
1328
1329 <li data-nav-id="/hono/docs/1.2/architecture/auth/" title="Authentication/Authorization" class="dd-item ">
1330 <a href="/hono/docs/1.2/architecture/auth/">
1331 Authentication/Authorization
1332
1333 </a>
1334 </li>
1335
1336
1337
1338
1339
1340
1341
1342 </ul>
Hono Botbf26a122021-02-10 02:11:36 +00001343
hono Bot8ac17b42020-07-20 21:23:51 -04001344 </li>
1345
1346
1347
1348
1349
1350 </ul>
1351
1352
1353
1354 <section id="shortcuts">
1355 <h3></h3>
1356 <ul>
1357
1358 <li>
1359 <a class="padding" href="https://www.eclipse.org/hono/" title="Hono&#39;s Homepage"><i class='fas fa-home'></i> Hono Home</a>
1360 </li>
1361
1362 <li>
1363 <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>
1364 </li>
1365
1366 </ul>
1367 </section>
1368
1369
1370
1371 <section id="prefooter">
1372 <hr/>
1373 <ul>
1374
1375 <li>
1376 <div id="select-box-wrapper">
1377 <div id="select-box">
1378 <a class="padding">
1379 Version:&nbsp;
1380 <div class="select-style">
1381 <select id="select-language" onchange="location = this.value;">
1382
1383
1384
1385
1386
1387
1388
1389
Hono Bot8fa7d952021-07-14 01:12:12 +00001390 <option id="stable" value="https://www.eclipse.org/hono/docs/admin-guide/http-adapter-config/">stable (1.9)</option>
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424 <option id="1.9" value="https://www.eclipse.org/hono/docs/1.9/admin-guide/http-adapter-config/">1.9</option>
Hono Bot1f51cfc2021-05-21 01:12:32 +00001425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
Hono Bot8fa7d952021-07-14 01:12:12 +00001454
1455
Hono Bot1f51cfc2021-05-21 01:12:32 +00001456
1457
1458 <option id="1.8" value="https://www.eclipse.org/hono/docs/1.8/admin-guide/http-adapter-config/">1.8</option>
Hono Botef930712021-04-08 01:12:09 +00001459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
Hono Bot1f51cfc2021-05-21 01:12:32 +00001486
1487
Hono Bot8fa7d952021-07-14 01:12:12 +00001488
1489
Hono Botef930712021-04-08 01:12:09 +00001490
1491
1492 <option id="1.7" value="https://www.eclipse.org/hono/docs/1.7/admin-guide/http-adapter-config/">1.7</option>
Hono Bot650d39f2021-02-02 02:17:46 +00001493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
Hono Botef930712021-04-08 01:12:09 +00001518
1519
Hono Bot1f51cfc2021-05-21 01:12:32 +00001520
1521
Hono Bot8fa7d952021-07-14 01:12:12 +00001522
1523
Hono Bot650d39f2021-02-02 02:17:46 +00001524
1525
Hono Botbf26a122021-02-10 02:11:36 +00001526 <option id="1.6" value="https://www.eclipse.org/hono/docs/1.6/admin-guide/http-adapter-config/">1.6</option>
Hono Bot93bd24f2020-12-17 02:12:33 +00001527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
Hono Bot650d39f2021-02-02 02:17:46 +00001550
1551
Hono Botef930712021-04-08 01:12:09 +00001552
1553
Hono Bot1f51cfc2021-05-21 01:12:32 +00001554
1555
Hono Bot8fa7d952021-07-14 01:12:12 +00001556
1557
Hono Bot93bd24f2020-12-17 02:12:33 +00001558
1559
Hono Botbf26a122021-02-10 02:11:36 +00001560 <option id="1.5" value="https://www.eclipse.org/hono/docs/1.5/admin-guide/http-adapter-config/">1.5</option>
hono Bot01909692020-09-10 21:24:10 -04001561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
Hono Bot93bd24f2020-12-17 02:12:33 +00001582
1583
Hono Bot650d39f2021-02-02 02:17:46 +00001584
1585
Hono Botef930712021-04-08 01:12:09 +00001586
1587
Hono Bot1f51cfc2021-05-21 01:12:32 +00001588
1589
Hono Bot8fa7d952021-07-14 01:12:12 +00001590
1591
hono Bot01909692020-09-10 21:24:10 -04001592
1593
Hono Botbf26a122021-02-10 02:11:36 +00001594 <option id="1.4" value="https://www.eclipse.org/hono/docs/1.4/admin-guide/http-adapter-config/">1.4</option>
hono Bot8ac17b42020-07-20 21:23:51 -04001595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
hono Bot132f6bf2020-08-03 21:23:53 -04001606
1607
hono Bot8ac17b42020-07-20 21:23:51 -04001608
1609
1610
1611
1612
1613
hono Bot01909692020-09-10 21:24:10 -04001614
1615
Hono Bot93bd24f2020-12-17 02:12:33 +00001616
1617
Hono Bot650d39f2021-02-02 02:17:46 +00001618
1619
Hono Botef930712021-04-08 01:12:09 +00001620
1621
Hono Bot1f51cfc2021-05-21 01:12:32 +00001622
1623
Hono Bot8fa7d952021-07-14 01:12:12 +00001624
1625
hono Bot8ac17b42020-07-20 21:23:51 -04001626
1627
Hono Botbf26a122021-02-10 02:11:36 +00001628 <option id="1.3" value="https://www.eclipse.org/hono/docs/1.3/admin-guide/http-adapter-config/">1.3</option>
hono Bot132f6bf2020-08-03 21:23:53 -04001629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
hono Bot01909692020-09-10 21:24:10 -04001648
1649
Hono Bot93bd24f2020-12-17 02:12:33 +00001650
1651
Hono Bot650d39f2021-02-02 02:17:46 +00001652
1653
Hono Botef930712021-04-08 01:12:09 +00001654
1655
Hono Bot1f51cfc2021-05-21 01:12:32 +00001656
1657
Hono Bot8fa7d952021-07-14 01:12:12 +00001658
1659
hono Bot132f6bf2020-08-03 21:23:53 -04001660
1661
Hono Botbf26a122021-02-10 02:11:36 +00001662 <option id="1.2" value="https://www.eclipse.org/hono/docs/1.2/admin-guide/http-adapter-config/" selected>1.2</option>
hono Bot8ac17b42020-07-20 21:23:51 -04001663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
hono Bot132f6bf2020-08-03 21:23:53 -04001680
1681
hono Bot01909692020-09-10 21:24:10 -04001682
1683
Hono Bot93bd24f2020-12-17 02:12:33 +00001684
1685
Hono Bot650d39f2021-02-02 02:17:46 +00001686
1687
Hono Botef930712021-04-08 01:12:09 +00001688
1689
Hono Bot1f51cfc2021-05-21 01:12:32 +00001690
1691
Hono Bot8fa7d952021-07-14 01:12:12 +00001692
1693
hono Bot8ac17b42020-07-20 21:23:51 -04001694
1695
Hono Botbf26a122021-02-10 02:11:36 +00001696 <option id="1.1" value="https://www.eclipse.org/hono/docs/1.1/admin-guide/http-adapter-config/">1.1</option>
hono Bot8ac17b42020-07-20 21:23:51 -04001697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
hono Bot132f6bf2020-08-03 21:23:53 -04001714
1715
hono Bot01909692020-09-10 21:24:10 -04001716
1717
Hono Bot93bd24f2020-12-17 02:12:33 +00001718
1719
Hono Bot650d39f2021-02-02 02:17:46 +00001720
1721
Hono Botef930712021-04-08 01:12:09 +00001722
1723
Hono Bot1f51cfc2021-05-21 01:12:32 +00001724
1725
Hono Bot8fa7d952021-07-14 01:12:12 +00001726
1727
hono Bot8ac17b42020-07-20 21:23:51 -04001728
1729
Hono Botbf26a122021-02-10 02:11:36 +00001730 <option id="1.0" value="https://www.eclipse.org/hono/docs/1.0/admin-guide/http-adapter-config/">1.0</option>
hono Bot8ac17b42020-07-20 21:23:51 -04001731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
hono Bot132f6bf2020-08-03 21:23:53 -04001748
1749
hono Bot01909692020-09-10 21:24:10 -04001750
1751
Hono Bot93bd24f2020-12-17 02:12:33 +00001752
1753
Hono Bot650d39f2021-02-02 02:17:46 +00001754
1755
Hono Botef930712021-04-08 01:12:09 +00001756
1757
Hono Bot1f51cfc2021-05-21 01:12:32 +00001758
1759
Hono Bot8fa7d952021-07-14 01:12:12 +00001760
1761
hono Bot8ac17b42020-07-20 21:23:51 -04001762
1763
Hono Botbf26a122021-02-10 02:11:36 +00001764 <option id="dev" value="https://www.eclipse.org/hono/docs/dev/admin-guide/http-adapter-config/">dev</option>
hono Bot8ac17b42020-07-20 21:23:51 -04001765
1766
1767
1768
1769 </select>
1770 <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"
1771 width="255px" height="255px" viewBox="0 0 255 255" style="enable-background:new 0 0 255 255;" xml:space="preserve">
1772 <g>
1773 <g id="arrow-drop-down">
1774 <polygon points="0,63.75 127.5,191.25 255,63.75 " />
1775 </g>
1776 </g>
1777 </svg>
1778 </div>
1779 </a>
1780 </div>
1781 </div>
1782 </li>
1783
1784
1785
1786 </ul>
1787 </section>
1788
1789 <section id="footer">
1790
1791
Hono Botd9322632021-01-01 02:10:48 +00001792<p>&copy; 2021 <a href="https://www.eclipse.org/hono/">The Eclipse Hono Project</a></p>
hono Bot8ac17b42020-07-20 21:23:51 -04001793
1794<p>
1795 Documentation built with
1796 <a href="https://gohugo.io/" target="_blank">Hugo</a>
1797 using the
1798 <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn</a> theme.
1799</p>
1800
1801<div class="eclipse-logo">
1802 <a href="https://www.eclipse.org" target="_blank">
1803 <img src="https://www.eclipse.org/hono/docs/images/eclipse_foundation_logo.svg"/>
1804 </a>
1805</div>
1806
1807 </section>
1808 </div>
1809</nav>
1810
1811
1812
1813
hono Bot8ac17b42020-07-20 21:23:51 -04001814 <section id="body">
1815 <div id="overlay"></div>
Hono Botbf26a122021-02-10 02:11:36 +00001816
hono Bot8ac17b42020-07-20 21:23:51 -04001817
1818 <div class="old-version-hint">
1819 <p>This page refers to version <em>1.2</em>.
1820 You might want to use the <a href="https://www.eclipse.org/hono/docs/">current stable</a> version.
1821 </p>
1822 </div>
1823
1824
Hono Botbf26a122021-02-10 02:11:36 +00001825
hono Bot8ac17b42020-07-20 21:23:51 -04001826 <div class="padding highlightable">
1827
1828 <div>
1829 <div id="top-bar">
1830
1831
1832
1833
1834 <div id="top-github-link">
1835 <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">
1836 <i class="fas fa-code-branch"></i>
1837 <span id="top-github-link-text">Edit this page</span>
1838 </a>
1839 </div>
1840
1841
1842
1843 <div id="breadcrumbs" itemscope="" itemtype="http://data-vocabulary.org/Breadcrumb">
1844 <span id="sidebar-toggle-span">
1845 <a href="#" id="sidebar-toggle" data-sidebar-toggle="">
1846 <i class="fas fa-bars"></i>
1847 </a>
1848 </span>
1849
1850 <span id="toc-menu"><i class="fas fa-list-alt"></i></span>
1851
1852 <span class="links">
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866 <a href='/hono/docs/1.2/'>Documentation</a> > <a href='/hono/docs/1.2/admin-guide/'>Admin Guide</a> > HTTP Adapter Configuration
1867
Hono Botbf26a122021-02-10 02:11:36 +00001868
hono Bot8ac17b42020-07-20 21:23:51 -04001869
Hono Botbf26a122021-02-10 02:11:36 +00001870
hono Bot8ac17b42020-07-20 21:23:51 -04001871
1872
1873
1874 </span>
1875 </div>
1876
1877 <div class="progress">
1878 <div class="wrapper">
1879<nav id="TableOfContents">
Hono Botef930712021-04-08 01:12:09 +00001880 <ul>
1881 <li><a href="#service-configuration">Service Configuration</a></li>
1882 <li><a href="#port-configuration">Port Configuration</a>
1883 <ul>
1884 <li><a href="#secure-port-only">Secure Port Only</a></li>
1885 <li><a href="#insecure-port-only">Insecure Port Only</a></li>
1886 <li><a href="#dual-port">Dual Port</a></li>
1887 <li><a href="#ephemeral-ports">Ephemeral Ports</a></li>
1888 </ul>
1889 </li>
1890 </ul>
hono Bot8ac17b42020-07-20 21:23:51 -04001891</nav>
1892 </div>
1893</div>
1894
1895
1896 </div>
1897 </div>
1898
Hono Botbf26a122021-02-10 02:11:36 +00001899 <div id="head-tags">
1900
1901 </div>
hono Bot8ac17b42020-07-20 21:23:51 -04001902
1903 <div id="body-inner">
1904
Hono Botbf26a122021-02-10 02:11:36 +00001905 <h1>
1906
1907 HTTP Adapter Configuration
1908 </h1>
hono Bot8ac17b42020-07-20 21:23:51 -04001909
1910
1911
1912
1913
Hono Botef930712021-04-08 01:12:09 +00001914<p>The HTTP protocol adapter exposes a HTTP based API for Eclipse Honoâ„¢&rsquo;s Telemetry and Event endpoints.</p>
hono Bot8ac17b42020-07-20 21:23:51 -04001915<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>
hono Bot8ac17b42020-07-20 21:23:51 -04001916<p>The adapter supports the following standard configuration options:</p>
hono Bot8ac17b42020-07-20 21:23:51 -04001917<ul>
1918<li><a href="/hono/docs/1.2/admin-guide/common-config/#java-vm-options">Common Java VM Options</a></li>
1919<li><a href="/hono/docs/1.2/admin-guide/common-config/#vert-x-options">Common vert.x Options</a></li>
1920<li><a href="/hono/docs/1.2/admin-guide/common-config/#protocol-adapter-options">Common Protocol Adapter Options</a></li>
1921<li><a href="/hono/docs/1.2/admin-guide/monitoring-tracing-config/">Monitoring Options</a></li>
1922</ul>
hono Bot8ac17b42020-07-20 21:23:51 -04001923<h2 id="service-configuration">Service Configuration</h2>
hono Bot8ac17b42020-07-20 21:23:51 -04001924<p>The following table provides an overview of the configuration variables and corresponding command line options for configuring the HTTP adapter.</p>
hono Bot8ac17b42020-07-20 21:23:51 -04001925<table>
1926<thead>
1927<tr>
Hono Botef930712021-04-08 01:12:09 +00001928<th style="text-align:left">Environment Variable<br>Command Line Option</th>
1929<th style="text-align:center">Mandatory</th>
1930<th style="text-align:left">Default</th>
1931<th style="text-align:left">Description</th>
hono Bot8ac17b42020-07-20 21:23:51 -04001932</tr>
1933</thead>
hono Bot8ac17b42020-07-20 21:23:51 -04001934<tbody>
1935<tr>
Hono Botef930712021-04-08 01:12:09 +00001936<td style="text-align:left"><code>HONO_APP_MAX_INSTANCES</code><br><code>--hono.app.maxInstances</code></td>
1937<td style="text-align:center">no</td>
1938<td style="text-align:left"><em>#CPU cores</em></td>
1939<td style="text-align:left">The number of verticle instances to deploy. If not set, one verticle per processor core is deployed.</td>
hono Bot8ac17b42020-07-20 21:23:51 -04001940</tr>
hono Bot8ac17b42020-07-20 21:23:51 -04001941<tr>
Hono Botef930712021-04-08 01:12:09 +00001942<td style="text-align:left"><code>HONO_HTTP_AUTHENTICATION_REQUIRED</code><br><code>--hono.http.authenticationRequired</code></td>
1943<td style="text-align:center">no</td>
1944<td style="text-align:left"><code>true</code></td>
1945<td style="text-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>
hono Bot8ac17b42020-07-20 21:23:51 -04001946</tr>
hono Bot8ac17b42020-07-20 21:23:51 -04001947<tr>
Hono Botef930712021-04-08 01:12:09 +00001948<td style="text-align:left"><code>HONO_HTTP_BIND_ADDRESS</code><br><code>--hono.http.bindAddress</code></td>
1949<td style="text-align:center">no</td>
1950<td style="text-align:left"><code>127.0.0.1</code></td>
1951<td style="text-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>
hono Bot8ac17b42020-07-20 21:23:51 -04001952</tr>
hono Bot8ac17b42020-07-20 21:23:51 -04001953<tr>
Hono Botef930712021-04-08 01:12:09 +00001954<td style="text-align:left"><code>HONO_HTTP_CERT_PATH</code><br><code>--hono.http.certPath</code></td>
1955<td style="text-align:center">no</td>
1956<td style="text-align:left">-</td>
1957<td style="text-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>
hono Bot8ac17b42020-07-20 21:23:51 -04001958</tr>
hono Bot8ac17b42020-07-20 21:23:51 -04001959<tr>
Hono Botef930712021-04-08 01:12:09 +00001960<td style="text-align:left"><code>HONO_HTTP_DEFAULTS_ENABLED</code><br><code>--hono.http.defaultsEnabled</code></td>
1961<td style="text-align:center">no</td>
1962<td style="text-align:left"><code>true</code></td>
1963<td style="text-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>
hono Bot8ac17b42020-07-20 21:23:51 -04001964</tr>
hono Bot8ac17b42020-07-20 21:23:51 -04001965<tr>
Hono Botef930712021-04-08 01:12:09 +00001966<td style="text-align:left"><code>HONO_HTTP_INSECURE_PORT</code><br><code>--hono.http.insecurePort</code></td>
1967<td style="text-align:center">no</td>
1968<td style="text-align:left">-</td>
1969<td style="text-align:left">The insecure port the protocol adapter should listen on.<br>See <a href="#port-configuration">Port Configuration</a> below for details.</td>
hono Bot8ac17b42020-07-20 21:23:51 -04001970</tr>
hono Bot8ac17b42020-07-20 21:23:51 -04001971<tr>
Hono Botef930712021-04-08 01:12:09 +00001972<td style="text-align:left"><code>HONO_HTTP_INSECURE_PORT_BIND_ADDRESS</code><br><code>--hono.http.insecurePortBindAddress</code></td>
1973<td style="text-align:center">no</td>
1974<td style="text-align:left"><code>127.0.0.1</code></td>
1975<td style="text-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>
hono Bot8ac17b42020-07-20 21:23:51 -04001976</tr>
hono Bot8ac17b42020-07-20 21:23:51 -04001977<tr>
Hono Botef930712021-04-08 01:12:09 +00001978<td style="text-align:left"><code>HONO_HTTP_INSECURE_PORT_ENABLED</code><br><code>--hono.http.insecurePortEnabled</code></td>
1979<td style="text-align:center">no</td>
1980<td style="text-align:left"><code>false</code></td>
1981<td style="text-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>
hono Bot8ac17b42020-07-20 21:23:51 -04001982</tr>
hono Bot8ac17b42020-07-20 21:23:51 -04001983<tr>
Hono Botef930712021-04-08 01:12:09 +00001984<td style="text-align:left"><code>HONO_HTTP_KEY_PATH</code><br><code>--hono.http.keyPath</code></td>
1985<td style="text-align:center">no</td>
1986<td style="text-align:left">-</td>
1987<td style="text-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>
hono Bot8ac17b42020-07-20 21:23:51 -04001988</tr>
hono Bot8ac17b42020-07-20 21:23:51 -04001989<tr>
Hono Botef930712021-04-08 01:12:09 +00001990<td style="text-align:left"><code>HONO_HTTP_KEY_STORE_PASSWORD</code><br><code>--hono.http.keyStorePassword</code></td>
1991<td style="text-align:center">no</td>
1992<td style="text-align:left">-</td>
1993<td style="text-align:left">The password required to read the contents of the key store.</td>
hono Bot8ac17b42020-07-20 21:23:51 -04001994</tr>
hono Bot8ac17b42020-07-20 21:23:51 -04001995<tr>
Hono Botef930712021-04-08 01:12:09 +00001996<td style="text-align:left"><code>HONO_HTTP_KEY_STORE_PATH</code><br><code>--hono.http.keyStorePath</code></td>
1997<td style="text-align:center">no</td>
1998<td style="text-align:left">-</td>
1999<td style="text-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>
hono Bot8ac17b42020-07-20 21:23:51 -04002000</tr>
hono Bot8ac17b42020-07-20 21:23:51 -04002001<tr>
Hono Botef930712021-04-08 01:12:09 +00002002<td style="text-align:left"><code>HONO_HTTP_SNI</code><br><code>--hono.http.sni</code></td>
2003<td style="text-align:center">no</td>
2004<td style="text-align:left"><code>false</code></td>
2005<td style="text-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>
hono Bot8ac17b42020-07-20 21:23:51 -04002006</tr>
hono Bot8ac17b42020-07-20 21:23:51 -04002007<tr>
Hono Botef930712021-04-08 01:12:09 +00002008<td style="text-align:left"><code>HONO_HTTP_NATIVE_TLS_REQUIRED</code><br><code>--hono.http.nativeTlsRequired</code></td>
2009<td style="text-align:center">no</td>
2010<td style="text-align:left"><code>false</code></td>
2011<td style="text-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>
hono Bot8ac17b42020-07-20 21:23:51 -04002012</tr>
hono Bot8ac17b42020-07-20 21:23:51 -04002013<tr>
Hono Botef930712021-04-08 01:12:09 +00002014<td style="text-align:left"><code>HONO_HTTP_MAX_PAYLOAD_SIZE</code><br><code>--hono.http.maxPayloadSize</code></td>
2015<td style="text-align:center">no</td>
2016<td style="text-align:left"><code>2048</code></td>
2017<td style="text-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>
hono Bot8ac17b42020-07-20 21:23:51 -04002018</tr>
hono Bot8ac17b42020-07-20 21:23:51 -04002019<tr>
Hono Botef930712021-04-08 01:12:09 +00002020<td style="text-align:left"><code>HONO_HTTP_PORT</code><br><code>--hono.http.port</code></td>
2021<td style="text-align:center">no</td>
2022<td style="text-align:left"><code>8443</code></td>
2023<td style="text-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>
hono Bot8ac17b42020-07-20 21:23:51 -04002024</tr>
hono Bot8ac17b42020-07-20 21:23:51 -04002025<tr>
Hono Botef930712021-04-08 01:12:09 +00002026<td style="text-align:left"><code>HONO_HTTP_REALM</code><br><code>--hono.http.realm</code></td>
2027<td style="text-align:center">no</td>
2028<td style="text-align:left"><code>Hono</code></td>
2029<td style="text-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>
hono Bot8ac17b42020-07-20 21:23:51 -04002030</tr>
hono Bot8ac17b42020-07-20 21:23:51 -04002031<tr>
Hono Botef930712021-04-08 01:12:09 +00002032<td style="text-align:left"><code>HONO_HTTP_SECURE_PROTOCOLS</code><br><code>--hono.http.secureProtocols</code></td>
2033<td style="text-align:center">no</td>
2034<td style="text-align:left"><code>TLSv1.2</code></td>
2035<td style="text-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>
hono Bot8ac17b42020-07-20 21:23:51 -04002036</tr>
hono Bot8ac17b42020-07-20 21:23:51 -04002037<tr>
Hono Botef930712021-04-08 01:12:09 +00002038<td style="text-align:left"><code>HONO_HTTP_TENANT_IDLE_TIMEOUT</code><br><code>--hono.http.tenantIdleTimeout</code></td>
2039<td style="text-align:center">no</td>
2040<td style="text-align:left"><code>0ms</code></td>
2041<td style="text-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>
hono Bot8ac17b42020-07-20 21:23:51 -04002042</tr>
2043</tbody>
2044</table>
hono Bot8ac17b42020-07-20 21:23:51 -04002045<p>The variables only need to be set if the default value does not match your environment.</p>
hono Bot8ac17b42020-07-20 21:23:51 -04002046<h2 id="port-configuration">Port Configuration</h2>
hono Bot8ac17b42020-07-20 21:23:51 -04002047<p>The HTTP protocol adapter can be configured to listen for connections on</p>
hono Bot8ac17b42020-07-20 21:23:51 -04002048<ul>
2049<li>a secure port only (default) or</li>
2050<li>an insecure port only or</li>
2051<li>both a secure and an insecure port (dual port configuration)</li>
2052</ul>
hono Bot8ac17b42020-07-20 21:23:51 -04002053<p>The HTTP protocol adapter will fail to start if none of the ports is configured properly.</p>
hono Bot8ac17b42020-07-20 21:23:51 -04002054<h3 id="secure-port-only">Secure Port Only</h3>
hono Bot8ac17b42020-07-20 21:23:51 -04002055<p>The protocol adapter needs to be configured with a private key and certificate in order to open a TLS secured port.</p>
hono Bot8ac17b42020-07-20 21:23:51 -04002056<p>There are two alternative ways for doing so:</p>
hono Bot8ac17b42020-07-20 21:23:51 -04002057<ol>
2058<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>
2059<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>
2060</ol>
hono Bot8ac17b42020-07-20 21:23:51 -04002061<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>
hono Bot8ac17b42020-07-20 21:23:51 -04002062<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>
hono Bot8ac17b42020-07-20 21:23:51 -04002063<h3 id="insecure-port-only">Insecure Port Only</h3>
hono Bot8ac17b42020-07-20 21:23:51 -04002064<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>
hono Bot8ac17b42020-07-20 21:23:51 -04002065<ul>
2066<li>explicitly setting <code>HONO_HTTP_INSECURE_PORT</code> to a valid port number, or by</li>
2067<li>implicitly configuring the default port (8080) by simply setting <code>HONO_HTTP_INSECURE_PORT_ENABLED</code> to <code>true</code>.</li>
2068</ul>
hono Bot8ac17b42020-07-20 21:23:51 -04002069<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>
hono Bot8ac17b42020-07-20 21:23:51 -04002070<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>
hono Bot8ac17b42020-07-20 21:23:51 -04002071<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>
hono Bot8ac17b42020-07-20 21:23:51 -04002072<h3 id="dual-port">Dual Port</h3>
hono Bot8ac17b42020-07-20 21:23:51 -04002073<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>
hono Bot8ac17b42020-07-20 21:23:51 -04002074<h3 id="ephemeral-ports">Ephemeral Ports</h3>
hono Bot8ac17b42020-07-20 21:23:51 -04002075<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>
2076
Hono Botbf26a122021-02-10 02:11:36 +00002077<footer class="footline">
hono Bot8ac17b42020-07-20 21:23:51 -04002078
2079</footer>
2080
hono Bot8ac17b42020-07-20 21:23:51 -04002081
2082 </div>
2083
2084
2085 </div>
2086
2087 <div id="navigation">
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
2388
2389
2390
2391
2392
2393
2394
2395
2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413
2414
2415
2416
2417
2418
2419
2420
2421
2422
2423
2424
2425
2426
2427
2428
2429
2430
2431
2432
2433
2434
2435
2436
2437
2438
2439
2440
2441
2442
2443
2444
2445
2446
2447
2448
2449
2450
2451
2452
2453
2454
2455
2456
2457
2458
2459
2460
2461
2462
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472
2473
2474
2475
2476
2477
2478
2479
2480
2481
2482
2483
2484
2485
2486
2487
2488
2489
2490
2491
2492
2493
2494
2495
2496
2497
2498
2499
2500
2501
2502
2503
2504
2505
2506
2507
2508
2509
2510
2511
2512
2513
2514
2515
2516
2517
2518
2519
2520
2521
2522
2523
2524
2525
2526
2527
2528
2529
2530
2531
2532
2533
2534
2535
2536
2537
2538
2539
2540
2541
2542
2543
2544
2545
2546
2547
2548
2549
2550
2551
2552
2553
2554
2555
2556
2557
2558
2559
2560
2561
2562
2563
2564
2565
2566
2567
2568
2569
2570
2571
2572
2573
2574
2575
2576
2577
2578
2579
2580
2581
2582
2583
2584
2585
2586
2587
2588
2589
2590
2591
2592
2593
2594
2595
2596
2597
2598
2599
2600
2601
2602
2603
2604
2605
2606
2607
2608
2609
2610
2611
2612
2613
2614
2615
2616
2617
2618
2619
2620
2621
2622
2623
2624
2625
2626
2627
2628
2629
2630
2631
2632
2633
2634
2635
2636
2637
2638
2639
2640
2641
2642
2643
2644
2645
2646
2647
2648
2649
2650
2651
2652
2653
2654
2655
2656
2657
2658
2659
2660
2661
2662
2663
2664
2665
2666
2667
2668
2669
2670
2671
2672
2673
2674
2675
2676
2677
2678
2679
2680
2681
2682
2683
2684
2685
2686
2687
2688
2689
2690
2691
2692
2693
2694
2695
2696
2697
2698
2699
2700
2701
2702
2703
2704
2705
2706
2707
2708
2709
2710
2711
2712
2713
2714
2715
2716
2717
2718
2719
2720
2721
2722
2723
2724
2725
2726
2727
2728
2729
2730
2731
2732
2733
2734
2735
2736
2737
2738
2739
2740
2741
2742
2743
2744
2745
2746
2747
2748
2749
2750
2751
2752
2753
2754
2755
2756
2757
2758
2759
2760
2761
2762
2763
2764
2765
2766
2767
2768
2769
2770
2771
2772
2773
2774
2775
2776
2777
2778
2779
2780
2781
2782
2783
2784
2785
2786
2787
2788
2789
2790
2791
2792
2793
2794
2795
2796
2797
2798
2799
2800
2801
2802
2803
2804
2805
2806
2807
2808
2809
2810
2811
2812
2813
2814
2815
2816
2817
2818
2819
2820
2821
2822
2823
2824
2825
2826
2827
2828
2829
2830
2831
2832
2833
2834
2835
2836
2837
2838
2839
2840
2841
2842
2843
2844
2845
2846
2847
2848
2849
2850
2851
2852
2853
2854
2855
2856
2857
2858
2859
2860
2861
2862
2863
2864
2865
2866
2867
2868
2869
2870
2871
2872
2873
2874
2875
2876
2877
2878
2879
2880
2881
2882
2883
2884
2885
2886
2887
2888
2889
2890
2891
2892
2893
2894
2895
2896
2897
2898
2899
2900
2901
2902
2903
2904
2905
2906
2907
2908
2909
2910
2911
2912
2913
2914
2915
2916
2917
2918
2919
2920
2921
2922
2923
2924
2925
2926
2927
2928
2929
2930
2931
2932
2933
2934
2935
2936
2937
2938
2939
2940
2941
2942
2943
2944
2945
2946
2947
2948
2949
2950
2951
2952
2953
2954
2955
2956
2957
2958
2959
2960
2961
2962
2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
2977
2978
2979
2980
2981
2982
2983
2984
2985
2986
2987
2988
2989
2990
2991
2992
2993
2994
2995
2996
2997
2998
2999
3000
3001
3002
3003
3004
3005
3006 </div>
3007
3008 </section>
3009
3010 <div style="left: -1000px; overflow: scroll; position: absolute; top: -1000px; border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;">
3011 <div style="border: none; box-sizing: content-box; height: 200px; margin: 0px; padding: 0px; width: 200px;"></div>
3012 </div>
Hono Botd107b6f2021-07-28 01:13:41 +00003013 <script src="/hono/docs/js/clipboard.min.js?1627434803"></script>
3014 <script src="/hono/docs/js/perfect-scrollbar.min.js?1627434803"></script>
3015 <script src="/hono/docs/js/perfect-scrollbar.jquery.min.js?1627434803"></script>
3016 <script src="/hono/docs/js/jquery.sticky.js?1627434803"></script>
3017 <script src="/hono/docs/js/featherlight.min.js?1627434803"></script>
3018 <script src="/hono/docs/js/highlight.pack.js?1627434803"></script>
hono Bot8ac17b42020-07-20 21:23:51 -04003019 <script>hljs.initHighlightingOnLoad();</script>
Hono Botd107b6f2021-07-28 01:13:41 +00003020 <script src="/hono/docs/js/modernizr.custom-3.6.0.js?1627434803"></script>
3021 <script src="/hono/docs/js/learn.js?1627434803"></script>
3022 <script src="/hono/docs/js/hugo-learn.js?1627434803"></script>
hono Bot8ac17b42020-07-20 21:23:51 -04003023
Hono Botd107b6f2021-07-28 01:13:41 +00003024 <link href="/hono/docs/mermaid/mermaid.css?1627434803" rel="stylesheet" />
3025 <script src="/hono/docs/mermaid/mermaid.js?1627434803"></script>
hono Bot8ac17b42020-07-20 21:23:51 -04003026 <script>
3027 mermaid.initialize({ startOnLoad: true });
3028 </script>
3029
3030
3031
3032
hono Bot8ac17b42020-07-20 21:23:51 -04003033<script>
3034 (function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
3035 new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
3036 j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
3037 'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
3038 })(window,document,'script','dataLayer','GTM-5WLCZXC');
3039</script>
3040
3041
3042<script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script>
3043
3044 </body>
3045</html>
3046