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.
- 1Besökaren klickarpå BankID-knappen på din webbplats.
- 2Godkänner i BankID-appengenom att skanna QR-koden, eller direkt i mobilen.
- 3Din webbplats får en kodsom bevis på att någon har godkänt. Koden säger inte vem.
- 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:
- Fråga alltid oss från din server (steg 3). Det är först när svaret är
oksom personen är inloggad. Lita aldrig bara på att webbläsaren kom tillbaka med en kod. - Håll den hemliga nyckeln hemlig. Den ska bara finnas på din server. Har den läckt, kontakta oss så byter vi den.
- Lägg bara in dina egna domäner på Mina sidor.
- Spara bara det du behöver om personen. Berätta i din integritetspolicy att du använder BankID.
- 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.