AiHummer
Svenska▾
Logga inKonto
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Säkerhet/RBAC och begränsade API-nycklar

RBAC och begränsade API-nycklar

v1.0.x · uppdaterad 2026-07-07

AiHummer skyddar sin administrativa yta med rollbaserad åtkomstkontroll och begränsade API-nycklar. Roller bestämmer vem en person får vara; scoped-nycklar låter dig ge en automatisering endast de privilegier den faktiskt behöver, istället för en nyckel som kan göra allt.

Roller

Åtkomst till administrations-API:et och administrationsgränssnittet styrs av roller. En roll bestämmer vilka resursgrupper en principal kan se och vilka de kan ändra.

Roller hanteras på administratörsgränssnitten Roller sida. Direkt ur lådan finns det inbyggda roller — owner (allt), admin, operator och member — som är skrivskyddade (markerade med en “Inbyggd”-badge; de kan inte redigeras eller raderas). Utöver dem kan du skapa anpassade roller: rollformuläret tar ett namn, en beskrivning och ett behörighetsnät — läsa/skriva kryssrutor för var och en av ~19 resursdomäner (agenter, konversationer, verktyg, hemligheter, plugins, inställningar, godkännanden, API-nycklar och så vidare; “skriva” innebär automatiskt “läsa”). Varje roll visar hur många ämnen som använder den; en roll som är tilldelad någon kan inte tas bort förrän tilldelningarna tas bort.

Kombinera roller med de andra kontrollerna på denna webbplats — IP-tillåtelselista, företags-SSO och den revisionslogg — så att varje administrativ åtgärd både är auktoriserad och dokumenterad.

Begränsade API-nycklar

API-nycklar bär omfång som begränsar vad nyckeln kan göra. De definierade omfången är:

Omfattning Bidrag
chat Slutbrukarens OpenAI-kompatibla slutpunkt (standard för gamla nycklar).
admin:read Endast-läsning åtkomst till adminresurser (GET /v1/admin/*: inställningar, konversationer, analyser etc.).
admin:write Muterande administratörs-API-anrop (POST/PUT/DELETE /v1/admin/*).
mcp Den publicerade MCP-slutpunkten (POST /v1/mcp).
a2a Den publicerade Agent-till-Agent slutpunkten (POST /a2a/message).
* Fullständig åtkomst till allt (det verkliga fullständiga åtkomstomfånget).

Dessutom, ett generiskt <area>:* jokertecken fungerar: admin:*, till exempel bidrag varje administratörsåtgärd men gör inte bevilja chat, mcp eller a2a — det är inte ett separat definierat omfång, bara ett fall av jokertecknet. Endast * ger full tillgång till alla ytor.

Nycklar som präglades innan scopes fanns fortsätter att fungera utan begränsningar; nya nycklar kan präglas med ett smalt scope så att till exempel en instrumentpanel som bara läser statistik aldrig har en nyckel som kan ändra inställningar.

[!TIP] Tillämpa minsta privilegium: en övervaknings- eller rapporteringsintegration bör få en admin:read nyckel, inte admin:write — än mindre *. Reserv * för nycklar som verkligen behöver tillgång till varje yta.

Att välja rätt sikte

  • Chattklienter (ringa OpenAI-kompatibel endpoint) → chat.
  • Endast-läsning-integrationer (instrumentpaneler, exportörer, statuskontroller) → admin:read.
  • Automatisering som skapar eller redigerar resurser (försörjningsagenter, importerar kunskap, hantering av scheman) → admin:write.
  • MCP- och A2A-klienter → mcp och a2a respektive.
  • Bryt-glas / full åtkomst → *, hålls med så få tangenter som möjligt och roteras regelbundet.

[!WARNING] En scoped-nyckel är fortfarande ett autentiseringsmedel till admin-API:et. Förvara den i hemlighetsvalv eller din egen hemliga hanterare, aldrig i källkontroll, och rotera det om det kan ha blivit utsatt.

Hur nycklar hanteras

Admin API-nycklar hanteras genom admin-API:t (/v1/admin/apikeys) och administratörsgränssnittet, där du skapar en nyckel, tilldelar dess omfattning och återkallar den när den inte längre behövs. Eftersom administratörs-API:et i sig är skyddat av OIDC och IP-vitlistan, att mynta en nyckel är en autentiserad, granskad operation.

Vart härnäst