Servicekonton

Last updated: March 30, 2026

För att använda servicekonton krävs att organisationen har produkten "Servicekonton" samt att du som användare har rollen "Kan hantera servicekonton". För hjälp med att sätta upp detta kontakta Bemlo.

Användning

Servicekonton används för att enklare göra anrop mot Bemlos API. Precis som vanliga användare kan de ha namn, behörigheter och enhetstillhörigheter.

Det som skiljer dem åt är möjligheten att koppla en eller flera API-nycklar till varje servicekonto. Detta förenklar autentiseringen eftersom inga tokens behöver hämtas eller uppdateras, till skillnad från inloggning via lösenord eller SSO.

Hantera servicekonton

Användare med rollen "Kan hantera servicekonton" kan skapa och redigera konton via Inställningar → Servicekonton.

Lista över servicekonton
Lista över servicekonton

Skapa servicekonto

När du skapar ett servicekonto behöver du fylla i tre fält:

  • Visningsnamn – används i eventloggar där servicekontot har varit aktivt.

  • Konto-ID – används för att skapa en unik e-postadress som identifierar kontot. E-postadressen får formatet:
    account-id@organization-id.bemloapi.ai

  • Beskrivning – visas på inställningssidan.

Screenshot 2025-11-18 at 14.30.49.png

Uppdatera servicekonton

Du kan när som helst uppdatera ett servicekonto från inställningssidan och ändra visningsnamn, beskrivning samt roller. När ett servicekonto skapas har det inga behörigheter och kan därför varken läsa eller skriva information.

Genom att klicka på servicekontot i listan öppnas en sidomeny där du kan lägga till eller ta bort behörigheter och roller.

Observera: Bemlo rekommenderar att servicekonton endast får de behörigheter som absolut krävs för deras avsedda användning. Skapa hellre flera separata servicekonton för olika ändamål än ett enda konto med breda rättigheter.

Hantera nycklar

Varje servicekonto kan ha flera API-nycklar kopplade till sig. Du kan enkelt skapa nya nycklar eller stänga av befintliga från inställningssidan. Vi rekommenderar att du namnger nycklarna för att hålla koll på var de används.

Nyckeln visas endast direkt efter att den skapats, så se till att kopiera och spara den på ett säkert ställe.

Screenshot 2025-11-18 at 11.57.50.pngimage.png

Från inställningssidan kan du se alla API-nycklar och när som helst stänga av en. Notera att en avstängd nyckel inte kan återaktiveras.

image.png

Autentisera som servicekonto

För att göra anrop till Bemlos API som ett servicekonto behöver du en aktiv API-nyckel. Skicka nyckeln i headern Authorization enligt nedan:

Authorization: Api-Key <sk_api-key>

Där <sk_api-key> ersätts med servicekontots API-nyckel. Alla API-nycklar som genereras för servicekonton i Bemlo har prefixet sk_.

Testa servicekonto

För att testa nyckeln kan du prova att hämta information om kontot.

Grund-URL:n varierar beroende på miljö, så kontakta Bemlo för att få rätt URL för er organisation.

REST

Skicka en GET-förfrågan till:

{bemlo-api-url}/internal/auth/me