Grounds are distinct areas of the platform which group relevant IoT resources together, allowing for easier access management, delegation and separation of concerns.
A ground allows people with common interest to build and share their IoT devices, assets and data either internally within a team, externally to a selected audience or publicly with everyone. This enables better collaboration between people who are building and maintaining common IoT resources.
You can organize your IoT product and applications within multiple usage contexts, for example projects, business units, customer segments, facilities, apartments, rooms, homes, common spaces, locations and so on…
You are granted full access to manage all resources of a ground that you own, while you have limited access to the resources of grounds that you have joined as member.
As a user, you can add new grounds to your environment, in order to clearly distinct one usage area from another. In order to create new ground, all you need is a valid name (title). The system will then create a public but unlisted ground.
You can modify the title of a ground that you own, so it better tells what’s behind it. Once you change it, the new title becomes available to everyone who is visiting your ground.
As a ground owner, you can allow people in your ground to co-manage devices and rules together with you.
📘 Read more about Ground permissions
You can delete any ground that you own, given you have previously removed all native devices from that ground.
Once the ground is deleted, none of the previous members will be able to access or revive it.
When you create a ground, it’s by default made public. Once you share the URL of the ground with another user that you trust, they will be able to view the ground name and pulse.
⚠️ If someone (usually an owner) has shared a public ground’s URL with you, you are able to view the ground’s title and pulse even you are not it’s member.
People that collaborate with you in a ground are called members. A ground can have unlimited number of members.
Being a ground owner or member, you can view basic info (such as usernames) of all members of that ground.
As a ground owner, you can add ground members by providing their username or email address.
As the ground owner, you can always decide to remove a member from the ground, so she doesn’t have the access to the ground resources.
Ground tokens allow client applications to access multiple resources within a ground. Best example is a client that wants to access all devices and their assets within a single ground.
✉️ Let us know if you want to read more about how to use ground tokens. We are currently preparing a tutorial about it
When you create a new ground, a ground token is generated.
You can create unlimited number of ground tokens for each ground. By having multiple ground tokens, you can delegate and manage ground access for multiple client applications.
For each ground, you can view all the generated ground tokens.
After you revoke a ground token, system will prevent any access to ground resources to the clients that continue to present the revoked token.
By default no one can join ground if not explicitly invited (or added) by the ground owner.
Specifically, when you create a ground that anyone can join, and share the ground’s URL with an audience, anyone with an account can join your ground and therefore become it’s member.