Integrationstest

Oprettelse af en tjeneste (it-system)

• Trin 1: Opret tjeneste

  For at oprette en ny tjeneste skal Administrator for it-systemudbyder, en direktør eller lignende, initiere processen. 

  Administratoren skal logge på Administrationen og gøre følgende:

  1. Klik "Opret nyt IT-system"
  2. Vælg hvilke NemLog-in services, systemet skal gøre brug af fx log-in. Vær opmærksom på at såfremt tjenesten skal videreformidle autentifikationer, skal I oprette en broker-tjeneste, hvilket kræver en NSIS-anmeldelse.
  3. Tilføje et MitID alias for tjenesten, det vil sige navnet for tjenesten, som vil fremgå ved log-in med NemID eller MitID
  4. Udpege én eller tekniske administratorer

  Den tekniske administrator skal herefter: 

  1. Indlæse metadata
  2. Provisionere tjenesten og anmode om at systemet overføres til integrationstestsmiljøet
  3. Godkende overførslen af systemet under "Ventende opgaver"
• Trin 2: Test jeres integration

  Den tekniske administrator skal nu teste integrationen af tjenesten til NemLog-in, hvilket gøres på følgende måde:

  1. Download kladde for testrapport
  2. Udføre de obligatoriske tests for tjenesten
  3. Indlæse resultatet af de obligatoriske tests i en testrapport
  4. Godkende den ventende opgave, hvorefter testrapporten sendes til godkendelse ved NemLog-in forvaltningen

  Udføres og bestås alle obligatoriske test ikke, og såfremt der ikke foreligger en grundig beskrivelse for, hvorfor testen ikke er gennemført, vil testrapporten ikke blive godkendt.

  I kan med fordel læse yderligere om Integrationstest ved tilslutning til
  NemLog-in her: Hent: Testbeskrivelser (pdf)

• Trin 3: Afvent godkendelse

  Afvent godkendelse af overførsel til produktionsmiljøet fra NemLog-in supporten.

  Vær opmærksom på, at rapporten for en broker-tjeneste, først kan godkendes, når tjenesten er NSIS-anmeldt og er kommet på positiv-listen.

  Når MitID og NemLog-in3 går i luften, vil NSIS blive taget i fuld anvendelse. Dette medfører, at tjenesteudbydere skal fastlægge, hvilket sikringsniveau, de vil modtage. Tjenesteudbydere skal ikke NSIS-anmeldes.

  I kan læse mere om ibrugtagning af NSIS-standarden her: Læs mere om ibrugtagning af NSIS-standard

• Trin 4: Overførsel af tjeneste til produktionsmiljø

  NemLog-in supporten har nu godkendt rapporten, og tjenesten overføres til produktionsmiljøet.

 

Vejledninger og værktøjer

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

• Obligatoriske integrationstests

  Inden en tjenesteudbyder kan idriftsætte sin tjeneste, skal der gennemføres en række obligatoriske tests i integrationstestmiljøet.

  De obligatoriske tests udføres af tjenesteudbyderens tekniske administrator.

  Hent: Testbeskrivelser (pdf)

  Når de obligatoriske tests er gennemført, skal der udfyldes en testrapport, som herefter indlæses i Administrationen, hvorefter NemLog-in supporten står for at godkende overførsel til produktionsmiljøet.

  Hent: Testrapport for offentlige tjenester (doc)

  Hent: Testrapport for private tjenester (doc)

  Udføres og bestås alle obligatoriske test ikke, og såfremt der ikke foreligger en grundig beskrivelse for, hvorfor testen ikke er gennemført, vil testrapporten ikke blive godkendt.

• 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.

• Testbrugere

  Opret en MitID-testidentitet i MitID Simulatoren.

  Link til MitID Simulatoren: https://mitidsimulator.test-nemlog-in.dk/

  I MitID simulatoren kan I nu oprette en privat MitID-testidentitet, som bruges som identifikationsmiddel for en testmedarbejder.

  Angiv Brugernavn, password, fornavn, efternavn, fiktivt CPR-nummer og e-mailadresse.

  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. 

  Klik 'Create identity'.

  

  NemID medarbejdersignatur

  NemLog-in stiller nedenstående NemID medarbejdersignaturer til rådighed til test:

  NemID testbrugere:

  MitID

  NemLog-in stiller ydermere nedenstående fiktive testbrugere til rådighed til MitID Test Tool.

  Brugere: Ellie999, Sabastian555 og Stig777

  Password: Test1234

  Åbn vejledning til anvendelse af testbrugere

• Brug af test-CPR-register

  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

• Test med NemID Privat

  Hvis du ønsker at foretage test med NemID privat, skal du være opmærksom på, at før du kan logge ind i testmiljøet med et privat test-NemID, skal test-data (CPR-nummer og navn for testidentiteten) være oprettet i testmiljøets test-CPR-register. Dette sker automatisk, når testidentiteten oprettes i MitID Simulator, som beskrevet ovenfor.

  For at forberede en test med privat NemID skal du gøre følgende:

  • Opret test-NemID på https://appletk.danid.dk/developers/. Adgang kræver NemID aftale og whitelisting af IP-adresse hos NemID.
  • Opret testidentitet med samme navn og CPR-nummer som test-NemID identiteten i MitID Simulator https://mitidsimulator.test-nemlog-in.dk/ Husk at sætte flueben i ”Private MitID”-boksen. 

  Herefter er du klar til at teste med privat NemID.

  Hvis dit test-NemID er oprettet før den 20/6-2021, er identiteten allerede registreret i MitID Simulator og test-CPR-registeret.

• Test med MitID Privat

  Ved hjælp af MitID test-tool kan I oprette og vedligeholde test-identiteter.

  • Åben MitID test-tool

  Når du tester med privat MitID er det også nødvendigt, at test-identiteten er oprettet i test-CPR-registeret. 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 https://mitidsimulator.test-nemlog-in.dk/ Husk at sætte flueben i ”Private MitID”-boksen.
• Attribute Query

  Det er også muligt at teste NemLog-in Attribute Service i integrationstestmiljøet.

  Åbn attribute query

   

• Metadata eksempel - testtjeneste

  Du kan hente et eksempel på en OIOSAML 3 metadata-fil på en test-tjenesteudbyder. 
  
  Bemærk at:

  • Private tjenesteudbydere skal udlade 'PrivilegesIntermediate' og 'cprNumber'.

  • 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)

• Metadata

  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 distribueres med OIOSAML referenceimplementeringerne, men kan også hentes her.

  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.

  Åbn: IdP-metadata - OIOSAML 3

  Hvis din tjeneste derimod skal anvende OIOSAML2, skal du anvende OIOSAML 2-metadata. 

  Åbn: IdP-metadata - OIOSAML 2

  Bemærk, at navnet for SE-enheds-attributten her er ændret for at overholde OIOSAML 2 specifikationen. Attributten har navnet dk:gov:saml:attribute:SENumberIdentifier, ikke (som tidligere) dk:gov:saml:attribute:seNumberIdentifier.

• Fejlfinding

  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

   

  LogViwer

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

  Åbn 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

• FOCES testcertifikater

  Du skal bruge et FOCES-certifikat i forbindelse med tilslutning af din tjeneste. Find et FOCES testcertifikat nedenfor eller via OIOSAML referenceimplementeringerne.

  Hent: FOCES testcertifikat

  Certifikat-filen er i PKCS#12 format og adgangskoden, der beskytter filen, er: Test1234.

Indhold fra den tidligere testportal

Orientér dig i indholdet fra den tidligere testportal