21.01.2021 // API Meeting

Bootstrap Interface, für Informationen ohne Authentifizierung Von dort aus kann man sich dann Authentifizieren

Bootstrap Interface:

• Serverinformationen
• sich authentifizieren
• Ping
• (Post Prototype) Server-Module auslesen

Maschine Subsystem:

• Maschinen lesen

• Maschinen reservieren

• Maschinen editieren

• Maschinen (als Dummy / ohne weitere Informationen) erstellen (Nur fuer 3rd party client)

  • QR-Code TIS-23D => Maschine ID <namespace>/TIS-23D => Permission bffh.machine.create.<namespace>.*

• Tags - Key / Value

  • Key: Position - Value: Map Kind $Value
    • Key: Static - Value: struct Position on a map
  • Key: Preise - value: ??
    • Super wichtig fuer foederierte Aktionen wo Preise von $zuhause zu $foederiertemVerein unterschiedlich sind.
  • Key: Stromverbrauch - Value: Ampere-Wert
  • Key: Custom(String) - Value: Leaf Bytes (Tree Bytes)

    Good:

    • Key: "https://lastenrad.de/fabaccess-ns/kilometerstand" - Value: Varint

    Bad:

    • Key: "varint" - Value: Bool

• Metadaten

Permission Subsystem (Admin):

• Berechtigungen lesen
• Berechtigungen erstellen
• Berechtigungen editieren
• Nutzer lesen
• Nutzer erstellen
• Nutzer editieren

Interaction Subsystem:

• Mapping Initiator => Machine (Event)
  • kommt ungefragt und asynchron rein
  • FabAccess weiß vorher was kommt
  • .. um einen Wert einer Maschine (z.B. aus/an) zu ändern
• Mapping Machine => Actor (Actor)
• Mapping Sensor => Machine (Behaviour)
  • wird von FabAccess regelmäßig abgefragt
  • oder kommt ungefragt und asynchron rein
  • .. Wert der draussen aktuell ist und zur weiteren Verarbeitung zur Verfügung steht.
• Effekte / Rule (Effect) (Event / Behaviour -> Event / Behaviour)
  • Kann (wenn das gut ist) NodeRed verwenden.
  • Oder ähnlich wie in OpenHAB.
    • ... gerne textbasiert & funktioniert
    • wenn web/app/...-basiert gerne auch, Hauptsache funktioniert.

Föderation Subsystem:

• Nutzer validieren
• Rollen eines Nutzer auslesen koennen
• Alle (fuer den jeweiligen Server sichtbaren) Rollenbeschreibungen auslesen koennen
• Rollen sind immer lokal, koennen aber auf eine remote gruppe gemapt werden, i.e. als diese equivalent gesetzt werden
  • Remote user die in einer remote role sind kriegen damit trotzdem lokale roles

Authorisierung passiert auf Interface Level.

Über das Bootstrap Interface können mehrer Verbindungen aufgemacht werden.

Föderated Sachen sind immer authentifiziert über ein Zertifikat.

Audit Log