Pre-produktionsmiljø

Tjenesteudbydere benytter som udgangspunkt integrationstestmiljøet i NemLog-in til at teste integrationen af deres it-systemer (fx login og signering). Der er mulighed for at oprette brugerorganisationer i en testinstans af MitID Erhverv, således der blandt andet kan testes login og signering med erhvervsbrugere i integrationstestmiljøet.

Læs mere om integrationstestmiljøet og dets muligheder.

Hvad er pre-produktionsmiljøet

I pre-produktionsmiljøet har man mulighed for at foretage tidlig test af ny funktionalitet, der er på vej op gennem NemLog-ins miljøer, men endnu ikke er frigivet i integrationstestmiljøet.

Pre-produktionsmiljøet har et produktionsben (PROD) og et integrationstestben (INT) med hver sit sæt af IdP'er og metadata. Vi anbefaler, at I anvender integrationstestbenet (test-devtest4.nemlog-in.dk) i videst muligt omfang, da der her er større fleksibilitet (fx er der ikke behov for godkendelsesflow).

Tilslutning af tjenesteudbydere

Der er udarbejdet en vejledning, som beskriver, hvordan tjenesteudbydere bliver tilsluttet Nemlog-ins pre-produktionsmiljø og kommer i gang med test. Find vejledningen via linket nedenfor.

Gå til vejledning for tilslutning af tjenesteudbydere til pre-produktionsmiljø

Hvis du vil anvende pre-produktionsmiljøet til at oprette en brugerorganisation i MitID Erhverv og udstede OCES3 testcertifikater, kan du læse mere på siden for brugerorganisationer.

Pre-produktionsmiljø for brugerorganisationer (Devtest4)

• Komponenter i miljøet

  I denne guide finder du links og en tegning, som illustrerer pre-produktionsmiljøet (Devtest4).

  Links og miljøoversigt (opdateret den 10. januar 2023).

• Metadata for NemLog-ins broker

  Hvis din tjeneste ønsker at anvende NemLog-in's broker (SAML IdP'er) til brugerautentifikation i pre-produktionsmiljøet kræver det, at dit system er konfigureret med teknisk information om brokerens certifikat og endpoints i miljøet. Denne information er samlet i en SAML metadata-fil, som kan hentes nedenfor.

  Metadata

• Metadata for tjenesteudbyder (eksempel)

  En tjenesteudbyder skal danne en SAML metadatafil, som uploades i NemLog-in's Administrationsportal.

  Du kan hente et eksempel på en OIOSAML3 metadata fil for en test-tjenesteudbyder via linket nedenfor.

  Bemærk:

  • Private tjenesteudbydere skal udelade '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 eksempel på OIOSAML3 metadata for test-tjenesteudbydere (xml)

  Du skal desuden bruge et OCES3 systemcertifikat ifm. tilslutning af din tjeneste, som du kan finde nedenfor.

  Certifikat-filen er i PKCS#12 format og adgangskoden er: c5,PnmF8;m4I

  Hent PKCS#12 OCES3 systemcertifikat

• Metadatavalidatoren

  Teknisk administrator har i pre-produktionsmiljøet mulighed for at validere metadata her:

  NemLog-in pre-produktionsmiljø - metadatavalidator

   

• Tjenesteudbydernavn i klienten

  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 klien-ten. 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.

• Privat MitID testbruger

  Den nemmeste måde at lave en privat MitID testbruger er ved brug af MitID Simulatoren. Disse brugere kan logge ind i 'Test Login' fanen på NemLog-in.

  Gå til MitID Simulator

  Du kan også benytte MitID test-tool til at oprette og vedligeholde test-identiteter i MitID. Disse kan logge ind i MitID-fanen på NemLog-in.

  Gå til MitID test tool

  Når du tester med brugere fra MitID test tool er det også nødvendigt, at test-identiteten er oprettet i test-CPR-registeret i miljøet. 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

  Hvis du har brug for at teste med MitID Erhverv testbrugere, kan du læse mere på siden om pre-produktionsmiljøet for brugerorganisationer:

  Pre-produktionsmiljøet for brugerorganisationer

• Servercertifikat for NemLog-ins opslagstjeneste

  Herunder finder du servercertifikatet for NemLog-ins opslagstjeneste til integrationstestmiljøet og pre-produktion. Certifikatet blev ibrugtaget den 9. oktober 2023.

  Certifikatet anvendes til at signere svar på SOAP snitfladen (REST snitfladen anvender ikke certifikatet men baserer sig på TLS).

  Hent OCES3 servicecertifikat til NemLog-ins opslagstjeneste på siden med metadata

• Klientcertifikat til opslagstjeneste

  Hvis du har brug for at teste en af opslagstjenesterne fra afsnit 2 i Supporting Services-dokumentet, kan du anvende et klient-certifikat, som allerede har tildelt de nødvendige privilegier. Du skal bruge klient-certifikatet, når du kalder STSen.

  NemLog-in Supporting Services (engelsk)(pdf)

  Du kan hente et sådant certifikat, der blev ibrugtaget den 10. august 2023, her:

  Hent testcertifikat for opslagstjeneste

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

  Opslagstjenestens SAML EntityID i testmiljøet er:

  • I miljøets integrationstestben: https://saml.wsp.lookupservice.test-devtest4-nemlog-in.dk
  • I miljøets produktionsben: https://saml.wsp.lookupservice.devtest4-nemlog-in.dk

  Du kan læse mere om dokumentation og guides

• UUID match-tjeneste

  Ved test af UUID match tjenester skal I være opmærksomme på følgende:

  • Det samme klientcertifikat må ikke anvendes på tværs af tjenester. Hver tjenesteudbyder, som skal anvende UUID-match, opfordres derfor til at anvende eget certifikat i MitID Erhverv. Dette certifikat skal angives i metadata for tjenesten
  • For at kunne benytte UUID match, skal "Kvalificeret signeringstjeneste" tilvælges ved tilslutning af tjenesten i NemLog-in Administration

  Du kan læse mere om opslags- og match-tjeneste

• Test med MitID Erhvervsbrugere og OCES3 certifikater

  Hvis du har brug for at teste med MitID Erhverv testbrugere eller udstede OCES3 certifikater, kan du oprette en test-brugerorganisation.

  Læs mere på vores hjemmeside om Pre-produktionsmiljø for brugerorganisationer (Devtest4)

• Test-tjenester

  Testmiljøet udstiller et antal test-tjenester, som kan anvendes i forskellige test-scenarier:

  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 testmiljøet, men denne test-tjeneste forespørger en eller fere af de udfasede attributter i metadata.

• Test CPR register

  I produktionsmiljøet integrerer NemLog-in til det danske CPR-register. Data herfra anvendes bl.a. for at kunne oplyse for- og efternavne samt den nye CPR-UUID attribut i SAML assertions. Testmiljø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 test-identitet 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:

  Tilgå MitID Simulater API'et

• Log viewer
  Pre-produktionsmiljøet giver adgang til systemets log. Adgang sker via LogViewer brugergrænsefladen. Der er kun adgang til log for Integrationtest-delen af miljøet.

  Tilgå vejledning til LogViewer

  Tilgå LogViewer

• Security Token Service

  Hvis din tjeneste skal integrere til NemLog-in Secure Token Service (STS) har du brug for yderligere information.

  STS-komponenten i testmiljøet kan tilgås her:

  Hent Security Token Service til test

  Hent metadata for Attribute Query samt Security Token Service på siden med metadataene

• Attribute query

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

  Hent metadata for Attribute Query samt Security Token Service på siden med metadataene

• Login uden sessionsdannelse

  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)