Hoppa till innehållet

Sök på Sweden Sites

Populära sökningar

Genvägar

Hittar du inte det du söker?

Till söksidan

BankID på din webbplats

Så lägger du till inloggning och signering med BankID – steg för steg, med färdiga kodexempel.

Så fungerar det

Din besökare loggar in med BankID på din webbplats i fyra steg. Du lägger in en knapp, resten sköter vi.

  1. 1Besökaren klickarpå BankID-knappen på din webbplats.
  2. 2Godkänner i BankID-appengenom att skanna QR-koden, eller direkt i mobilen.
  3. 3Din webbplats får en kodsom bevis på att någon har godkänt. Koden säger inte vem.
  4. 4Din server frågar oss vemoch får tillbaka namn och personnummer. Klart!

Det här behöver du

  • Site keyDin webbplats id hos oss.
  • Hemlig nyckelEtt lösenord som bara din server känner till.
  • Din domänInlagd i listan, till exempel www.example.se.

Allt finns på Mina sidor → BankID. Hämta dina nycklar →

Vill du hellre att vi kopplar in BankID åt dig? Kontakta oss

Kom igång

Det tar tre steg. Du klistrar in en kodsnutt på din webbsida, tar emot ett svar när personen är klar och låter din server fråga oss vem det var.

Steg 1: Lägg till BankID-knappen

Klistra in det här på sidan där knappen ska finnas. Byt DIN_SITE_KEY mot din site key från Mina sidor och adressen mot den sida personen ska komma till efteråt.

[[tabs: HTML]]

<link rel="stylesheet" href="https://authentication.swedensites.com/sdk/v1/bankid-sdk.min.css">
<script src="https://authentication.swedensites.com/sdk/v1/bankid-sdk.min.js"
        data-site-key="DIN_SITE_KEY"
        data-redirect-url="https://www.example.se/inloggad/"></script>

<button type="button" class="bankid-signin-btn">Logga in med BankID</button>

Det är allt som behövs i webbsidan. Knappen öppnar BankID-rutan, som visar en QR-kod på datorn och öppnar BankID-appen direkt på mobilen.

Steg 2: Personen godkänner

Personen godkänner i BankID-appen. Sedan skickas webbläsaren vidare till adressen du angav, med en kod på slutet:

https://www.example.se/inloggad/?bankid_auth_token=3f2a…c91e

Koden kallas token. Den säger ingenting om vem personen är. Den är en biljett som din server löser in i nästa steg.

Steg 3: Din server frågar vem det var

På sidan personen kommer till läser din server av koden och frågar oss vem det var. Välj det språk din webbplats är skriven i:

[[tabs: PHP | Node.js | curl]]

<?php
$token  = $_GET['bankid_auth_token'] ?? '';
$body   = json_encode(['token' => $token, 'sitekey' => 'DIN_SITE_KEY', 'ts' => time(), 'nonce' => bin2hex(random_bytes(16))]);
$secret = getenv('BANKID_SECRET_KEY');   // din hemliga nyckel – aldrig i webbsidan

$ch = curl_init('https://authentication.swedensites.com/bankid/verify/');
curl_setopt_array($ch, [
    CURLOPT_POST => true, CURLOPT_POSTFIELDS => $body, CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 15,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'X-SS-Signature: ' . hash_hmac('sha256', $body, $secret)],
]);
$svar = json_decode((string) curl_exec($ch), true);

if (($svar['status'] ?? '') === 'ok') {
    // Inloggad! $svar['givenname'], $svar['surname'], $svar['ssn'] (personnummer)
} else {
    // Inte inloggad – visa ett fel
}
// Node.js 18 eller senare
import crypto from 'node:crypto';

const token = req.query.bankid_auth_token;
const body = JSON.stringify({ token, sitekey: 'DIN_SITE_KEY', ts: Math.floor(Date.now() / 1000), nonce: crypto.randomUUID() });
const secret = process.env.BANKID_SECRET_KEY;   // din hemliga nyckel – aldrig i webbsidan

const svar = await fetch('https://authentication.swedensites.com/bankid/verify/', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-SS-Signature': crypto.createHmac('sha256', secret).update(body).digest('hex') },
  body,
}).then((r) => r.json());

if (svar.status === 'ok') {
  // Inloggad! svar.givenname, svar.surname, svar.ssn (personnummer)
} else {
  // Inte inloggad – visa ett fel
}
# För att prova från en terminal. TOKEN, SITE_KEY och SECRET_KEY sätts först.
BODY=$(printf '{"token":"%s","sitekey":"%s","ts":%d,"nonce":"%s"}' "$TOKEN" "$SITE_KEY" "$(date +%s)" "$(openssl rand -hex 16)")
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$SECRET_KEY" | sed 's/^.* //')
curl -s https://authentication.swedensites.com/bankid/verify/ \
  -H 'Content-Type: application/json' -H "X-SS-Signature: $SIG" -d "$BODY"

Svaret ser ut så här när allt gick bra:

{ "status": "ok", "givenname": "Anna", "surname": "Andersson", "ssn": "199001011234", "verid": "SSV-4F1C0B9E…" }

Klart. Personen är inloggad på din webbplats.

Nycklar och domäner

Allt du behöver finns på Mina sidor → BankID.

Vad det är Var det används
Site key Din webbplats id hos oss. Den är inte hemlig. I knappens kod (steg 1) och i frågan från din server (steg 3).
Hemlig nyckel Ett lösenord för din server. Bara på din server (steg 3). Lägg den aldrig i webbsidans kod, i en app eller i git.
Domäner De adresser där knappen får fungera, till exempel www.example.se. BankID startar bara på de domäner som finns i listan.

Två saker om domänerna: example.se och www.example.se räknas som två olika, så lägg till båda om sidan har båda. Testar du på din egen dator lägger du till localhost med portnummer, till exempel localhost:3000.

Testa innan du går live

Du får två uppsättningar nycklar: en för test och en för skarp drift. Mina sidor visar vilken som är vilken. Koden är densamma, bara nycklarna skiljer.

  • Testnyckeln loggar in med ett test-BankID, inte ditt riktiga. Hur du skaffar ett och ställer in BankID-appen för test står på demo.bankid.com.
  • Den skarpa nyckeln används när riktiga personer ska logga in med sitt eget BankID.

Bygg och prova med testnyckeln. Byt till den skarpa när allt fungerar.

Anpassa BankID-knappen

Du ändrar hur BankID beter sig genom att lägga till fler data-rader i script-taggen från steg 1.

Rad Vad den gör
data-site-key="…" Din site key. Måste finnas.
data-redirect-url="…" Sidan personen skickas till när den är klar.
data-lang="en" BankID-rutan på engelska. Utan raden följer den sidans språk.
data-method="qr" Visa alltid QR-kod, även på mobil. sameDevice öppnar alltid appen på samma enhet. Utan raden väljs det bästa automatiskt.
data-mode="sign" Signering i stället för inloggning, se nästa avsnitt.
data-block-app="true" Ber personen öppna sidan i en vanlig webbläsare om den öppnats inuti Facebook, Messenger eller Instagram, där BankID inte fungerar bra.

Alla element med klassen bankid-signin-btn startar BankID, så du kan ha flera knappar och ge dem vilket utseende du vill.

Låta någon signera

Vill du att personen godkänner en text, till exempel ett avtal, lägger du till två rader:

[[tabs: HTML]]

<script src="https://authentication.swedensites.com/sdk/v1/bankid-sdk.min.js"
        data-site-key="DIN_SITE_KEY"
        data-mode="sign"
        data-user-visible-data="Jag godkänner avtal 2026-1182 med Exempel AB."
        data-redirect-url="https://www.example.se/signerat/"></script>

Texten visas i BankID-appen innan personen godkänner. Skriv den så att den går att förstå utan sammanhang.

Steg 2 och 3 är precis som vid inloggning. Spara verid från svaret tillsammans med texten som signerades. Det är ditt kvitto på signeringen.

Om något går fel

Svar från din server (steg 3)

Är status inte ok ska personen inte släppas in. Vanliga orsaker:

status Vad det betyder Gör så här
invalid signature Den hemliga nyckeln stämmer inte. Kontrollera att du har rätt hemlig nyckel för rätt site key.
timestamp invalid Klockan på din server går fel. Ställ serverns klocka rätt (mer än 5 minuter fel räcker).
no session found Koden är okänd eller redan använd. Varje kod kan bara användas en gång. Låt personen logga in igen.
session not complete Personen har inte godkänt. Låt personen logga in igen.
invalid sitekey, wrong sitekey Fel site key. Använd samma site key som i knappen.

Alla felkoder finns i Referens för utvecklare.

I BankID-rutan

Avbryter personen, eller tar tiden slut, visar BankID-rutan själv ett meddelande och en knapp för att försöka igen. Du behöver inte göra något.

  • Personen avbröt i BankID-appen.
  • Tiden gick ut. En inloggning måste godkännas inom 3 minuter.
  • BankID startade inte. Oftast saknas appen eller behöver uppdateras.
  • BankID-legitimationen gäller inte. Personen behöver förnya sitt BankID hos sin bank.
  • “Ingen giltig site key” eller “BankID-processen kunde inte startas” betyder oftast att site key saknas eller att domänen inte finns i listan på Mina sidor.

Säkerhet

Fem regler som gör din inloggning säker:

  1. Fråga alltid oss från din server (steg 3). Det är först när svaret är ok som personen är inloggad. Lita aldrig bara på att webbläsaren kom tillbaka med en kod.
  2. Håll den hemliga nyckeln hemlig. Den ska bara finnas på din server. Har den läckt, kontakta oss så byter vi den.
  3. Lägg bara in dina egna domäner på Mina sidor.
  4. Spara bara det du behöver om personen. Berätta i din integritetspolicy att du använder BankID.
  5. Varje kod gäller en gång. Då kan ingen återanvända någon annans inloggning.

Vi sparar varje inloggning och signering (personnummer, namn, tid, IP-adress och signerad text) i 24 månader, enligt vår integritetspolicy.

Referens för utvecklare

Det här behövs inte för att komma igång. Det är till för dig som vill styra BankID från JavaScript eller bygga ett eget gränssnitt.

Inställningar i JavaScript

Allt från Anpassa BankID-knappen kan också anges med SSBankID.init(). Då kan du ta emot resultatet i din egen kod i stället för att skicka personen vidare:

[[tabs: JavaScript]]

SSBankID.init({
  siteKey: 'DIN_SITE_KEY',
  lang: 'sv',                // 'sv' eller 'en'
  method: 'auto',            // 'auto', 'qr' eller 'sameDevice'
  mode: 'auth',              // 'auth' eller 'sign'
  userVisibleData: null,     // texten som signeras när mode är 'sign'
  onComplete: (data) => {    // ersätter redirectUrl
    fetch('/min-server/bankid', { method: 'POST', body: JSON.stringify({ token: data.token }) });
  },
  onError: (reason, data) => console.warn('BankID:', reason),
  onEvent: (status, data) => console.log(status),
});

I data-attribut anges funktionerna med namn: data-on-complete="minApp.klar", data-on-error, data-on-event.

Metod Vad den gör
SSBankID.init(inställningar) Sätter inställningar. Kan anropas flera gånger.
SSBankID.start() Startar BankID, som ett klick på knappen.
SSBankID.on(händelse, funktion) Lyssnar på en händelse, se nedan.
SSBankID.close() Stänger BankID-rutan.
Händelse När
usersign Personen har öppnat inloggningen i BankID-appen och ska ange sin säkerhetskod.
complete Personen har godkänt. Data: { status, token }.
failed Inloggningen avbröts eller misslyckades. Data: { status, reason }.

reason är BankID:s orsak med små bokstäver: usercancel (personen avbröt), expiredtransaction (tiden gick ut), cancelled (en ny inloggning startades), startfailed (appen startade inte), certificateerr (BankID:t gäller inte), userdeclinedcall. Okända värden behandlas som ett allmänt fel.

Frågan från din server i detalj

POST https://authentication.swedensites.com/bankid/verify/

Del Vad
token Koden från steg 2.
sitekey Din site key.
ts Tiden nu, i sekunder sedan 1970 (Unix-tid). Får skilja högst 5 minuter från vår klocka.
nonce Ett slumpvärde. Valfritt men rekommenderat.
Header X-SS-Signature HMAC-SHA256 av hela JSON-texten med din hemliga nyckel, i hex med små bokstäver. Räkna på exakt den text du skickar.
Fält i svaret Vad
status ok, eller en felkod.
givenname, surname För- och efternamn enligt BankID (alla förnamn).
ssn Personnummer, 12 siffror.
verid Vårt id för just den här inloggningen. Bra att spara som kvitto.

Svaret har alltid HTTP-status 200, så läs status. Alla felkoder: invalid json, missing parameters, timestamp invalid, missing signature, invalid sitekey, secret not configured (kontakta oss), invalid signature, no session found, wrong sitekey, session not complete.

Bygga ett eget gränssnitt

Vill du inte använda BankID-rutan, till exempel i en app, kan du anropa samma adresser som knappen gör. Anropen måste komma från en webbläsare på en av dina domäner.

Adress Vad den gör
POST /bankid/entry/ Startar. Skicka { "k": site key, "device": "qr" eller "same", "mode": "auth" eller "sign", "userVisibleData": text }. Svaret har auth_token och antingen qr_image (en bildadress) eller auto_start_token.
GET adressen i qr_image QR-koden som bild. Hämta den på nytt varannan sekund med ?t=<tid> på slutet. 410 när den gått ut.
bankid:///?autostarttoken=… Öppnar BankID-appen på samma enhet, med auto_start_token.
GET /bankid/sse/?token=<auth_token> Status i realtid (Server-Sent Events): usersign, complete med token, eller failed med reason. Använd EventSource, den återansluter själv mellan stegen.
POST /bankid/cancel/ Avbryter. Skicka { "token": auth_token, "sitekey": site key }.

Alla adresser ligger på https://authentication.swedensites.com. Startar entry inte returnerar den ett status som förklarar varför, till exempel host not allowed när domänen inte finns i listan.

Gränser

En inloggning måste godkännas inom 3 minuter
En kod (token) kan användas en gång
ts får skilja från vår klocka högst 5 minuter
Vi sparar inloggningar och signeringar 24 månader

Versioner

Du använder version 1 (/sdk/v1/). Ändringar som skulle kunna påverka din webbplats kommer i en ny version med en ny adress, och version 1 finns kvar. Rättningar kommer i version 1 utan att du behöver ändra något.

Hjälp

Fastnar du? Skriv till info@swedensites.com och berätta vilken site key det gäller. Skicka aldrig din hemliga nyckel.

Cookieinställningar

Välj vilka cookies vi får använda. Du kan ändra dig när som helst under Cookieinställningar längst ned på sidan.

Läs mer i vår cookiepolicy

Vill du starta chatten?

För att kunna använda chatten behöver du godkänna cookies som används för att chatten ska fungera.

Läs mer i vår cookiepolicy och integritetspolicy.

AI-sammanfattning

Svaret skrivs av AI utifrån den här frågan. Kontrollera viktiga uppgifter med oss.