| <!DOCTYPE html> |
| <html lang="en-us"> |
| |
| <head> |
| <meta charset="utf-8"> |
| <meta name="robots" content="all,follow"> |
| <meta name="googlebot" content="index,follow,snippet,archive"> |
| <meta name="viewport" content="width=device-width, initial-scale=1"> |
| |
| <title>Try Hono without installing locally :: Eclipse Hono™</title> |
| <meta name="author" content="The Eclipse Hono Project" /> |
| |
| |
| |
| |
| |
| <meta name="description" content="The Sandbox environment can be used to play around with Hono’s APIs without the need to set up a Kubernetes cluster and install Hono manually."> |
| |
| <meta name="generator" content="Hugo 0.81.0" /> |
| |
| |
| <link href='//fonts.googleapis.com/css?family=Roboto:400,100,100italic,300,300italic,500,700,800' rel='stylesheet' type='text/css'> |
| |
| |
| <link rel="stylesheet" href="//use.fontawesome.com/releases/v5.11.2/css/all.css"> |
| <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous"> |
| |
| |
| <link href="/hono/css/animate.css" rel="stylesheet"> |
| |
| |
| |
| <link href="/hono/css/style.hono.css" rel="stylesheet" id="theme-stylesheet"> |
| |
| |
| |
| <link href="/hono/css/custom.css" rel="stylesheet"> |
| |
| |
| |
| <!--[if lt IE 9]> |
| <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script> |
| <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script> |
| <![endif]--> |
| |
| |
| |
| <link rel="apple-touch-icon" sizes="180x180" href="/hono/favicon/apple-touch-icon.png"> |
| <link rel="icon" type="image/png" sizes="48x48" href="/hono/favicon/favicon-48x48.png"> |
| <link rel="icon" type="image/png" sizes="32x32" href="/hono/favicon/favicon-32x32.png"> |
| <link rel="icon" type="image/png" sizes="16x16" href="/hono/favicon/favicon-16x16.png"> |
| <link rel="manifest" href="/hono/favicon/site.webmanifest"> |
| <link rel="mask-icon" href="/hono/favicon/safari-pinned-tab.svg" color="#5bbad5"> |
| <link rel="shortcut icon" href="/hono/favicon/favicon.ico"> |
| <meta name="msapplication-TileColor" content="#da532c"> |
| <meta name="msapplication-config" content="/hono/favicon/browserconfig.xml"> |
| <meta name="theme-color" content="#ffffff"> |
| |
| |
| <link href="/hono/css/owl.carousel.css" rel="stylesheet"> |
| <link href="/hono/css/owl.theme.css" rel="stylesheet"> |
| |
| |
| <link rel="alternate" href="/hono/index.xml" type="application/rss+xml" title="Eclipse Hono&trade;"> |
| |
| |
| |
| |
| |
| |
| |
| |
| <meta property="og:locale" content="en_us"> |
| <meta property="og:site_name" content="Eclipse Hono&trade;"> |
| <meta property="og:title" content="Try Hono without installing locally"> |
| <meta property="og:type" content="website"> |
| <meta property="og:url" content="https://www.eclipse.org/hono/sandbox/" /> |
| <meta property="og:description" content="The Sandbox environment can be used to play around with Hono’s APIs without the need to set up a Kubernetes cluster and install Hono manually."> |
| <meta property="og:image" content="https://www.eclipse.org/hono/img/sharing-default.png"> |
| <meta property="og:image:type" content="image/png"> |
| |
| |
| |
| <meta property="og:image:width" content="1655"> |
| <meta property="og:image:height" content="827"> |
| |
| |
| |
| |
| |
| |
| <meta name="twitter:card" content="summary"> |
| <meta name="twitter:site" content="@EclipseHono"> |
| <meta name="twitter:title" content="Try Hono without installing locally"> |
| |
| <meta name="twitter:image" content="https://www.eclipse.org/hono/img/sharing-default.png"> |
| |
| <meta name="twitter:description" content="The Sandbox environment can be used to play around with Hono’s APIs without the need to set up a Kubernetes cluster and install Hono manually."> |
| |
| |
| </head> |
| |
| |
| <body> |
| |
| <div id="all"> |
| |
| <header> |
| |
| <div class="navbar-affixed-top" data-spy="affix" data-offset-top="200"> |
| |
| <div class="navbar navbar-default yamm" role="navigation" id="navbar"> |
| |
| <div class="container"> |
| <div class="navbar-header"> |
| <a class="navbar-brand home" href="/hono/"> |
| <img src="https://www.eclipse.org/hono/img/HONO-Logo_Bild-Wort_quer-s-310x120px.svg" alt="Try Hono without installing locally logo" class="logo"> |
| <span class="sr-only">Try Hono without installing locally - go to homepage</span> |
| </a> |
| <div class="navbar-buttons"> |
| <button type="button" class="navbar-toggle btn-template-main" data-toggle="collapse" data-target="#navigation"> |
| <span class="sr-only">Toggle Navigation</span> |
| <i class="fas fa-align-justify"></i> |
| </button> |
| </div> |
| </div> |
| |
| |
| <div class="navbar-collapse collapse" id="navigation"> |
| <ul class="nav navbar-nav navbar-right"> |
| |
| |
| |
| <li class="dropdown"> |
| |
| <a href="/hono/getting-started/">Getting started</a> |
| |
| </li> |
| |
| |
| <li class="dropdown"> |
| |
| <a href="/hono/docs/">Documentation</a> |
| |
| </li> |
| |
| |
| <li class="dropdown"> |
| |
| <a href="/hono/downloads/">Download</a> |
| |
| </li> |
| |
| |
| <li class="dropdown active"> |
| |
| <a href="/hono/sandbox/">Sandbox</a> |
| |
| </li> |
| |
| |
| <li class="dropdown"> |
| |
| <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Community <span class="caret"></span></a> |
| <ul class="dropdown-menu"> |
| |
| <li><a href="/hono/community/contributing/">Contributing</a></li> |
| |
| <li><a href="/hono/community/presentations/">Resources</a></li> |
| |
| <li><a href="/hono/community/get-in-touch/">Get in Touch</a></li> |
| |
| <li><a href="/hono/community/road-map/">Road Map</a></li> |
| |
| <li><a href="/hono/community/thankyou/">Thank you</a></li> |
| |
| </ul> |
| |
| </li> |
| |
| </ul> |
| </div> |
| |
| |
| <div class="collapse clearfix" id="search"> |
| |
| <form class="navbar-form" role="search"> |
| <div class="input-group"> |
| <input type="text" class="form-control" placeholder="Search"> |
| <span class="input-group-btn"> |
| |
| <button type="submit" class="btn btn-template-main"><i class="fas fa-search"></i></button> |
| |
| </span> |
| </div> |
| </form> |
| |
| </div> |
| |
| |
| </div> |
| </div> |
| |
| |
| </div> |
| |
| |
| |
| |
| </header> |
| |
| <div id="heading-breadcrumbs"> |
| <div class="container"> |
| <div class="row"> |
| <div class="col-md-12"> |
| <h1>Try Hono without installing locally</h1> |
| </div> |
| </div> |
| </div> |
| </div> |
| |
| |
| <div id="content"> |
| |
| |
| <div class="container"> |
| |
| <div class="row"> |
| |
| <div class="col-md-12"> |
| |
| <div> |
| <p>We are providing a publicly accessible Eclipse Hono™ <em>sandbox</em> environment at <code>hono.eclipseprojects.io</code>. |
| The main purpose of the system is to provide an environment for experimenting with devices and how to connect them to Hono without the need for setting up a local instance.</p> |
| <div class="alert alert-notice"> |
| <h4 class="alert-heading"><i class="fas fa-info-circle"></i> Deprecated domain name</h4> |
| <div>The sandbox used to be available at <code>hono.eclipse.org</code>. That domain name will still work for some time but |
| will eventually be disabled. Please update your URLs accordingly.</div> |
| </div> |
| <p>The sandbox hosts a Hono instance consisting of the same components as described in the <a href="/hono/getting-started/">Getting started Guide</a>. |
| All services are exposed via the same ports as used in the guide.</p> |
| <h2 id="take-note">Take note</h2> |
| <ul> |
| <li> |
| <p>The sandbox is intended for <strong>testing purposes only</strong>. Under no circumstances should it be used for any production use case. |
| It is also <strong>not allowed</strong> to register with nor publish any personally identifiable information to any of the sandbox’s services.</p> |
| </li> |
| <li> |
| <p>You can use the sandbox without revealing who you are or any information about yourself. The APIs of the Device Registry running |
| on the sandbox can be used anonymously for creating tenants, register devices and add credentials. However, data can only be added |
| but <strong>cannot be updated or removed</strong> using the corresponding APIs. This is to prevent others from tampering with your |
| tenants/devices/credentials. In order to minimize the risk of dissemination of data, all tenants, devices and credentials are |
| <strong>deleted periodically</strong>.</p> |
| </li> |
| <li> |
| <p>We do not collect nor share with third parties any of the data you provide when registering tenants, devices and credentials. |
| We also do not inspect nor collect nor share with third parties any of the data your devices publish to the sandbox.</p> |
| </li> |
| <li> |
| <p><strong>Play fair!</strong> The sandbox’s computing resources are (quite) limited. The number of devices that can be registered per tenant |
| is therefore limited to 100.</p> |
| </li> |
| <li> |
| <p>The sandbox will be running the latest Hono release or milestone (if available). However, we may also deploy a more recent nightly |
| build without further notice.</p> |
| </li> |
| <li> |
| <p>In order to minimize the risk of collisions of device identities and credentials and to reduce the risk of others <em>guessing</em> |
| your identifiers, you are advised to use <strong>non-trivial, hard-to-guess</strong> tenant and device identifiers (e.g. a UUID).</p> |
| </li> |
| <li> |
| <p>The Apache Artemis instance we use for brokering events is configured with a maximum queue size of 1MB, i.e. you can only buffer |
| up to 1 MB of events (per tenant) without having any consumer connected that actually processes the events. |
| Once that limit is reached, no more events will be accepted by the protocol adapters for the corresponding tenant. |
| In addition to that, events that are not consumed will automatically be removed from the queue(s) after five minutes.</p> |
| </li> |
| <li> |
| <p>The sandbox exposes its API endpoints on both a TLS secured as well as an unsecured port. The secure ports use a Let’s Encrypt |
| certificate so you should not need to configure a specific trust store on your client in order to interact with them. Please note |
| that when using the unsecured ports, the information you exchange with the sandbox might be exposed to eavesdroppers. |
| We therefore <strong>strongly suggest</strong> that you use the secure ports only, if possible! |
| When using the <a href="https://www.eclipse.org/hono/docs/admin-guide/hono-client-configuration/">Hono client</a> to access the sandbox' |
| Telemetry and/or Event APIs, make sure to not set a trust store explicitly but instead set the <em>tlsEnabled</em> property to <code>true</code>. |
| The command line client binary is available from the <a href="/hono/downloads/#binaries">downloads page</a> and |
| can be used to consume telemetry/event messages from the sandbox as below:</p> |
| <div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-sh" data-lang="sh"><span style="color:#75715e"># in directory where the hono-cli-*-exec.jar file has been downloaded to</span> |
| java -jar hono-cli-*-exec.jar --hono.client.host<span style="color:#f92672">=</span>hono.eclipseprojects.io --hono.client.port<span style="color:#f92672">=</span><span style="color:#ae81ff">15671</span> --hono.client.tlsEnabled<span style="color:#f92672">=</span>true --hono.client.username<span style="color:#f92672">=</span>consumer@HONO --hono.client.password<span style="color:#f92672">=</span>verysecret --tenant.id<span style="color:#f92672">=</span>DEFAULT_TENANT --spring.profiles.active<span style="color:#f92672">=</span>receiver |
| </code></pre></div><p>Note that only the <em>receiver</em> profile is activated but not the <em>ssl</em> profile.</p> |
| </li> |
| </ul> |
| <div class="alert alert-warning"> |
| <h4 class="alert-heading"><i class="fas fa-exclamation-triangle"></i> Warning</h4> |
| <div>Everybody who knows your tenant identifier will be able to consume data published by your devices and everybody who also knows the device identifier can read the registration information of that device.</div> |
| </div> |
| |
| </div> |
| |
| </div> |
| |
| </div> |
| |
| |
| </div> |
| |
| |
| |
| </div> |
| |
| |
| <footer id="footer"> |
| <div class="container"> |
| |
| <div class="col-md-4 col-sm-6"> |
| <h4>More</h4> |
| |
| <ul> |
| <li><a href="https://github.com/eclipse/hono" title="View Source Code on GitHub"><i class='fab fa-github'></i> GitHub Repository</a></li> |
| <li><a href="https://twitter.com/EclipseHono" title="Follow us on Twitter"><i class='fab fa-twitter'></i> Twitter</a></li> |
| <li><a href="https://gitter.im/eclipse/hono" title="Chat with us on Gitter"><i class='fab fa-gitter'></i> Chat with us</a></li> |
| <li><a href='/hono/community/thankyou/'>Thank you</a></li> |
| </ul> |
| |
| <hr class="hidden-md hidden-lg hidden-sm"> |
| |
| </div> |
| |
| |
| <div class="col-md-4 col-sm-6"> |
| |
| <h4>Eclipse Legal</h4> |
| |
| <ul> |
| <li><a href="http://www.eclipse.org/legal/privacy.php" target="_blank">Privacy Policy</a></li> |
| <li><a href="http://www.eclipse.org/legal/termsofuse.php" target="_blank">Terms of Use</a></li> |
| <li><a href="http://www.eclipse.org/legal/copyright.php" target="_blank">Copyright Agent</a></li> |
| <li><a href="http://www.eclipse.org/legal/" target="_blank">Legal</a></li> |
| <li><a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">License</a></li> |
| <li><a href="https://eclipse.org/security/" target="_blank">Report a Vulnerability</a></li> |
| </ul> |
| |
| <hr class="hidden-md hidden-lg"> |
| |
| </div> |
| |
| |
| <div class="col-md-4 col-sm-6"> |
| |
| <div class="eclipse-logos"> |
| <div class="pull-left"> |
| <a href="https://www.eclipse.org" target="_blank"> |
| <img src="https://www.eclipse.org/hono/img/eclipse_foundation_logo_wo.svg" id="logo-eclipse-foundation"/> |
| </a> |
| </div> |
| <div class="pull-right"> |
| <a href="https://iot.eclipse.org" target="_blank"> |
| <img src="https://www.eclipse.org/hono/img/iot-logo.png"/> |
| </a> |
| </div> |
| </div> |
| |
| </div> |
| |
| |
| </div> |
| |
| </footer> |
| |
| |
| |
| |
| |
| |
| |
| <div id="copyright"> |
| <div class="container"> |
| <div class="col-md-12"> |
| |
| <p class="pull-left">© 2019-2021 The Eclipse Hono Project</p> |
| |
| <p class="pull-right"> |
| Template by <a href="https://bootstrapious.com/p/universal-business-e-commerce-template">Bootstrapious</a>. |
| |
| |
| Ported to Hugo by <a href="https://github.com/devcows/hugo-universal-theme">DevCows</a>. |
| </p> |
| </div> |
| </div> |
| </div> |
| |
| |
| |
| |
| |
| </div> |
| |
| |
| |
| <script src="//code.jquery.com/jquery-3.1.1.min.js" integrity="sha256-hVVnYaiADRTO2PzUGmuLJr8BLUSjGIZsDYGmIJLv2b8=" crossorigin="anonymous"></script> |
| <script src="//maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script> |
| |
| <script src="//cdnjs.cloudflare.com/ajax/libs/jquery-cookie/1.4.1/jquery.cookie.min.js"></script> |
| <script src="//cdnjs.cloudflare.com/ajax/libs/waypoints/4.0.1/jquery.waypoints.min.js"></script> |
| <script src="//cdnjs.cloudflare.com/ajax/libs/Counter-Up/1.0/jquery.counterup.min.js"></script> |
| <script src="//cdnjs.cloudflare.com/ajax/libs/jquery-parallax/1.1.3/jquery-parallax.js"></script> |
| |
| <script src="/hono/js/front.js"></script> |
| |
| |
| <script src="/hono/js/owl.carousel.min.js"></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="//www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script> |
| |
| <script src="//iot.eclipse.org/assets/js/eclipsefdn.adopters.js"></script> |
| <script> |
| eclipseFdnAdopters.getList({ |
| project_id: "iot.hono", |
| selector: ".eclipsefdn-adopters", |
| logo_white: true |
| }); |
| </script> |
| |
| |
| </body> |
| </html> |
