Gå till innehållet

Användare

MIVO Connect stöder flera typer av användare.
Det finns två typer av användare:

  • Vanliga användare
  • API-användare

Vanliga användare#

Vanliga användare är "mänskliga användare" som kan logga in via en standard webbaserad inloggning.

Det finns en standardanvändare kallad admin med administratörsbehörighet. Denna användare kan inte tas bort.

Användarroller#

Vi stöder flera användare med två roller:

  • Administratör (Administrator)
  • Användare (User)

Skillnader mellan roller#

Administratör

  • Kan skapa och ta bort andra användare
  • Har full åtkomst till användarhantering

Användare

  • Kan endast visa och redigera sitt eget konto
  • Kan inte hantera andra användare

Mer granulära roller och behörigheter är för närvarande under utveckling.

API-användare#

API-användare är avsedda för system-till-system-kommunikation och är inte kopplade till interaktiv (mänsklig) användning.

De autentiserar med OAuth2 med autentiseringsmetoden private_key_jwt för att erhålla en Bearer-token, som sedan används vid API-anrop.

API-användare: - Kan inte logga in via webbgränssnittet - Representerar applikationer eller externa system - Används uteslutande för API-åtkomst och integrationer - Autentiserar genom att generera en signerad JWT och utbyta den mot en åtkomsttoken

Autentisering#

API-användare erhåller en åtkomsttoken via endpointen /api/token.

Detta kräver: - grant_type=client_credentials - Ett client_id - En signerad JWT (client_assertion) med klientens privata nyckel

Den utfärdade token: - Är en Bearer-token - Innehåller rollen APIUser - Måste inkluderas i API-anrop via Authorization-headern

API-funktionalitet#

API-användare interagerar med systemet via ett REST-API med fokus på sensordata och styrning.

Tillgängliga operationer inkluderar:

  • Lista aktiva sensorer
    GET /api/MivoAPI/v1/ListActiveSensors
    Returnerar alla sensorer med en giltig licens

  • Läs sensordata
    POST /api/MivoAPI/v1/ReadSensor/{uid}
    Hämtar värden och statusinformation för en specifik sensor

  • Skriv sensorvärden
    POST /api/MivoAPI/v1/WriteValues
    Skriver ett eller flera värden till sensorer (t.ex. börvärden eller konfiguration)

Alla endpoints: - Kräver en giltig Bearer-token - Använder JSON-format för request och response

Sensordatamodell#

Sensorer identifieras med ett unikt UID och exponerar flera värden såsom: - Temperatur - Energiförbrukning - Flöde och volym - Spänning, ström och effekt - Status- och felkoder

Sensoravläsningar inkluderar: - En tidsstämpel - En resultat-/statuskod - En lista med uppmätta värden - Valfria status- eller larmindikatorer

API-dokumentation (Swagger)#

Alla endpoints och datamodeller dokumenteras via Swagger (OpenAPI), tillgängligt på:

http://<device-hostname-or-ip>/swagger