Fullmakt Rails

I drift, med testadapter. Fullmakt Rails-endepunktene er kallbare i dag over både REST og MCP-serveren, men Altinn-integrasjonen bak dem kjører i testmodus i påvente av partnervalidering i produksjon. Responsformen er identisk i begge moduser. Ingenting her er en juridisk garanti.

Fullmakt Rails er Apiers myndighetslag: infrastrukturen som lar et norsk selskap gi en AI-agent et avgrenset mandat til å handle på selskapets vegne, og trekke det tilbake når som helst. I stedet for at agenten holder selskapets rå legitimasjon, delegerer selskapet en avgrenset fullmakt gjennom en Altinn systembruker, og hver handling agenten gjør kontrolleres mot delegeringen før den når et offentlig endepunkt.

Målet er en delegering som er avgrenset (begrenset til navngitte handlinger, ikke full tilgang), tilbakekallbar (selskapet kan trekke den, og agentens myndighet opphører) og sporbar (hver bruk registreres). Apier formidler dette gjennom Altinns autorisasjonsmodell (vi finner ikke opp en parallell modell), slik at myndigheten en agent holder er den samme myndigheten et norsk selskap kan gi, se og tilbakekalle i Altinn.

Hvem det er for

• Virksomheter som vil la en AI-agent håndtere en smal, veldefinert regulatorisk oppgave uten å gi agenten stående tilgang til alt organisasjonen kan gjøre i Altinn.
• Agentutviklere som bygger på Apier og trenger å kunne be om en fullmakt fra maskin til maskin, sjekke om de holder den, og levere den tilbake, uten at et menneske må klikke seg gjennom en portal ved hver kjøring.

Slik virker det

• Delegeringen bor i Altinn. Selskapet gir en systembrukerdelegering; Apier leser og handler innenfor den, aldri utenfor.
• Maskinporten-token. Adapteren bruker i dag et Maskinporten-token basert på scopes for delegeringsforespørselen. Tokenutveksling med RAR per organisasjon er ennå ikke koblet til denne flyten.
• Tilgangspakkekontroll ved bindende handlinger. Før en handling videresendes til et offentlig API, kontrolleres delegeringen mot tilgangspakkene på /api/v1/actions/execute. Kontrollen slipper forespørselen gjennom ved tvil og styres av et flagg: Den avviser kun når en verifisert katalogkobling viser at den registrerte pakken mangler, så et hull i tilordningen blokkerer aldri en reell fullmakt. Verifisering mot Altinns Policy Decision Point (PDP) i produksjon er fortsatt under arbeid. Apiers registrerte delegeringstilstand er foreløpig data for denne lokale kontrollen, ikke en bekreftelse fra Altinn på hvilke tilgangspakker selskapet har.

Endepunkter

Endepunktene /api/v1/fullmakt/request, /api/v1/fullmakt/{org} og /api/v1/fullmakt/revoke er Fullmakt Rails-flaten. Alle tre er kallbare i dag over REST og MCP; Altinn-integrasjonen bak dem kjører i testmodus i påvente av partnervalidering i produksjon, og responsformen er identisk i begge moduser. Scope på hvert endepunkt er det aktive read:altinn, aldri det reserverte delegate:* som holder den rå ruten for systembrukerdelegering menneskestyrt.

MCP-verktøy

De samme tre operasjonene er kallbare over Apiers MCP-server som request_fullmakt, check_fullmakt og revoke_fullmakt, slik at en agent kan formidle, sjekke og tilbakekalle en fullmakt gjennom Model Context Protocol uten å bygge en REST-klient for hånd. Se den engelske Fullmaktsdokumentasjonen for de fulle signaturene for forespørsel og svar.