Skip to content

freaktechnik/thing-url-adapter

 
 

thing-url-adapter

This is an adapter add-on for WebThings Gateway which enables users to discover and add native web things to their gateway.

Note: This adapter consumes Web Thing Descriptions conforming to Mozilla's legacy Web Thing API specification. It will eventually be superceded by the wot-adapter which will consume W3C compliant Thing Descriptions instead.

Adding Web Things to Gateway

  • Usually, your custom web things should be auto-detected on the network via mDNS, so they should appear in the usual "Add Devices" screen.
  • If they're not auto-detected, you can click "Add by URL..." at the bottom of the page and use the URL of your web thing.
    • If you're trying to add a server that contains multiple web things, i.e. the "multiple-things" examples from the webthing-python, webthing-node, or webthing-java libraries, you'll have to add them individually. You can do so by addressing them numerically, i.e. http://myserver.local:8888/0 and http://myserver.local:8888/1.

Secure Web Things

  • Web things that require jwt, basic or digest authentication can be supported by adding configuration options on the adapter page.

  • To add a secure web thing:

    • Use the hamburger to open the side menu and select "Settings".

    select_settings.png

    • Select "Add-ons".

    select_addons.png

    • Find the Web Thing adapter and select "Configure".

    select_configure.png

    • Enter data relevant to the desired authentication method.
    • To manually enter device URLs with no authentication select 'none' for the method.

    enter_data.png

    • Save the entry by pressing "Apply" at the bottom of the page.

About

Proxy adapter for Web Thing API endpoints

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 98.6%
  • Shell 1.4%