Skip to main content
Credit Benchmark-API-et bruker maskin-til-maskin-autentisering (M2M). Vi registrerer maskiner, ikke personer. En maskin kan være en server i ditt datasenter eller i skyen, eller noens bærbare PC. Hver enkelt får sin egen identitet hos oss, og ingen trenger å skrive inn brukernavn eller passord for at den skal kunne koble seg til. Denne identiteten er et par digitale nøkler som du oppretter på maskinen:
  • Den private nøkkelen forblir på maskinen og bekrefter at det er denne som sender forespørslene.
  • Den offentlige nøkkelen er den tilsvarende halvdelen. Du sender den til oss, vi registrerer den, og vi bruker den til å kontrollere at hver forespørsel virkelig kommer fra din maskin.
Siden den private nøkkelen aldri deles, er det ingen passord eller delte hemmeligheter som kan gå tapt.
Standarden bak dette er OAuth 2.0 med JWT-klientautentisering med privat nøkkel (RFC 7523). Maskinen din signerer en kortvarig forespørsel med sin private nøkkel, vi sjekker signaturen mot den offentlige nøkkelen du har registrert, og deretter utsteder vi et tilgangstoken. Nøklene bruker ES256-algoritmen på den elliptiske kurven P-256.

​
Kort om pålogging

1

Generer et nøkkelpar

Opprett et ES256-nøkkelpar på maskinen som skal kalle API-et. Se Konfigurering av nøkkelpar.
2

Send oss den offentlige nøkkelen

Send kun es256-public.pem, sammen med fingeravtrykket og opplysningene fra oppstartsprosessen, til din kontaktperson hos Credit Benchmark.
3

Motta velkomstpakken

Vi registrerer nøkkelen og sender deg en oppstartspakke med klientopplysningene dine og eksempler på skript som kan kjøres.
4

Be om tilgangstokener

Maskinen din signerer en kortvarig klientassertjon med sin private nøkkel og sender den til tokenendepunktet. Vi verifiserer signaturen mot den offentlige nøkkelen som er registrert under din KID og returnerer et tilgangstoken. Se Be om et tilgangstoken.

​
Hva du mottar tilbake

Så snart vi har registrert den offentlige nøkkelen din, sender vi deg en oppstartspakke. Den inneholder tre opplysninger som gjør nøkkelen din om til en fungerende pålogging, i tillegg til eksempelskript i Python og Node.js. Ingen av opplysningene er hemmelige, men oppbevar dem sammen med integrasjonskonfigurasjonen din.
Tokenendepunktet er https://gateway.creditbenchmark.com/api/security/token og «audience»-verdien er cb-gateway-m2m-blue. Onboarding-pakken din inneholder begge deler.