Hvordan opprette og administrere adgangsnøkler

Sti i CC5: Systeminnstillinger - Adgangskontroll - API-adgang

Denne beskrivelsen omtaler tilleggsfunksjonalitet. Snakk med din faste kontaktperson i House of Control hvis du ikke finner funksjonaliteten i din løsning og du vil vite mer om den.

Adgangsnøkkelen gir utviklere eller eksterne systemer tilgang til å opprette, lese, oppdatere og slette i systemet. Nøkkelen er unik for hvert API og begrenset i henhold til API-definisjonene.

Adgangsnøkkelen er også nødvendig for å få tilgang til API-dokumentasjonen på Swagger.

  1. Gå til Systeminnstillinger - Adgangskontroll- API-tilgang.

  2. Klikk deretter på New adgangsnøkkel for å opprette et nytt token for en bestemt tjeneste.

  3. Kryss av i alle boksene ved siden av endepunktene som skal være tilgjengelige:
    Hvis du krysser av for Systemregistre og Datakilder, får du ekstra tilgang til støtte-API-er for nedtrekkslister, egendefinerte registre osv.

  4. Du kan også angi en utløpsdato for tokenet. Hvis tokenet ikke skal utløpe, velger du Ingen utløpsdato.

  5. Klikk på Lagre.

Når tokenet er opprettet, må du gi det til utviklerne dine. Nå må du hvitliste den eksterne tjenestens IP og den ansvarlige utviklerens IP (for å få tilgang til utviklerdokumentasjonen om Swagger her).

Husk!
Opprett ett API per endepunkt du vil koble til: Hvis ett API skal brukes til å synkronisere personer med et HR-system, oppretter du én API-tilgang for dette. Hvis du deretter vil synkronisere eiendeler eller avtaler med et annet system, oppretter du en ny tilgang.

Du finner tokenet når du klikker på tittelen i oversiktslisten under Systeminnstillinger - Adgangskontroll - API-tilgang.