Pre-produktionsmiljø - Information til Tjenesteudbydere

Vi anbefaler, at tjenesteudbydere som udgangspunkt benytter 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ø

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 behøves ikke 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)

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
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.
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
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
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 på tu.nemlog-in.dk
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-tjenester på tu.nemlog-in.dk

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.

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