> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creditbenchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Maskin-til-maskin-autentisering

> Oversikt over maskin-til-maskin-tilgang (M2M) til Credit Benchmark API ved bruk av ES256-nøkkelpar og OAuth 2.0-klientautentisering med privat nøkkel (JWT).

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.

> [!NOTE]
>
> Standarden bak dette er OAuth 2.0 med JWT-klientautentisering med privat nøkkel ([RFC 7523](https://datatracker.ietf.org/doc/html/rfc7523)). 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](/api-reference/authentication/key-pair-setup).

**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](/api-reference/authentication/request-token).

## 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.

| Detaljer | Hva det er | Hvor du bruker det |
| - | - | - |
| `OAuthClientId` | Din klientidentifikator, en tilfeldig GUID som identifiserer organisasjonen din i systemet vårt | Den `iss` og `sub` påstandene i den signerte forespørselen din, samt `OAuthClientId` skjemafeltet |
| `KID` | Identifikatoren til den offentlige nøkkelen du sendte oss, slik at vi vet hvilken nøkkel vi skal sjekke mot | Hodet `kid` overskriften i den signerte forespørselen din |
| Tokenendepunkt | Nettadressen som utsteder tilgangstokener | Hvor du sender tokenforespørselen |

> [!TIP]
>
> Tokenendepunktet er `https://gateway.creditbenchmark.com/api/security/token` og «audience»-verdien er `cb-gateway-m2m-blue`. Onboarding-pakken din inneholder begge deler.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.