Sikkerhet i integrasjonen

Spire håndterer data om ekte selskaper og ekte mennesker. Denne siden er sjekklisten vi går gjennom med kunder før de går live. Sikkerhetssiden beskriver hva vi gjør på vår side.

Nøkler

• Én nøkkel per tjeneste, med minst mulige rettigheter. Se autentisering.
• Nøkler i miljøvariabler eller hemmelighetstjeneste, aldri i kode eller konfigurasjonsfiler i repoet.
• Lås produksjonsnøkler til IP-adresser når infrastrukturen tillater det.
• Roter nøkler minst årlig og alltid når en person med tilgang slutter.
• Bruk pk_live_ fra nettleser, aldri sk_live_.

Webhooks

• Verifiser signaturen på hvert kall, med den rå kroppen og en tidskontroll på 5 minutter.
• Lagre hendelses-ID-er og hopp over duplikater.
• Hold webhook-endepunktet på HTTPS med gyldig sertifikat. Vi sender ikke til HTTP.
• Ikke stol på data for kritiske beslutninger uten å hente objektet på nytt med GET, hvis beslutningen ikke tåler at objektet har endret seg siden.
• Begrens hvem som kan registrere webhooks (webhooks:admin).

Personopplysninger

Oppslag gir navn og fødselsår for roller. Signering gir navn og fødselsdato for signatarer. Varsling tar mobilnumre og e-postadresser. Alt dette er personopplysninger.

• Ha et formål for hvert felt du lagrer. Lagre ikke roller «for sikkerhets skyld».
• Slett eller anonymiser når formålet er oppfylt. Signerte avtaler trenger partenes navn; et avsluttet kundeforhold trenger ikke daglig leders fødselsår.
• Inngå databehandleravtale med Spire. Den ligger klar i dashbordet og signeres med Signering.
• Ikke send fødselsnummer til Spire. Bruk fodselsnummer_hash der identitet må låses.
• Varsling: bruk formaal: "marked" for markedsføring, så reservasjoner respekteres.

Logging

• Logg Spire-Request-Id for hvert kall. Det er det eneste du trenger for å få hjelp.
• Logg aldri Authorization-hodet, webhook-hemmeligheter eller kroppen i kall som inneholder personopplysninger.
• SDK-enes logger-innstilling gir deg metode, sti, status og tid, uten hemmeligheter.

Før du går live

1. Alle kall går gjennom SDK eller har gjenforsøk med Idempotency-Key.
2. Webhook-mottaker svarer 200 innen 10 sekunder og behandler asynkront.
3. Feilhåndtering har en default-gren som logger og varsler.
4. Hastighetsgrensen er testet: hva skjer i koden din ved 429?
5. Forbrukstak er satt i dashbordet, så en feil i en løkke ikke blir en regning.
6. Produksjonsnøkkelen er en annen enn testnøkkelen, og testnøkkelen finnes ikke i produksjonsmiljøet.
7. Noen hos dere får e-post fra Spire om hendelser, kvoter og nøkkellekkasjer. Sett opp en felles adresse, ikke en persons.

Melde sikkerhetsproblemer

Finner du en sårbarhet i Spire, SDK-ene eller dokumentasjonen, meld den via kontaktskjemaet med emnet «Sikkerhet», eller kryptert med PGP-nøkkelen på sikkerhetssiden. Vi svarer innen én virkedag og publiserer ikke detaljer før det er rettet.