Authorization
Just like any other Data Orchestrator component, Authorization is encapsulated in a token claim, in particular
the a_ch claim. However, the mechanism is rather different compared to a REST API, and uses
different verbs.
JOIN
The JOIN verb implies that a user can join a room. This only allows him to receive events and to
interact in a read-only fashion with the room itself. There is no restriction to which events a
user sees - if he is authorized to enter in a room, he will be capable of seeing all events flowing
in. More granular permissions can be done simply by creating more rooms in which different triggers
will be installed.
The JOIN verb has the following semantic: JOIN::<regex>, where regex matches a room name (the
room name is what follows rooms:<realm>: - the realm is implicit in the context of the
authorization token). For example, a user authorized with the JOIN::test.* claim in the test
realm will be able to join, for example, rooms:test:testthis, rooms:test:testme,
rooms:test:test. The realm is always implicit in the regex, as the token is authenticated in the
context of a Realm.
WATCH
The WATCH verb allows a user to install a Trigger within a room. Its semantics define which kind
of trigger, and upon which entities the user is allowed to act. Watch semantics are
WATCH::<regex>, where regex is a regular expression which matches a device, path or interface
(or a mixture of them) in almost very same fashion as the a_aea claim (which is used in
AppEngine).
Given different kind of triggers impact different Data Orchestrator entities, the Authorization claim
implicitly defines which kind of triggers a user will be able to install. For example,
f0VMRgIBAQAAAAAAAAAAAA/org.astarte-platform.genericsensors.Values.* will allow installing data
triggers such as the one shown in the previous example, but won't let the user install device-wide
triggers (such as connect/disconnect events). A claim such as f0VMRgIBAQAAAAAAAAAAAA or
f0VMRgIBAQAAAAAAAAAAAA.*, instead, will allow device-level triggers to be installed.