Felles steg for å komme i gang med Altinn Broker
Hvordan komme i gang med Altinn 3 Broker, for både tjenesteeiere, avsendere og mottakere
På denne siden:
Dette er felles steg som alle roller (tjenesteeier, avsendere og mottakere) må gjennomføre for å begynne å bruke Altinn Broker-komponenten.
1. Skaff deg en Altinn API-nøkkel
For å bruke noen Altinn-API-er trenger du en abonnementsnøkkel for API-ene. Denne sendes som headeren Ocp-Apim-Subscription-Key
i hvert forespørsel.
Hvis du ikke allerede har en API-nøkkel for Maskinporten-klient(er) du har tenkt å bruke mot Broker, kan du skaffe den ved å kontakte oss på Altinn@Slack#produkt-formidling.
2. Registrer Maskinporten-klienten din med riktige omfang
Registrer Maskinporten-klienten(e) din for å autentisere mot Broker-API-en, tildel dem relevante omfang:
altinn:broker.write
- For klienter som sender filer.altinn:broker.read
- For klienter som mottar filer.
Disse omfangene vedlikeholdes av Altinn og må være autorisert for de riktige API-operasjonene, og er derfor uavhengige av tilgangen satt av tjenesteeiere for den spesifikke Broker-tjenesteressursen.
Bruk Samarbeidsportalen for selvbetjening for registrering. Her er en detaljert guide.
3. Få tilgang til en bestemt ressurs
Kontakt tjenesteeieren for Broker-ressursen og be om tilgang til ressursen, og oppgi:
- Organisasjonsnummeret du vil representere
- Systembrukeren
Hvis du er en tjenesteeier som oppretter din første Broker-tjeneste; gå videre til Tjenesteeier guiden.
4. Integrer mot Broker-API-et
Du er nå klar til å begynne å integrere mot Broker-API-ene, se utviklerveiledningene for neste trinn.
5. Sett opp hendelsesabonnementer
For å bruke hendelser/webhooks for en Broker-ressurs, må du sette opp et abonnement for den gitte ressursen.
Se utviklerveiledningen for events for detaljerte instruksjoner.