Dazr Identity for utviklere

Folk kan allerede bruke Google- eller Microsoft-kontoen sin inne i Dazr Identity, så appen din trenger ikke egne Google- og Microsoft-knapper ved siden av: én knapp i stedet for tre.

Discovery og endepunkter

Alt er beskrevet i discovery-dokumentet. Pek biblioteket ditt mot utstederen, så finner det resten.

HvaAdresse
Utstederhttps://identity.dazr.eu
Discoveryhttps://identity.dazr.eu/.well-known/openid-configuration
Autorisasjonhttps://identity.dazr.eu/oauth/authorize
Tokenhttps://identity.dazr.eu/oauth/token
Brukerinformasjonhttps://identity.dazr.eu/oauth/userinfo
Offentlige nøkler (JWKS)https://identity.dazr.eu/oauth/jwks
Tilbakekalling (RFC 7009)https://identity.dazr.eu/oauth/revoke
Introspeksjon (RFC 7662), bare apper med webserverhttps://identity.dazr.eu/oauth/introspect
Utlogging (RP-initiert utlogging)https://identity.dazr.eu/oauth/logout
Verifiseringsrapporter, bare apper med webserverhttps://identity.dazr.eu/oauth/verification-report

Registrer en app

En app i utviklerkonsollen til Dazr Identity: klient-ID, discovery-URL, omdirigerings-URI-er, omfang og trinnene for å koble den til

Veiledninger for integrasjon

Hver stakk nedenfor bruker sin egen standardstøtte for OpenID Connect. Du trenger tre verdier fra konsollen: klient-ID-en, klienthemmeligheten (bare apper med webserver) og omdirigerings-URI-en du registrerte. Resten kommer fra discovery-dokumentet.

Ethvert OpenID Connect-bibliotek

Hvis stakken din ikke står på listen, fungerer enhver OpenID Connect-klient. Sjekk disse innstillingene:

Flyten

  1. Lag en tilfeldig code_verifier (43 til 128 tegn) og tilhørende code_challenge = base64url(SHA-256(verifier)). Lag tilfeldige state og nonce. Ta vare på alle tre i brukerens økt.
  2. Omdiriger til autorisasjonsendepunktet med response_type=code, client_id, redirect_uri, scope (alltid inkludert openid), state, nonce, code_challenge og code_challenge_method=S256.
  3. Personen logger inn om nødvendig og ser samtykkeskjermen med de faktiske dataene. Når vedkommende tillater det, kommer personen tilbake til omdirigerings-URI-en din med code, state og iss. Sjekk at state stemmer og at iss er https://identity.dazr.eu.
  4. På serveren din sender du en POST til tokenendepunktet med grant_type=authorization_code, code, samme redirect_uri og code_verifier.
  5. Verifiser ID-tokenet: ES256-signatur med en nøkkel fra JWKS (match kid), iss, aud = klient-ID-en din, exp og din nonce. Bruk sub som kontonøkkel.
Samtykkeskjermen i Dazr Identity for en app som heter Ledgerline: den viser navnet, e-postadressen og den verifiserte organisasjonen brukeren valgte å dele

Parameteren prompt godtar none (svar med en gang med login_required eller consent_required hvis personen måtte ha gjort noe), login (be personen logge inn igjen) og consent (vis samtykkeskjermen selv når den er godkjent før). max_age støttes. Husket samtykke: hvis personen har godkjent de samme omfangene før, går vedkommende rett tilbake til appen din. Ber du om mer senere, viser samtykkeskjermen bare det som er nytt.

Omfang og claims

Be bare om det du trenger. Ingenting utenfor denne tabellen finnes: ingen kontakter, ingen passord. Filer leses bare via Dazr Files-API, med et eget scope files.read.

ScopeClaims
openid (påkrevd)sub: en tilfeldig ID for personen, den samme for alle apper i organisasjonen din og forskjellig for alle andre organisasjoner
profilename (hvis angitt) og locale
emailemail og email_verified (alltid true)
addressaddress (formatted, street_address, locality, region, postal_code, country), bare hvis personen har lagret en
organisationsorganisations: organisasjonene personen krysser av for på samtykkeskjermen, hver med id, name, display_name, website, country, register_number, vat, vat_verified (true bare når EUs VIES-tjeneste har bekreftet mva-nummeret), verified, verification (se Verifiserte organisasjoner) og role (owner, admin eller member)
offline_accessingen claims; du mottar også et oppdateringstoken

Claims vises i ID-tokenet for omfangene personen godkjente. Endepunktet for brukerinformasjon returnerer det samme settet, med gjeldende verdier.

Verifiserte organisasjoner

Dazr verifiserer bare en organisasjon når offisielle kilder beviser to ting: hvem personen er, og at personen representerer denne organisasjonen, med navn, organisasjonsnummer og mva-nummer. Typisk signerer daglig leder en kort erklæring med en kvalifisert elektronisk signatur (QES) og legger ved utskriften fra foretaksregisteret som oppgir vedkommende; med en utskrift forseglet av registeret, som en italiensk visura camerale eller en nederlandsk KVK-utskrift, skjer det umiddelbart, ellers går Dazr gjennom den. En kvalifisert signatur alene gjør aldri en organisasjon verifisert. Hver organisasjon i claimet organisations har sin gjeldende verifisering:

Verifisering av en organisasjon i Dazr Identity: daglig leder signerer erklæringen med en kvalifisert signatur nå eller senere via e-post, eller laster opp firmautdraget og en ID
verification.statusBetydning
unverifiedIkke verifisert, eller en verifisering har mislyktes, utløpt eller blitt tilbakekalt (for eksempel etter at det juridiske navnet eller organisasjonsnummeret er endret).
pendingVerifiseringen pågår: representanten er bedt om å signere, utdraget fra foretaksregisteret mangler fortsatt, eller Dazr gjennomgår dokumenter. method sier hvilken vei som ble startet, for eksempel qes (representanten signerer erklæringen), qseal, pec, letter, video eller documents.
verifiedVerifisert. method er qes_org (kvalifisert signatur, sertifikatet oppgir organisasjonen), extract_sealed (kvalifisert signatur eller gjennomgått ID pluss en utskrift forseglet av foretaksregisteret), qes_reviewed (kvalifisert signatur, utskrift kontrollert av Dazr), qseal (organisasjonens kvalifiserte elektroniske segl), documents, pec (en kode sendt til organisasjonens sertifiserte e-postadresse, PEC, Italia), letter (en kode sendt i posten til forretningsadressen), video (en videosamtale med Dazr) eller extract. authority oppgir hva som beviste at personen representerer organisasjonen (se nedenfor), og verified_at er et Unix-tidspunkt.

Bare når status er verified, oppgir verification.authority (og authority i webhooks) hvordan koblingen mellom personen og organisasjonen ble bevist. Hver verifisering er dokumentert bevis, kontrollert én gang på datoen som vises. Den er ingen garanti for organisasjonens betalingsevne eller oppførsel, og den viser ikke hvem som eier organisasjonen.

verification.authorityHva den beviser
certificateDokumentert bevis for at forespørselen ble signert med en kvalifisert elektronisk signatur eller forseglet med et kvalifisert elektronisk segl der sertifikatet oppgir organisasjonen og organisasjonsnummeret. Dazr kontrollerte sertifikatet mot EUs tillitslister og for tilbakekalling.
register_extractDokumentert bevis for at et styremedlem, daglig leder eller annen person med signaturrett bekreftet forespørselen med en kvalifisert elektronisk signatur eller et ID-dokument kontrollert av Dazr, og at en utskrift forseglet av foretaksregisteret, høyst 3 måneder gammel, oppgir vedkommende.
reviewedDokumentert bevis for at et styremedlem, daglig leder eller annen person med signaturrett bekreftet forespørselen med en kvalifisert elektronisk signatur eller et ID-dokument, og at en medarbeider i Dazr kontrollerte en registerutskrift, høyst 3 måneder gammel, som oppgir vedkommende.
pecDokumentert bevis for at noen med tilgang til organisasjonens sertifiserte e-postadresse (PEC, Italia), slik den står i foretaksregisteret, bekreftet forespørselen med en engangskode.
letterDokumentert bevis for at noen med tilgang til posten på forretningsadressen bekreftet forespørselen med en engangskode som Dazr sendte dit i brev.
videoDokumentert bevis for at en medarbeider i Dazr i en videosamtale så ID-dokumentet til personen som bekreftet forespørselen, og en offisiell utskrift som oppgir personen som styremedlem, daglig leder eller person med signaturrett.

De samme definisjonene står i bruksvilkårene, punkt 7 i Utviklervilkårene og hver verifiseringsrapport.

Den boolske verdien verified beholdes for kompatibilitet og tilsvarer verification.status === 'verified'. Hver organisasjon har også en id, den samme som webhooks bruker.

Når statusen er pending eller verified, er verification.report_url adressen til verifiseringsrapporten.

"organisations": [{
  "id": "org_3k9x2m0q8w1v5t7a", "name": "Conti Logistica S.r.l.", "country": "IT",
  "register_number": "REA MI1234567", "vat": "IT12345678903", "vat_verified": true,
  "display_name": "Conti", "website": "https://conti.example",
  "verified": false, "verification": { "status": "pending", "method": "qes" }, "role": "owner"
}]

role og medlemskap leses på nytt ved hver tokenoppdatering og forespørsel om brukerinformasjon: etter en rolleendring har neste svar den nye rollen, og en organisasjon personen har gått ut av eller blitt fjernet fra, er ikke lenger med. Når en administrator i organisasjonen kobler fra appen din, utelates organisasjonen fra tokener som er utstedt tidligere, til et medlem deler den med appen din igjen ved en ny innlogging. display_name og website er null når organisasjonen ikke har angitt dem; name er alltid det juridiske navnet.

Land og tider

Organisasjoner i de 27 EU-landene, Norge, Island, Liechtenstein, Sveits og Storbritannia kan verifisere seg. Den raskeste veien avhenger av landet:

LandVerifisering av organisasjonerVirksomhetsverifisering
ItaliaUmiddelbart med en kvalifisert signatur og en visura forseglet av foretaksregisteret, eller på noen minutter med en kode til virksomhetens sertifiserte e-postadresse (PEC)En visura, høyst 3 måneder gammel, kontrollert av en medarbeider i Dazr, som regel innen én arbeidsdag
NederlandUmiddelbart med en kvalifisert signatur og en digitalt bekreftet KVK-utskriftFra KVK-registeret, sjekket av en person hos Dazr, vanligvis innen én arbeidsdag
Østerrike, BelgiaUmiddelbart med en kvalifisert signatur og en utskrift forseglet av foretaksregisteretEn offisiell utskrift, høyst 3 måneder gammel, kontrollert av en medarbeider i Dazr, som regel innen én arbeidsdag
Norge, Danmark, Finland, Frankrike, Polen, TsjekkiaUmiddelbart med en kvalifisert signatur der sertifikatet oppgir organisasjonen; ellers en utskrift og et ID-dokument, kontrollert av en medarbeider i Dazr, som regel innen én arbeidsdagFra foretaksregisteret på nett, sjekket av en person hos Dazr, vanligvis innen én arbeidsdag
StorbritanniaEn utskrift og et ID-dokument, kontrollert av en medarbeider i Dazr, som regel innen én arbeidsdagFra Companies House, sjekket av en person hos Dazr, vanligvis innen én arbeidsdag
Alle andre støttede landUmiddelbart med en kvalifisert signatur der sertifikatet oppgir organisasjonen; ellers en utskrift og et ID-dokument, kontrollert av en medarbeider i Dazr, som regel innen én arbeidsdagEn offisiell utskrift, høyst 3 måneder gammel, kontrollert av en medarbeider i Dazr, som regel innen én arbeidsdag
OveraltEn kode i posten (100 € eks. mva., 3 til 10 arbeidsdager) eller en videosamtale (200 € eks. mva.)En videosamtale (200 € eks. mva.) når representanten ikke har kamera på telefonen

Tidene er typiske, ikke garanterte. Automatisk betyr at dokumenterte regler tar avgjørelsen når alle kontroller er klare; når en ikke er det, ser en medarbeider i Dazr på den, som regel innen én arbeidsdag. Hjelpesiden for dem som blir bedt om å verifisere, viser hvilken registerutskrift man trenger i hvert land.

Krev en verifisert organisasjon

I konsollen setter du Krev en verifisert organisasjon til Verifisering startet eller Verifisert, eller ber om det per forespørsel med acr_values=urn:dazr:org:verification-started eller acr_values=urn:dazr:org:verified (den strengeste av de to gjelder). Appen din må også be om omfanget organisations.

Innstillingen Krev en verifisert organisasjon i utviklerkonsollen: ikke påkrevd, verifisering startet eller verifisert

Den som ikke har en organisasjon som kvalifiserer, tas gjennom det i samme innlogging: navnet sitt, organisasjonen (med mva-nummeret sjekket i VIES), deretter verifiseringen. Vedkommende kan signere med en gang, få erklæringen sendt til seg selv på e-post, eller navngi en annen som signerer. Deretter krysser vedkommende av for organisasjonen på samtykkeskjermen (bare organisasjoner som kvalifiserer, kan krysses av) og kommer tilbake til omdirigerings-URI-en din.

Hvis en annen fortsatt må signere, kommer personen tilbake med statusen pending, også når du ba om Verifisert: du mottar en kode, claimen sier pending, og acr i ID-tokenet er urn:dazr:org:verification-started i stedet for urn:dazr:org:verified. Styr alltid tilgangen etter verification.status, aldri etter at innloggingen lyktes. Med prompt=none får du interaction_required når kravet ikke er oppfylt.

Endringer i innstillingen gjelder fra neste innlogging. Folk som allerede er innlogget, logges ikke ut: svar på oppdateringer, endepunktet for brukerinformasjon og webhooks har alltid gjeldende status, så bruk dem til å reagere for eksisterende økter.

Webhooks

Legg til en webhook-URL (https) i konsollen. Du ser signeringshemmeligheten én gang; du kan rotere den. Dazr sender organisation.verification.updated når en organisasjon som en av brukerne dine har delt med appen din, blir pending, verified, failed eller unverified. Apper som aldri har mottatt en organisasjon gjennom samtykke, hører aldri om det.

POST /your/webhook
Content-Type: application/json
Dazr-Event: organisation.verification.updated
Dazr-Delivery: dlv_8Fq2…
Dazr-Signature: t=1791021600,v1=5e0c…

{ "id": "evt_…", "type": "organisation.verification.updated", "created": 1791021600,
  "data": { "organisation": { "id": "org_3k9x2m0q8w1v5t7a", "name": "Conti Logistica S.r.l.", "country": "IT" },
            "status": "verified", "method": "qes_org", "authority": "certificate", "verified_at": 1791021598,
            "report_url": "https://identity.dazr.eu/oauth/verification-report?org=org_3k9x2m0q8w1v5t7a",
            "subjects": ["Xo1c…"] } }

status er pending, verified, failed eller unverified. subjects er sub-verdiene, i appen din, for personene som delte denne organisasjonen med den. Sjekk signaturen før du stoler på innholdet:

import crypto from 'node:crypto';
// raw = the request body exactly as received (a string), header = the Dazr-Signature header
function verifyDazrSignature(raw, header, secret) {
  const m = /^t=(\d+),v1=([a-f0-9]{64})$/.exec(header || '');
  if (!m || Math.abs(Date.now() / 1000 - Number(m[1])) > 300) return false; // reject old deliveries
  const want = crypto.createHmac('sha256', secret).update(m[1] + '.' + raw).digest('hex');
  return crypto.timingSafeEqual(Buffer.from(want), Buffer.from(m[2]));
}

Svar med en hvilken som helst 2xx innen 8 sekunder. Ellers prøver Dazr igjen etter omtrent 5 minutter, 30 minutter, 2, 6, 12 og 24 timer, og markerer deretter leveransen som mislykket. Hvert forsøk har samme Dazr-Delivery-ID, så se bort fra duplikater. Konsollen lister opp nylige leveranser, kan sende én på nytt og kan sende en testhendelse (webhook.test). Å spørre endepunktet for brukerinformasjon fungerer også.

Organisasjoner og roller i appen din

I en portal for bedriftskunder kobler du hver Dazr-organisasjon til en kundekonto (en tenant) i appen din og personens rolle i organisasjonen til en rolle i appen din.

  1. Be om scopet organisations. Hver organisasjon personen krysser av, kommer med sin id, role (owner, admin eller member) og verification.
  2. Bruk organisations[].id som nøkkel for tenanten, aldri navnet eller mva-nummeret: de kan endre seg.
  3. Koble rollen, for eksempel owner og admin til administratorrollen din og member til brukerrollen din. Les den på nytt ved hver innlogging og tokenfornyelse: roller endrer seg, og folk slutter.
  4. Lås bare opp bedriftsfunksjoner når verification.status er verified, eller kyb.status er approved der du trenger virksomhetsverifisering.
// claims: the ID token claims or the user info response
const ROLE = { owner: 'tenant_admin', admin: 'tenant_admin', member: 'tenant_user' };

const memberships = (claims.organisations || []).map((o) => ({
  tenantId: o.id,                              // e.g. org_3k9x2m0q8w1v5t7a
  role: ROLE[o.role] || 'tenant_user',
  verified: o.verification?.status === 'verified',
  businessVerified: o.kyb?.status === 'approved',
}));

Med Keycloak

Når Keycloak brokerer Dazr Identity (se Keycloak-veiledningen), legger du til mappers under identitetsleverandørens fane Mappers med sync mode Force. Keycloak leser disse stiene fra user info-svaret, og en sti kan peke på én plass i en liste: organisations[0] er den første organisasjonen personen krysset av. For en portal med én kundekonto per person er det nok; jobber folk for flere organisasjoner, la dem velge én, eller les hele listen i appen din.

MappertypeClaimResultat
Attribute Importerorganisations[0].idBrukerattributt dazr_org_id: tenant-nøkkelen
Attribute Importerorganisations[0].nameBrukerattributt dazr_org_name
Claim to Roleorganisations[0].role, claim-verdi ownerRealm- eller klientrolle tenant_admin
Claim to Roleorganisations[0].role, claim-verdi adminRealm- eller klientrolle tenant_admin
Claim to Roleorganisations[0].role, claim-verdi memberRealm- eller klientrolle tenant_user
Claim to Roleorganisations[0].verification.status, claim-verdi verifiedRolle verified_business

Legg deretter til en mapper av typen User Attribute for dazr_org_id i appens client scope i Keycloak, så appen din mottar tenant-nøkkelen i Keycloaks egne tokener ved siden av rollene.

Virksomhetsverifisering (KYB)

Virksomhetsverifisering, ofte kalt KYB (know your business), er det høyere sikkerhetsnivået over verifisering av organisasjoner. Den legger til foretaksregisteret, en ID-kontroll med live-selfie av personen som handler for virksomheten (representanten), og kontroll av virksomheten og representanten mot sanksjonslister og lister over politisk eksponerte personer (PEP). Reelle rettighetshavere er ikke med.

Den koster 25 € eks. mva. per organisasjon, én gang. Organisasjonen betaler, eller appen din betaler for kundene sine med forhåndsbetalt kreditt. Stopper den før et ID-dokument er kontrollert, refunderes hele beløpet.

Virksomhetsverifisering i Dazr Identity på en datamaskin: steg 3 av 5, en stor QR-kode for å ta bildene med mobilen, de to bildene som følger og mobilens status live
  1. Selskapsopplysninger. Selskapsformen samt organisasjonsnummer og forretningsadresse fra organisasjonens juridiske opplysninger, bekreftet av den som starter den.
  2. Betaling. 25 € eks. mva. via Mollie, med faktura på organisasjonens side. Når appen din betaler med forhåndsbetalt kreditt, hopper organisasjonen over dette steget.
  3. ID og selfie. Den som starter verifiseringen, er daglig leder, styremedlem eller har signaturrett, eller utpeker en slik person, som får en lenke på e-post med en engangskode (gyldig i 14 dager, påminnelser etter 2 og 7 dager), bekrefter rollen sin og kan legge til en fullmakt. Representanten tar ett bilde av et pass (siden med bildet), ID-kort eller oppholdstillatelse (forsiden) og én selfie rett forfra, live med kameraet på siden; ingenting kan lastes opp. En KI-modell leser dokumentet; Dazr sjekker datoene og navnet, og i et pass den maskinlesbare sonen (kontrollsifre etter ICAO 9303). En saksbehandler hos Dazr sammenligner selfien med bildet i dokumentet. På en datamaskin viser steget en QR-kode som flytter bildetakingen til en mobil, og datamaskinen går videre av seg selv. Uten kamera på mobilen kan representanten i stedet booke en videosamtale med Dazr (200 € eks. mva., full refusjon hvis Dazr avlyser eller ikke tilbyr noe tidspunkt).
  4. Kontroll i foretaksregisteret. Navn, status og styremedlemmer fra det offisielle registeret der det finnes på nett (Norge, Danmark, Finland, Frankrike, Nederland, Polen, Tsjekkia og Storbritannia), ellers fra en offisiell utskrift, høyst 3 måneder gammel, som Dazr leser automatisk.
  5. Sanksjons- og PEP-kontroller. Selskapet og representanten mot EUs, FNs og OFACs sanksjonslister og for politisk eksponerte personer. Hvis PEP-databasen ikke er tilgjengelig, gir et søk på bare navnet i Wikidata en indikasjon. PEP-resultatet står i claimet og rapporten og stopper aldri godkjenningen.
  6. Avgjørelse. En saksbehandler hos Dazr sammenligner selfien med bildet i dokumentet og avgjør saken med resultatene av de dokumenterte risikoreglene: de viser når ID-kontrollen feiler, et navn står på en sanksjonsliste, registeret ikke oppgir representanten, eller selskapet ikke er bekreftet. Saksbehandleren kan godkjenne, avvise med en begrunnelse, be organisasjonen om mer informasjon eller kjøre en kontroll på nytt, vanligvis innen én arbeidsdag. Saker med høy risiko krever to saksbehandlere. Ingen sak avvises automatisk.

Godkjente organisasjoner kontrolleres på nytt mot sanksjonslistene hver dag og for PEP-status hver 30. dag. Et nytt treff på en sanksjonsliste sender verifiseringen tilbake til gjennomgang; et nytt PEP-treff flagges, og verifiseringen forblir godkjent. I begge tilfeller får appen din beskjed.

En godkjent virksomhetsverifisering er dokumentert bevis for at et styremedlem, daglig leder eller annen person med signaturrett, med ID-dokument og live-selfie kontrollert, bekreftet forespørselen, at foretaksregisteret eller en offisiell utskrift, høyst 3 måneder gammel, viser virksomheten, og at virksomheten og personen ble kontrollert mot sanksjonslister og lister over politisk eksponerte personer. Reelle rettighetshavere kontrolleres ikke.

Kravet kyb

Hver organisasjon i kravet organisations inneholder kyb, og verification.assurance_level oppsummerer begge nivåene: none, basic (organisasjonen verifisert) eller kyb (virksomhetsverifisering godkjent).

kyb.statusBetydning
noneIngen virksomhetsverifisering, eller den siste ble avbrutt eller utløp.
in_progressStartet: organisasjonen går gjennom stegene.
in_reviewSendt inn og under gjennomgang hos Dazr, eller tilbake til gjennomgang etter et nytt treff i screeningen.
approvedGodkjent. Først da inneholder kravet verified_claims.
rejectedIkke godkjent. Organisasjonen kan starte en ny.

Etter godkjenning følger verified_claims formatet OpenID Connect for Identity Assurance:

"kyb": {
  "status": "approved",
  "report_url": "https://identity.dazr.eu/oauth/verification-report?org=org_3k9x2m0q8w1v5t7a",
  "verified_claims": {
    "verification": {
      "trust_framework": "dazr_kyb", "assurance_level": "kyb", "time": "2026-10-06T09:14:03.000Z",
      "verification_process": "kyb_7Tq2…",
      "evidence": [
        { "type": "electronic_record", "check_details": [{ "check_method": "data", "organization": "no-brreg" }] },
        { "type": "document", "check_details": [{ "check_method": "vpip" }, { "check_method": "pvr" }],
          "note": "ID document and a live, front-facing selfie of the representative; beneficial owners are not part of this verification" }
      ]
    },
    "claims": {
      "legal_name": "Fjordline Logistikk AS", "country": "NO", "registration_number": "912345678",
      "beneficial_owners": "not_verified",
      "started_by_representative": false,
      "screening": { "result": "no_match_found", "pep_checked": true, "last_screened_at": "2026-10-06T03:23:00.000Z" },
      "risk_level": "low"
    }
  }
}

beneficial_owners er alltid not_verified: virksomhetsverifisering gjelder selskapet og den som handler for det, ikke hvem som eier det. started_by_representative sier om den som startet den, også er representanten som fikk ID-en sjekket, eller inviterte representanten på e-post. Claimet inneholder aldri navn, fødselsdatoer eller dokumentopplysninger. De står i revisjonsrapporten, som appen din kan hente for organisasjoner som er delt med den.

Krev virksomhetsverifisering

Sett Krev en verifisert organisasjon til Virksomhetsverifisering (KYB) i konsollen, eller be om det per forespørsel med acr_values=urn:dazr:org:kyb. Den som ikke har det ennå, går gjennom alle stegene i den samme innloggingen, én skjerm om gangen, og går videre til appen din så snart Dazr har godkjent det; til da får personen en e-post ved godkjenning og logger inn igjen. ID-tokenets acr er først urn:dazr:org:kyb når en organisasjon er godkjent, så sjekk alltid kyb.status === 'approved' før du låser opp noe som krever det.

Webhooks for virksomhetsverifisering

Den samme hendelsen organisation.verification.updated sendes når statusen for virksomhetsverifiseringen endrer seg, også etter en ny screening. Dataene legger til:

"kyb": { "status": "approved", "approved_at": 1791021598, "risk_level": "low" },
"assurance_level": "kyb"

Virksomhetsverifisering på egen hånd

En organisasjon kan også starte virksomhetsverifisering selv, på https://identity.dazr.eu/verify/business?org=…, lenket fra sin side i Dazr Identity, uten at noen app ber om det. Resultatet er det samme: én verifisering per organisasjon, som hver app organisasjonen deles med kan stole på. Bilder av ID-dokumenter og selfier slettes 30 dager etter avgjørelsen; resultatene og rapporten lagres i 5 år etter at verifiseringen er avsluttet, slik hvitvaskingsreglene krever.

Slik tas avgjørelsen

En saksbehandler hos Dazr avgjør hver virksomhetsverifisering, vanligvis innen én arbeidsdag, og sammenligner selfien med bildet i dokumentet. Saksbehandleren ser nærmere på saken når ett av disse punktene gjelder:

Alt annet registreres og blokkerer aldri godkjenningen. En mulig politisk eksponert person (PEP) markeres som screening.pep possible_match i claimet og rapporten; er PEP-databasen ikke tilgjengelig, står det indication_only eller not_screened. Når registeret ikke oppgir noen ledere, er authority declared_by_representative. Du avgjør selv om du trenger forsterkede kundetiltak.

Land uten nettbasert register

I land uten levende register, som Italia, Tyskland, Spania eller Belgia, laster organisasjonen opp en offisiell utskrift (en visura camerale, et Handelsregisterauszug, en nota simple). Dazr leser den automatisk og sjekker selskapsnavn, registreringsnummer, dato (høyst 3 måneder gammel) og lederne som er oppført. Stemmer det, godkjennes det som med et levende register; stemmer det ikke eller kan det ikke leses, går det til en saksbehandler. En forseglet utskrift sjekkes også for registerets segl.

PEP, fullmakt og markeringer i claimet

Felt i verified_claims.claimsBetydning
screening.pepno_match_found, possible_match (markert, blokkerer ikke), indication_only (bare et navnesøk i Wikidata) eller not_screened.
authorityHva som viste at representanten kan handle: register, extract, dazr_verification eller declared_by_representative.
flagsTil stede når det er noe å se på: pep_possible_match, high_risk_country.

Verifiseringsrapporter for revisjoner

For hver organisasjon som er delt med appen din, kan du hente en rapport om hvordan og når Dazr verifiserte den, til revisjonsmappen din. Den finnes mens organisasjonen er verifisert, og mens verifiseringen pågår, og viser da hva som er gjort så langt.

En rapport inneholder aldri bilder eller numre fra ID-dokumenter, engangskoder, PEC-adressen, e-postadresser eller andre adresser enn forretningsadressen.

Eksempelrapporter

To eksempelrapporter med en oppdiktet organisasjon og oppdiktede personer, så compliance-teamet ditt kan se hva du mottar. De er signert med en eksempelnøkkel, ikke med Dazrs nøkler: verifiser dem med den offentlige eksempelnøkkelen nedenfor, aldri mot produksjonens JWKS.

Hent en rapport

Autentiser med klient-ID-en og klienthemmeligheten din, som ved tokenendepunktet: HTTP Basic (client_secret_basic), eller innholdet i en POST (client_secret_post). Legg aldri hemmeligheten i URL-en. Bruk organisasjonens id fra claims eller webhooks, eller rett og slett verification.report_url som de har med.

curl -u "$DAZR_CLIENT_ID:$DAZR_CLIENT_SECRET" -o report.pdf \
  "https://identity.dazr.eu/oauth/verification-report?org=org_3k9x2m0q8w1v5t7a&format=pdf&lang=en"
ParameterBetydning
orgOrganisasjonens id.
formatpdf (standard) eller jws, de samme faktaene som signert JSON.
langSpråket i PDF-en: en (standard), nl, it, de, fr, es eller pl.
docI stedet for rapporten: declaration, daglig leders signerte erklæring (bare kvalifisert signatur eller segl), eller extract, utdraget fra foretaksregisteret.

Bare organisasjoner som minst én av brukerne dine har delt med appen din gjennom samtykke, kan hentes. Alle andre organisasjoner svarer 404, det samme som en som ikke finnes eller ikke har noen verifisering; en feil klienthemmelighet svarer 401. Apper uten klienthemmelighet kan ikke hente rapporter. Nedlastinger har begrenset antall forespørsler, og hver av dem vises i organisasjonens aktivitet for administratorene, med navnet på appen din. I konsollen viser siden for appen din de tilkoblede organisasjonene med de samme nedlastingene.

Verifiser den signerte JSON-en

Med format=jws mottar du en kompakt JWS (ES256, header typ dazr-verification-report+jwt), signert med de samme nøklene som ID-tokener. Claims er iss, iat, jti (dokument-ID-en), sub (organisasjonens id), aud (klient-ID-en din) og report, faktaene. PDF-en har den samme JWS-en på siste side og i metadataene (DazrVerificationReport), så en PDF kan også kontrolleres uten nett.

import { createRemoteJWKSet, jwtVerify } from 'jose';

const jwks = createRemoteJWKSet(new URL('https://identity.dazr.eu/oauth/jwks'));
// jws = the response body of format=jws, or the text from the PDF metadata
const { payload } = await jwtVerify(jws, jwks, {
  issuer: 'https://identity.dazr.eu',
  audience: process.env.DAZR_CLIENT_ID,
  typ: 'dazr-verification-report+jwt',
});
console.log(payload.report.verification.status, payload.report.verification.authority);

La en revisor kontrollere signaturen

For en kvalifisert signatur eller et segl returnerer doc=declaration den signerte erklæringen nøyaktig slik den ble lastet opp: en signert PDF (PAdES) eller en .p7m-fil (CAdES). En revisor kan validere den uavhengig med Europakommisjonens DSS-demovalidator: last opp filen, behold standard valideringspolicy og kjør den. Resultatet viser om signaturen er kvalifisert (QESig, eller QESeal for et segl), hvem som signerte, og tillitstjenesteyteren fra EUs tillitsliste. doc=extract returnerer utdraget fra foretaksregisteret; et registerforseglet utdrag kan valideres på samme måte.

Rapporten er bevis til revisjonsmappen din. Regulerte foretak er fortsatt ansvarlige for sine egne kundetiltak.

Dazr tar vare på den signerte erklæringen, utdraget og rapportdataene mens organisasjonen er verifisert og i 5 år etter at verifiseringen avsluttes eller organisasjonen slettes. Ta vare på dine egne kopier så lenge reglene dine krever.

Nøkler for gamle rapporter

Rapporter signeres med de samme nøklene som ID-tokens, og nøklene byttes. Hver nøkkel som noen gang har signert en rapport, forblir publisert på https://identity.dazr.eu/oauth/jwks/archive, med dazr_status current, previous eller retired, i minst 5 år etter siste bruk. Verifiser en gammel rapport mot arkivet når kid-en ikke lenger er i JWKS.

Identitetsverifisering (KYC)

Slå på Tillat identitetsverifisering når en innlogging ber om det i konsollen, og be deretter om en verifisert person med acr_values=urn:dazr:person:kyc. Eller kryss av for Krev identitetsverifisering ved hver innlogging. Uten en av innstillingene ignoreres acr-verdien, og ingenting belastes. Du trenger ikke noe ekstra scope. Under innloggingen tar personen et livebilde av ID-en sin og én selfie med telefonen; en datamaskin viser en QR-kode. Dazr leser dokumentet, sammenligner ansiktene og sjekker navnet mot sanksjonslistene til EU, FN og OFAC. En person hos Dazr vurderer hver sjekk, vanligvis innen én arbeidsdag.

Hver verifisering koster 1,50 € eks. mva., fra saldoen til organisasjonen din. Personen betaler aldri. En verifisering gjelder i 12 måneder. Når en annen app ber om den, samtykker personen på en samtykkeskjerm i stedet for å ta nye bilder, og den appen betaler 1,50 €, én gang per verifisering. Ber appen din igjen med prompt=consent, eller logger noen inn med en verifisering appen din allerede har fått, er det gratis.

ID-tokenet og user info inneholder claimet kyc, og acr er urn:dazr:person:kyc:

"kyc": {
  "verified": true, "verified_at": 1791356184, "valid_until": 1822892184,
  "given_name": "ANNA", "family_name": "LINDQVIST", "birthdate": "1985-03-15",
  "nationality": "NO", "document_country": "NO",
  "sanctions": { "status": "no_match", "screened_at": 1791356184, "lists": ["eu", "un", "ofac"] }
}

sanctions.status er no_match, eller cleared_by_review når et navn på en liste lignet, og en saksbehandler fant at det ikke er denne personen. Bilder og numre fra dokumenter deles aldri. Etter 12 måneder sier claimet "verified": false: be om det igjen.

Verifiseringer er ekte og belastes også mens appen din er i test.

Saldo

Organisasjonen din kan betale for kundenes bedriftsverifisering. Åpne appen i konsollen og huk av for Vi betaler for kundenes bedriftsverifisering. Prisen trekkes fra organisasjonens saldo: én saldo for alle organisasjonens apper og for betalte Dazr-API-er. En verifisering koster 25 € eks. mva. Er saldoen for lav, betaler kunden som vanlig, og administratorene dine får en e-post.

Appen din betaler bare for en innlogging som ber om virksomhetsverifisering, og én gang per kundeorganisasjon. Hva en app betaler per dag for identitets- og virksomhetsverifisering har en grense: 250 € eks. mva., med mindre du endrer den i konsollen under Daglig grense for verifiseringer. Når den er nådd, avvises nye identitetsverifiseringer til neste dag, kundene dine betaler selv for virksomhetsverifiseringen, og administratorene dine får en e-post.

Testmodus

Så lenge appen din ikke er live, gir en bedriftsverifisering som startes fra en innlogging i den, et testresultat. Ingen betaling, intet bilde av ID og ingen saksbehandler, og organisasjonens ekte verifisering endres ikke. De fire siste sifrene i organisasjonens registrerings- eller mva-nummer velger resultatet:

Fire siste sifreResultatkyb.status
0001 eller et hvilket som helst annet nummerGodkjentapproved
0002Ikke godkjentrejected
0003Sendt til en saksbehandlerin_review
0004Sanksjonstreffin_review
0005Utløptnone

Testresultater har test: true i claimet, webhooken og rapporten, og bare appen din ser dem så lenge den ikke er live. Registreringsnumre er unike på Dazr, så bruk ditt eget, for eksempel et nederlandsk KVK-nummer som 1234 0002. I konsollen kan du også sende en test-webhook for hvert resultat.

Tokener og levetider

TokenLevetid og regler
Autorisasjonskode60 sekunder, engangsbruk, bundet til klienten, omdirigerings-URI-en og PKCE-utfordringen din. Brukes en kode to ganger, tilbakekalles tokenene den utstedte.
Tilgangstoken10 minutter. En signert JWT (ES256, typ at+jwt) med aud = klient-ID-en din. Send den som Authorization: Bearer.
ID-token10 minutter. ES256, med iss, sub, aud, exp, iat, auth_time, nonce og amr der de er kjent.
OppdateringstokenBare med offline_access. Roteres ved hver bruk: lagre alltid det nye. Sender du et gammelt oppdateringstoken igjen, tilbakekalles hele innloggingen. Utløper etter 30 dager uten bruk og senest etter 180 dager.

Signeringsnøkler roteres. Velg alltid nøkkelen etter kid fra JWKS, og oppdater JWKS når du ser en ukjent kid.

Hvordan personen logget inn

amr i ID-tokenet (RFC 8176) sier hvordan personen logget inn: ["otp"] for en engangskode på e-post, ["hwk", "user"] for en passnøkkel med brukerverifisering og ["fed"] for Google eller Microsoft.

Språk

Send ui_locales med autorisasjonsforespørselen, for eksempel ui_locales=de-AT de en. Det første språket Dazr støtter, brukes på innloggings- og samtykkeskjermene. Språkene som støttes, står i ui_locales_supported i discovery-dokumentet.

Scopet sign

Scopet sign i discovery-dokumentet er bare for Dazr Sign API. Det lar en app sende dokumenter til signering på vegne av personen; du slår det på i Dazr Sign-portalen. Sign in with Dazr Identity trenger det ikke.

Dazr Files-API og WebDAV (bare lesing)

Med Dazr Files-API kan appen din vise og laste ned filer fra Dazr Files, for eksempel for å ta sikkerhetskopi av dem. Det er skrivebeskyttet: ingen forespørsel kan laste opp, endre, flytte, dele eller slette noe. Slå det på for appen i konsollen, på appens side under Dazr Files API. Det bruker samme app, klient-ID og hemmelighet som Logg på med Dazr Identity, og de samme tilgangstokenene.

Det finnes to veier inn. En eier eller administrator i en organisasjon godkjenner appen din for organisasjonens delte filer, og serveren din får da tokener uten en person (best for automatiske sikkerhetskopier). Eller en person gir appen tillatelse med scopet files.read, og appen leser personens egne filer.

Den fullstendige referansen med alle endepunkter, eksempler, feil, grenser, endringsfeeden og WebDAV-oppsett for rclone og Synology finnes i dokumentasjonen for Dazr Files-API.

Organisasjonsinnstillinger som påvirker innlogging

Feil

Så lenge klient-ID-en og omdirigerings-URI-en din er gyldige, kommer feil tilbake til omdirigerings-URI-en din som error, error_description, state og iss: for eksempel invalid_request (som manglende eller plain PKCE), invalid_scope, unsupported_response_type, access_denied (personen avbrøt, eller appen er i testing og personen er ikke medlem), login_required, consent_required og interaction_required (med prompt=none, når en påkrevd verifisert organisasjon mangler). Med en ukjent klient eller en uregistrert omdirigerings-URI viser Dazr en feilside og omdirigerer aldri. Tokenendepunktet svarer med JSON-feil som invalid_client, invalid_grant og unsupported_grant_type.

Utlogging

For å logge ut noen sender du dem til utloggingsendepunktet med id_token_hint (eller client_id), en valgfri post_logout_redirect_uri registrert i appinnstillingene og state. Dazr spør om de også vil logge ut av Dazr Identity på den enheten, og sender dem så tilbake. Tilbakekall oppdateringstokener du ikke lenger trenger, ved tilbakekallingsendepunktet.

Testing og lansering

En ny app er i testing: bare medlemmer av organisasjonen din kan logge inn, og samtykkeskjermen sier det. For å lansere får du organisasjonen din verifisert i Dazr Identity, legger til en https://-omdirigerings-URI og ber om en gjennomgang for lansering i konsollen. Endrer du navnet, formålet, personvernerklæringen eller dataene til en lansert app, trengs en ny gjennomgang.

Overfør en app til en annen organisasjon

En app kan flyttes til en annen organisasjon som er registrert hos Dazr, for eksempel etter et salg eller en omorganisering. En eier eller administrator starter overføringen under Overfør app i appinnstillingene, i Dazr Identity eller i Sign-portalen. En eier eller administrator i den andre organisasjonen godtar eller avslår den innen 14 dager. Fram til da kan avsenderen avbryte, og ingenting endres.

Knappen

Bruk ordlyden «Sign in with Dazr Identity» og Dazr-logoen som nedenfor. Du kan endre størrelsen, ikke logoen, fargene eller ordlyden. Lenk den til din egen rute som starter flyten.

<a href="/auth/dazr" style="display:inline-flex;align-items:center;gap:10px;height:44px;padding:0 18px;border-radius:22px;background:#18203a;color:#fff;font: 600 15px/1 'Dazr', system-ui, sans-serif;text-decoration:none">
  <svg width="20" height="20" viewBox="0 0 100 100" aria-hidden="true"><path d="M64.133 21.813 A6.634 6.634 0 0 1 66.455 31.054 A2.552 2.552 0 0 0 67.912 34.849 A36.74 36.74 0 0 1 93.010 60.100 A2.654 2.654 0 0 1 88.914 62.984 A44.91 44.91 0 0 0 62.003 54.621 A3.062 3.062 0 0 0 59.161 56.689 A73.49 73.49 0 0 0 56.170 92.578 A2.654 2.654 0 0 1 51.111 94.052 A36.74 36.74 0 0 1 52.093 63.128 A1.225 1.225 0 0 0 52.182 62.260 L48.938 50.153 A1.429 1.429 0 0 0 47.187 49.142 L35.080 52.387 A1.225 1.225 0 0 0 34.373 52.898 A36.74 36.74 0 0 1 8.083 69.210 A2.654 2.654 0 0 1 6.830 64.091 A73.49 73.49 0 0 0 36.416 43.557 A3.062 3.062 0 0 0 36.785 40.062 A44.91 44.91 0 0 0 16.087 20.937 A2.654 2.654 0 0 1 16.536 15.948 A36.74 36.74 0 0 1 50.954 25.058 A2.552 2.552 0 0 0 54.969 24.423 A6.634 6.634 0 0 1 64.133 21.813 Z" fill="#ffffff"/></svg>
  Sign in with Dazr Identity
</a>

Dazr-skriften. Knappen bruker Dazr-skriften, som er gratis å bruke under SIL Open Font License. Der Dazr-skriften ikke er lastet inn, brukes systemskriften i stedet. Last ned Dazr-skriften (ZIP med TTF- og WOFF2-filer) for å hoste den på ditt eget nettsted:

/* woff2 files from the ZIP, copied to /fonts/ on your site */
@font-face { font-family: 'Dazr'; font-weight: 400; font-display: swap;
  src: url('/fonts/dazr-regular-latin.woff2') format('woff2'); }
@font-face { font-family: 'Dazr'; font-weight: 700; font-display: swap;
  src: url('/fonts/dazr-bold-latin.woff2') format('woff2'); }
.dazr-signin { font: 600 15px/1 'Dazr', system-ui, sans-serif; }

Et minimalt Node.js-eksempel

Node 18 eller nyere, ingen avhengigheter. En app med webserver og klienthemmelighet; for en offentlig klient fjerner du Authorization-headeren og sender client_id i innholdet.

import crypto from 'node:crypto';
const issuer = 'https://identity.dazr.eu';
const clientId = process.env.DAZR_CLIENT_ID;
const clientSecret = process.env.DAZR_CLIENT_SECRET;
const redirectUri = 'https://app.example.eu/auth/dazr/callback';
const b64url = (buf) => Buffer.from(buf).toString('base64url');

// 1. Start: keep verifier, state and nonce in the user's session.
export function start(session) {
  session.verifier = b64url(crypto.randomBytes(32));
  session.state = b64url(crypto.randomBytes(16));
  session.nonce = b64url(crypto.randomBytes(16));
  const challenge = b64url(crypto.createHash('sha256').update(session.verifier).digest());
  return issuer + '/oauth/authorize?' + new URLSearchParams({
    response_type: 'code', client_id: clientId, redirect_uri: redirectUri,
    scope: 'openid profile email', state: session.state, nonce: session.nonce,
    code_challenge: challenge, code_challenge_method: 'S256',
  });
}

// 2. Callback: check state, exchange the code, verify the ID token.
export async function callback(session, query) {
  if (query.error) throw new Error('sign-in failed: ' + query.error);
  if (query.state !== session.state || query.iss !== issuer) throw new Error('state or issuer mismatch');
  const res = await fetch(issuer + '/oauth/token', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/x-www-form-urlencoded',
      Authorization: 'Basic ' + Buffer.from(clientId + ':' + clientSecret).toString('base64'),
    },
    body: new URLSearchParams({ grant_type: 'authorization_code', code: query.code, redirect_uri: redirectUri, code_verifier: session.verifier }),
  });
  const tokens = await res.json();
  if (!res.ok) throw new Error(tokens.error);
  const claims = await verifyIdToken(tokens.id_token, session.nonce);
  return { sub: claims.sub, email: claims.email, name: claims.name, tokens };
}

async function verifyIdToken(idToken, nonce) {
  const [h, p, s] = idToken.split('.');
  const header = JSON.parse(Buffer.from(h, 'base64url'));
  const { keys } = await (await fetch(issuer + '/oauth/jwks')).json();
  const jwk = keys.find((k) => k.kid === header.kid);
  if (!jwk || header.alg !== 'ES256') throw new Error('unknown signing key');
  const ok = crypto.verify('sha256', Buffer.from(h + '.' + p),
    { key: crypto.createPublicKey({ key: jwk, format: 'jwk' }), dsaEncoding: 'ieee-p1363' }, Buffer.from(s, 'base64url'));
  const c = JSON.parse(Buffer.from(p, 'base64url'));
  const now = Math.floor(Date.now() / 1000);
  if (!ok || c.iss !== issuer || c.aud !== clientId || c.exp < now - 30 || c.nonce !== nonce) throw new Error('invalid ID token');
  return c;
}

Grenser

Autorisasjons- og tokenendepunktene har begrenset antall forespørsler. Får du HTTP 429, vent og prøv igjen; ikke prøv på nytt i en tett løkke.

EndepunktGrense
/oauth/authorize120 forespørsler i minuttet per IP-adresse
/oauth/token600 forespørsler i minuttet per IP-adresse og 300 i minuttet per app
/oauth/userinfo1 200 forespørsler i minuttet per IP-adresse
/oauth/verification-report120 forespørsler i minuttet per IP-adresse og 60 i timen per app
Virksomhetsverifisering6 starter i timen per person og 10 om dagen per organisasjon
Test-webhooks30 hvert 10. minutt per person

Pliktene dine

Organisasjonen din er selvstendig behandlingsansvarlig for dataene den mottar. Utviklervilkårene for Dazr Identity fastsetter hva du kan gjøre med dem, hvordan du holder dem sikre og hvordan du melder brudd. Spørsmål: hello@dazr.eu.

For sikkerhets- og juridisk gjennomgang: sikkerhets- og innkjøpspakken.