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

# Konfigurering av ES256-nøkkelpar

> Generer, verifiser, beskytt, registrer og roter ES256-nøkkelparet som benyttes for maskin-til-maskin-tilgang til Credit Benchmark API.

Du vil ende opp med to filer:

* `es256-private.pem`: oppbevar denne på maskinen som anroper API-et vårt. Del den aldri via e-post, chat, supportbillett eller koderepositorium.
* `es256-public.pem`: send dette til oss for oppstart.

## Før du begynner

Du trenger **OpenSSL 3.0 eller nyere**. Sjekk med:

```bash theme={null}
openssl version
```

* **Windows:** installer den via winget, Chocolatey eller Git for Windows.
* **macOS:** den innebygde versjonen kan være LibreSSL. Kjør `brew install openssl` hvis utdataene ikke viser OpenSSL 3 eller nyere.

Dersom terminalen din melder at `openssl` ikke gjenkjennes, må du installere den og åpne et nytt terminalvindu.

> [!NOTE]
>
> Generer nøklene på maskinen som skal kalle API-et vårt, enten det er en server eller en bærbar PC, slik at den private nøkkelen aldri trenger å kopieres til et annet sted.

## Trinn 1: Generer nøklene

Kjør disse kommandoene i PowerShell, Kommandoprompt, bash eller zsh. Den første oppretter den private nøkkelen (EC P-256, PKCS#8-format). Den andre genererer den tilhørende offentlige nøkkelen.

```bash theme={null}
openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:P-256 -pkeyopt ec_param_enc:named_curve -out es256-private.pem
openssl pkey -in es256-private.pem -pubout -out es256-public.pem
```

## Trinn 2: Bekreft nøklene

Kjør disse kommandoene før du sender noe.

```bash theme={null}
openssl pkey -in es256-private.pem -check -noout
openssl pkey -pubin -in es256-public.pem -text -noout
```

Sjekk at:

* Den første kommandoen skriver ut `Key is valid`.
* Den andre viser `ASN1 OID: prime256v1` og `NIST CURVE: P-256`.
* `es256-private.pem` begynner med `-----BEGIN PRIVATE KEY-----`.
* `es256-public.pem` begynner med `-----BEGIN PUBLIC KEY-----`.

Dersom den private nøkkelen begynner med `BEGIN EC PRIVATE KEY`, konverter den til PKCS#8:

```bash theme={null}
openssl pkcs8 -topk8 -nocrypt -in old-key.pem -out es256-private.pem
```

## Trinn 3: Beskytt den private nøkkelen

> [!WARNING]
>
> Enhver som har `es256-private.pem` kan be om tokens på vegne av organisasjonen din. Behandle den som et produksjonspassord.

Begrens tilgangen til kontoen som kjører integrasjonen din:

```bash Linux or macOS theme={null}
chmod 600 es256-private.pem
```

```powershell Windows PowerShell theme={null}
icacls es256-private.pem /inheritance:r /grant:r "$($env:USERNAME):R"
```

* I produksjonsmiljøet bør du lagre den i en hemmelighetsbehandler, for eksempel Azure Key Vault, AWS Secrets Manager eller HashiCorp Vault.
* Send den aldri via e-post, legg den ikke ved en supportbillett, lim den ikke inn i en chat eller legg den ikke inn i et repositorium. Hvis du tester med Postman, oppbevar den i Postman Vault eller kun som en midlertidig verdi.
* Hvis du tror den har lekket, må du gi oss beskjed umiddelbart.

## Trinn 4: Send oss den offentlige nøkkelen

Send kun `es256-public.pem` til din Credit Benchmark-kontakt. Inkluder:

* Navnet på organisasjonen din
* Miljø (Sandkasse eller Produksjon)
* En teknisk kontaktperson
* Omfangene du trenger
* Nøkkelens fingeravtrykk

Vi bruker fingeravtrykket til å bekrefte at nøkkelen ikke ble endret under overføringen. Beregn det med:

```bash theme={null}
openssl pkey -pubin -in es256-public.pem -outform DER -out es256-public.der
openssl dgst -sha256 es256-public.der
```

Bruk et eget nøkkelpar for hvert miljø. Før du sender, må du kontrollere at vedlegget `es256-public.pem` og at det ikke er vedlagt noen privatnøkkelfil. Vi kan ringe din tekniske kontaktperson for å få bekreftet fingeravtrykket før nøkkelen aktiveres.

Så snart nøkkelen er registrert, sender vi deg velkomstpakken din. Se [hva du mottar tilbake](/api-reference/authentication/overview#what-you-receive-back).

## Nøkkelrotasjon

Bytt ut nøkkelparet minst én gang hvert 12. måned, eller umiddelbart dersom den private nøkkelen kan ha blitt kompromittert.

**1. Generer et nytt nøkkelpar**

Gjenta trinn 1 og 2 med nye filnavn, for eksempel `es256-private-2027.pem`.

**2. Send den nye offentlige nøkkelen**

Send den som i trinn 4, med emnet `M2M API key rotation - [Your organisation name] - [Environment]` og din eksisterende `OAuthClientId`.

**3. Motta en ny KID**

Vi svarer med en ny `KID`. Din `OAuthClientId` endres ikke.

**4. Bytt over**

Bytt integrasjonen din til den nye private nøkkelen og `KID`, og gi oss beskjed. Vi tilbakekaller den gamle `KID` , og du sletter den gamle private nøkkelen på en sikker måte.

> [!WARNING]
>
> Ved mistanke om lekkasje, hopp over overlappingsperioden og be oss om å tilbakekalle den gamle nøkkelen umiddelbart.


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