Commissioning and first steps
37/136
4.5
"Onboard" (register) device in netFIELD Cloud
4.5.1
Overview
If you connect your device via Internet to the netFIELD Cloud
(
), you can install containers and manage your
device from the netFIELD Portal, which is the web-based user interface of
the netFIELD Cloud. You can also stream MQTT messages from your
device to 3rd party applications via the RESTful API of the netFIELD
Platform, which is the backend of the netFIELD Cloud.
This section describes how to register your device in the netFIELD Portal.
Note:
Connecting your device to the netFIELD Cloud requires an account/
subscription for the
netFIELD Cloud services
Contact your local Hilscher sales representative for information on
terms and conditions.
Before your device can be managed from the portal, it must first complete a
one-time registration process, called “onboarding”.
This process is initialized by the device itself, not by the portal. There are
three different onboarding methods:
Zero-Touch
,
Basic
and
Advanced
.
With the
Zero-Touch
method, the device registers itself automatically in the
portal after it has been put into operation. Note that this method is
implemented only in certain customer-specific Edge Device models.
With the
Basic
and
Advanced
methods, you start the registration process
by locally entering authentication data in the
Onboarding
page of the
Local
Device Manager
:
With the
Basic
method, you simply need to enter your netFIELD Portal’s
login credentials (if your user “role” in the portal entails permissions to
“onboard” and “create” devices).
With the
Advanced
method (which allows onboarding in a certain separate
instance of the netFIELD Portal), you must enter an
Activation Code
,
an
API Key
and an
API End-Point
URL. You must research
(respectively create) these parameters in the portal beforehand, then insert
them in the
Onboarding
page of the Local Device Manager via clipboard
(“copy and paste”). For the
Advanced
method, you therefore ideally need
simultaneous access to the portal and the device in order to be able to copy
the data from the portal conveniently into the corresponding fields of the
Onboarding
page of the Local Device Manager.
netFIELD Compact X8M | User manual
DOC220302UM01EN | Revision 1 | English | 2022-05 | Released | Public
© Hilscher 2022
