Integrationstestmiljø

Når I som tjenesteudbydere eller brokere skal integrere til NemLog-in, anvender I som udgangspunkt integrationstestmiljøet hertil.

Integrationstestmiljøet ligner funktionelt produktion mest samt er det mest driftsstabile testmiljø.

Tilgå oversigt, der sammenholder funktionerne i hvert miljø

Integrationstest

Opsætningen af jeres tjeneste sker via NemLog-in Administrationen.

Sæt jeres it-system op via NemLog-in Administrationen

Integrationstest i integrationstestmiljøet dokumenteres af tjenesteudbyderens tekniske administrator i følgende 4 trin:

I downloader blanket til testrapporten nedenfor.
I udfører de obligatoriske tests for it-systemet, som er beskrevet i vejledningen, der også kan downloades nedenfor.
I uploader resultatet af de obligatoriske tests i en testrapport.
I godkender den ventende opgave, hvorefter testrapporten sendes til godkendelse ved NemLog-in Forvaltningen.

Hvis alle obligatoriske test ikke udføres og bestås uden en grundig beskrivelse for, hvorfor testen ikke kan gennemføres, vil testrapporten ikke blive godkendt.

Hent vejledning om integrationstest ved tilslutning til NemLog-in (pdf)

Blanket til testrapport:

NemLog-in – Integrationstestrapport til offentlige tjenester (word)

NemLog-in – Integrationstestrapport til private tjenester (word)

OBS! Testrapporter for broker-tjenester godkendes først, når tjenesten har en godkendt NSIS-anmeldelse.

Tilslutning af din tjeneste til integrationstestmiljøet kræver, at dit system er konfigureret med teknisk information om integrationstestmiljøet. Denne information er samlet i en SAML metadata-fil. Filen kan hentes nedenfor.

Metadata er defineret særskilt for de to forskellige OIOSAML-profiler i integrationstestmiljøet. Hvis din tjeneste skal anvende OIOSAML3 skal du anvende OIOSAML 3-metadata.

Hent metadata for NemLog-ins broker (IdP) på siden med metadataene
Du kan hente et eksempel på en OIOSAML 3 metadata-fil på en testtjenesteudbyder.

Bemærk:
- Private tjenesteudbydere skal udlade 'PrivilegesIntermediate' og 'cprNumber' fra metadata
- Vi anbefaler, at I anvender jeres eget certifikat
- I skal opdatere URL'er og EntityID anvendt, så det stemmer overens med den tjeneste, I gerne vil teste.
Hent metadata eksempel (xml)

Testtjenester

Integrationstestmiljøet udstiller et antal testtjenester, som kan anvendes i forskellige testscenarier.

Test-tjeneste	OIOSAML-version	NameIDFormat	Privat/offentlig
TU0	2.0.9*	X509Subject	Offentlig
TU1	2.1.0	X509Subject	Offentlig
TU2	2.1.0	Persistent Pseudonym	Offentlig
TU3	3.0.2	Persistent	Offentlig
TU4	3.0.2	Transient	Offentlig
TU5	3.0.2	Persistent	Privat
TU6	3.0.2	Transient	Privat

*OIOSAML 2.0.9 er ikke understøttet i integrationstestmiljøet, men denne testtjeneste forespørger en eller flere af de udfasede attributter i metadata.

Opret en MitID-testidentitet i MitID Simulatoren

NemLog-in indeholder en MitID Simulator, der kan oprette MitID privatbrugere, som kan logge ind via 'Test Login' fanen i NemLog-in med brugernavn og password.

Tilgå MitID Simulatoren

Angiv:
- brugernavn
- password
- fornavn, som er fiktivt
- efternavn, som er fiktivt
- fiktivt CPR-nummer
- e-mailadresse.
Fornavn, efternavn og CPR-nummer skal være fiktive, da integrationstestmiljøet er et testmiljø.

I kan angive jeres egen e-mailadresse som administrator e-mailadresse, hvis der senere skal ændres på testidentitetens data.

Husk: Sæt flueben i private MitID, hvis brugeren skal bruges til MitID privat login, men undlad at sætte flueben her, hvis brugeren skal bruges til test af erhvervslogin.

Klik 'Create identity'.

Du kan også oprette testbrugere via MitID's test tool, som kan logge ind via MitID fanen i NemLog-in (se menupunkt under) via brug af simuleret to-faktor login.
Ved hjælp af MitID test-tool kan I oprette og vedligeholde MitID test-identiteter, som kan logge ind via 'MitID' fanen i NemLog-in via simuleret to-faktor login. Dette er et alternativ til brug af MitID Simulatoren i NemLog-in.
Åben MitID test-tool

Når du tester med privat MitID er det også nødvendigt, at test-identiteten er oprettet i miljøets test-CPR-register. For at forberede en test med MitID skal du:
- Opret test-MitID i MitID test-tool
- Opret testidentitet med samme navn og CPR-nummer som test-MitID identiteten i MitID Simulator. Husk at sætte flueben i ”Private MitID”-boksen.
Tilgå MitID Simulator

NemLog-in stiller ydermere nedenstående testbrugere til rådighed til MitID test-tool, hvis man ikke ønsker at oprette egne testbrugere.

Brugernavne: Ellie999, Sabastian555 og Stig777

Password (for alle): Test1234

Åbn vejledning til anvendelse af testbrugere
Der udstilles en udgave af MitID Erhverv i integrationstestmiljøet. Det er muligt at oprette to forskellige typer testorganisationer.
- Testorganisationer med et ikke fiktivt CVR-nummer – her kan man kun oprette ens egen organisation ved at have tilsluttet samme CVR-nummer til MitID Erhverv i produktionsmiljøet. Her vil tilslutningen i produktion sikre tilknytningen til CVR-nummeret.
- Testorganisationer med et systemgenereret og fiktivt CVR-nummer startende med cifferet 9. Disse kan man oprette så mange af, som man har lyst.
Oprettelse og test af testorganisationer med et ikke fiktivt CVR-nummer
- Tilslut først din organisation til MitID Erhverv i produktionsmiljøet (hvis den ikke allerede er tilsluttet).
- En organisationsadministrator skal logge ind og kan herefter tilgå en webside med følgende formular hvor testorganisationen kan oprettes.
  - Åbn siden til administration af testorganisationer i MitID Erhverv
- Efter udfyldelse af formularen oprettes en testorganisation inklusiv en MitID Simulatorbruger, der kan agere som administrator for testorganisationen ved at logge ind på MitID Erhverv i integrationstestmiljøet.
  - Log ind på MitID Erhverv i integrationstestmiljøet
- Administratoren kan her oprette (test) erhvervsbrugere, udstede certifikater samt tildele rettigheder og erhvervsfuldmagter.
Herefter kan de oprettede testbrugere logge på (og signere) hos tjenesteudbydere tilsluttet NemLog-ins integrationstestmiljø. Det er også muligt at anvende de testtjenester, som allerede findes oprettet i integrationstestmiljøet, som fx Digitaliseringsstyrelsen Internal Test SP OIOSAML-3.0. Dette er fx nyttigt til test af single sign-on (SSO) med din egen testtjeneste.

Tilgå Digitaliseringsstyrelsen Internal Test SP OIOSAML-3.0

Oprettelse og test af testorganisationer med et fiktivt CVR-nummer
- Udfyld formularen på testportalen (kræver ikke login).
  - Opret en testbrugerorganisation på testportalen
- Efter udfyldelse af formularen oprettes en testorganisation inklusiv en MitID Simulatorbruger, der kan agere som administrator for denne ved at logge ind på: fx Digitaliseringsstyrelsen Internal Test SP OIOSAML-3.0
- Administratoren kan her oprette (test)erhvervsbrugere, udstede certifikater samt tildele rettigheder og erhvervsfuldmagter.
Log ind på MitID Erhverv i integrationstestmiljøet

Herefter kan testbrugerne logge på (og signere) hos tjenesteudbydere tilsluttet NemLog-ins integrationstestmiljø.

Tilgå Digitaliseringsstyrelsen Internal Test SP OIOSAML-3.0

Avanceret funktionalitet kræver særlige rettigheder

Hvis man har brug for at teste avanceret funktionalitet, skal testorganisationen tildeles nogle særlige rettigheder:
- Test af Lokal IdM API’er
- Udstedelse af (persistente) kvalificerede certifikater
- Tilslutning af Lokal IdP
Læs mere om avanceret funktionalitet på MitID Erhvervs hjemmeside

I kan få de særlige rettigheder tildelt ved at henvende jer til NemLog-in Forvaltningen og bede om adgang. Husk at oplyse:
- CVR-nummeret
- at der er tale om integrationstest
- hvilke af de 3 ovennævnte funktionaliteter I skal teste.
Forvaltningen kan herefter åbne for de avancerede funktioner for testorganisationen.

Kontakt NemLog-in Forvaltningen
I produktionsmiljøet integrerer NemLog-in til det danske CPR-register. Data herfra anvendes blandt andet for at kunne oplyse for- og efternavne samt den nye CPRUUID attribut i SAML assertions. Integrationstestmiljøet integrerer ikke til det danske CPR-register, men anvender i stedet et test-CPR-register. Indholdet i test-CPR-registreret oprettes, når der oprettes private test-identiteter i MitID Simulator med CPR-numre.

Når en privat testidentitet oprettes i MitID Simulator, registreres følgende oplysninger for identiteten i test-CPR-registeret:
- CPR-nummer
- Fornavn
- Efternavn
- CPRUUID.
For CPRUUID anvendes samme UUID, som tildeles til MitID Simulator identiteten. Når du anvender MitID Simulator-brugergrænsefladen genererer MitID Simulator dette UUID. Hvis du ønsker selv at bestemme hvilket UUID, der anvendes, og dermed hvilket CPRUUID, der registreres i test-CPR-registeret, kan du anvende MitID Simulator API'et.

Åben MitID simulator

Åben MitID simulator API
NemLog-in indeholder et Certificate Authority (CA), der kan udstede VOCES certifikater efter OCES3 politikker og profiler. Certifikaterne bestilles nemmest gennem brugerfladen i MitID Erhverv applikationen (eller alternativt de tilhørende API'er).

Læs mere om OCES3 politikker og profiler på Den Danske Stats hjemmeside for Tillidstjenester

MitID Erhverv applikationen udstilles efter Release 8 i integrationstestmiljøet. Det er også her I kan bestille OCES3 testcertifikater.

Bemærk, at pre-produktionsmiljøet og integrationstestmiljøet i NemLog-in er koblet til samme bagvedliggende (test) CA. Du kan hente et eksempel på et OCES3 systemcertifikat nedenfor:

Hent: OCES3 systemcertifikat

Certifikat-filen er i PKCS#12 format og adgangskoden er: c5,PnmF8;m4I
Oplever I fejl i løbet af jeres integration til NemLog-in, kan I finde hjælp til fejlsøgning.

Åben vejledning: Hjælp til fejlsøgning af din tjeneste

LogViewer

For NemLog-ins integrationstestmiljø er det muligt at tilgå loggen. Dette sker via LogVieweren.

Åben LogViewer

Har du brug for hjælp til at anvende LogVieweren kan du læse mere i tilhørende vejledning.

Åben vejledningen: Hjælp til anvendelse af LogVieweren
Private tjenester kan ikke direkte få udleveret CPR-nummer attributten fra NemLog-ins broker som en del af SAML billetten i autentifikationssvaret.

Hvis en privat tjeneste har brug for at kende en slutbrugers CPR-nummer, skal denne i stedet anvende en match-model, hvor slutbrugeren selv indtaster sit CPR-nummer i tjenesten, og hvor tjenesten herefter ved brug af et match-opslag kan verificere, om der er angivet det korrekte CPR nummer for den autentificerede bruger.

Der er følgende match-opslag til rådighed:

SubjectMatchesCpr metoden i NemLog-in's opslagstjeneste tager som input et CPR-nummer og SAML Subject fra autentifikationen, og returnerer om der er match. Dette er den anbefalede metode til CPR-match.

Begge disse metoder er understøttet i NemLog-in's testmiljøer såvel som produktion.

Dokumentationen for NemLogin's opslags- og match-tjenester findes her
Det er muligt at vise NemLog-in tjenesteudbyderens navn i MitID klienten, når brugeren logger på. Dette for at øge gennemsigtigheden for slutbrugere omkring, hvilken tjeneste, der logges ind på i andet led, hvor sub-brokeren fremover skal medsende et navn på tjenesten, således NemLog-in kan vise dette i MitID klienten. Det betyder, at slutbrugere på loginsiden møder:

Log på 'Sub-brokerens navn' på vegne af: 'Tjenesteudbyderens navn'.

Hvordan skal I gøre?

Sub-brokere skal medsende den bagvedliggende tjenesteudbyders navn i deres SAML Autentifikationsforespørgsel i feltet ’ProviderName’ med en værdi beregnet som Base64(UTF8(<friendlyName>) og en maksimal længde på 100 tegn. Feltet må kun angives ved forespørgsler om autentifikation og ikke ved signering.
NemLog-ins broker danner normalt en session med den browser, hvormed brugeren autentificerer sig. Sessionen er grundlaget for Single Sign-On (SSO) og Single Log-Out (SLO) for de applikationer, der udfører myndighedsopgaver.

Det er ikke hensigtsmæssigt for alle it-systemer at etablere browsersessioner som sideeffekt af en autentifikation, herunder fx ved indrulleringsflows i native Apps, som anvender systembrowseren til interaktion med NemLog-in.

Følg integrationsvejledningens afsnit 9.4 for at implementere login uden sessionsdannelse (på engelsk) (pdf)

Integrationstest

Vi bruger cookies for at forstå, hvordan du bruger denne hjemmeside