Test af MitID Erhverv funktioner som brugerorganisationer i DevTest4-miljøet

I DevTest4-miljøet er det muligt at teste MitID Erhverv funktioner.

I kan fx teste:

• oprettelse af testbrugere
• udstedelse af testcertifikater
• IdM-integration
• tilslutning og anvendelse af Lokal IdP.

For at teste funktionerne skal I:

1. oprette en brugerorganisation til test
2. teste funktionerne.

1. Opret en brugerorganisation til test

Følg vejledninger nedenfor til at oprette en brugerorganisation til test.

• Hvis I ønsker at oprette en brugerorganisation til test med fiktivt CVR-nummer:

  Følg denne vejledning:

  Fiktivt CVR-nummer: Opret en brugerorganisation til test

  Den første del af videoen nedenfor viser, hvordan I skal oprette sådan en testorganisation.

  Episode 1: Oprettelse af testdata i MitID Erhverv

• Hvis I ønsker at oprette en brugerorganisation til test med selvvalgt navn og CVR-nummer:

  Følg denne vejledning:

  Selvvalgt navn og CVR-nummer: Sådan opretter I en it-systemudbyder eller brugerorganisation til test

  Videoen nedenfor viser, hvordan I skal oprette en brugerorganisation til test med selvvalgt navn og CVR-nummer:

  Episode 3: MitID Erhverv testdata via CVR simulator 

2. Test MitID Erhverv funktioner

Vælg et af funktionerne nedenfor, og læs mere om, hvordan I tester funktionen.

Opret testbrugere

For at oprette MitID Erhverv brugere (erhvervsbrugere) til test skal I gennemføre følgende 2 trin.

• 1. Opret private MitID brugere til test i MitID Simulatoren

  Følg denne vejledning til at oprette private MitID brugere i MitID Simulatoren:

  Opret private MitID brugere til test

• 2. Opret disse private MitID brugere som MitID Erhverv brugere

  Følg denne vejledning til at oprette de oprettede private MitID brugere som MitID Erhverv brugere:

  Opret MitID Erhverv brugere til test

Opret MitID Privat til Erhverv-brugere til test

• Hvad er MitID Privat til Erhverv-brugere?

  MitID Privat til Erhverv-brugere er personer, der får automatisk mulighed for at handle digitalt på vegne af deres virksomhed eller forening med deres private MitID, selv om de ikke aktivt har tilsluttet sig MitID Erhverv.

  De er i CVR angivet med fuld tegningsret for en organisation, fx:

  • ejere (fuldt ansvarlige deltagere) i enkeltmandsvirksomheder,
  • foreningsrepræsentanter
  • personer, der kan tegne alene for et selskab mv.

  Læs mere om MitID Privat til Erhverv-brugere:

  MitID-Erhverv.dk: MitID Privat til Erhverv-brugere

• 1. Opret MitID testbruger med et fiktivt CPR nummer via MitID Simulatoren

  Følg denne vejledning:

  Opret private MitID brugere til test

• 2. Opret testorganisation med et selvvalgt navn og CVR nummer

  Følg denne vejledning:

  Selvvalgt navn og CVR-nummer: Sådan opretter I en it-systemudbyder eller brugerorganisation til test

• 3. Den oprettede testbruger skal tilknyttes som ledelsesrepræsentant i den oprettede testorganisation

  I skal tilknytte den private MitID bruger til test, som er oprettet i trin 1, som ledelsesrepræsentant i den testorganisation, som er oprettet i trin 2.

  Det skal I gøre ved at tilknytte brugerens CPR-nummer som ledelsesrepræsentant i CVR-stubben i EIA TestPortal Service (API-Swagger), I har anvendt i trin 2.

  EIA TestPortal Services

Udsted certifikater

• Udsted certifikater i MitID Erhverv DevTest4-miljøet

  Testcertifikater bestilles og udstedes i MitID Erhverv DevTest4-miljøet eller alternativt de tilhørende API'er.

  I skal logge ind på det ben, som I vil anvende til jeres tests. Login sker med brugernavn og adgangskode, som I har valgt under oprettelse af jeres testorganisation. I skal logge ind via fanen "Test login", når I har fulgt et af følgende links. 

  MitID Erhverv i DevTest4-miljøet - produktionsben:

  https://erhvervsadministration.devtest4-nemlog-in.dk/

  MitID Erhverv i DevTest4-miljøet - integrationstestben:

  https://erhvervsadministration.test-devtest4-nemlog-in.dk/ 

  Følg denne vejledning fra trin 2, når I har logget ind på det ben, I anvender, i MitID Erhverv DevTest4-miljøet:

  MitID-Erhverv.dk: Administrér organisations- og systemcertifikater: Bestil et organisations- eller systemcertifikat

  Følgende video viser, hvordan I kan bestille og udstede certifikater:

  Episode 4: Udstedelse af OCES3 certifikater

• Eksempel på et systemcertifikat

  Du kan nedenfor finde et eksempel på et systemcertifikat, der dog ikke vil være tilknyttet din egen testorganisations CVR-nummer:

  OCES3 systemcertifikat (.p12)

  Adgangskode: c5,PnmF8;m4I

• Hvis I oplever vanskeligheder med at læse nøglefilerne

  Nøglefilerne, som genereres via MitID Erhverv, er i PKCS#12 format og krypteret med AES-algoritmen. Det kan give ældre software problemer med at læse dem. I givet fald kan man ompakke filerne til en anden krypteringsalgoritme ved brug af værktøjer såsom:

  • XCA
  • OpenSSL
  • andre værktøjer, som svarer til de 2 værktøjer ovenfor.
• Rodcertifikatet og udstedende certifikat til test

  Rodcertifikatet og udstedende certifikat til test kan hentes fra testcertifikatets .12-fil ved hjælp af relevant software til formålet.

• Spærrelister, OCSP services

  Spærrelister og OCSP services i OCES3 infrastrukturen udstilles ikke fra faste IP-adresser grundet DDOS-beskyttelsen af disse services. Det betyder, at eventuelle firewall-regler for udgående trafik i jeres organisation skal defineres på host-navnet og ikke på IP-adresser.

IdM- og certifikat API

Organisationer, der ønsker at håndtere deres brugere i egne lokale systemer, kan foretage integration med IdM API’et i MitID Erhverv. Så kan I oprette brugere i egne lokale systemer, og de bliver også oprettet i MitID Erhverv. Bemærk, at en lokal bruger først kan logge ind på selvbetjeninger via Lokal IdP, når brugeren er oprettet i MitID Erhverv efter synkroniseringen mellem det lokale system og MitID Erhverv.

• Kontakt MitID Erhverv Forvaltningen forhud for test

  Hvis I ønsker at teste IdM-integration, skal I kontakte MitID Erhverv Forvaltningen for at få adgang. Når I skriver til MitID Erhverv Forvaltningen, skal I huske at oplyse:

  • testorganisationens CVR-nummer
  • at der er tale om integrationstestmiljøet
  • at I skal teste IdM-integration.

  MitID Erhverv Forvaltningen kan med de oplysninger åbne for funktionerne for jeres testorganisation.

  MitID Erhverv Forvaltningen: E-mail

• Dokumentationspakken til integration med IdM API’et i MitID Erhverv

  Hent dokumentationspakken:

  Dokumentationspakke (V1.12) for IdM og Certifikat API (.zip)

  Dokumentationspakken til integration med IdM API’et i MitID Erhverv er opdateret i forhold til de nye krav om e-mailvalidering. Hvis I udsteder certifikater med e-mailadresse, skal I validere e-mailadressen, som I har angivet.

  Pakken består af:

  • introduktion og beskrivelser af koncepter
  • beskrivelser af flows, fx autentifikation
  • datamodeller
  • REST OpenAPI specifikationer (.yaml)
  • SOAP WSDL.

  Pakken indeholder også separat dokumentation til Certifikat API. Certifikat APIet gør det muligt at udstede og forny certifikater.

   

• Synkroniseringen mellem det lokale system og MitID Erhverv

  I skal være opmærksomme på, at brugere som udgangspunkt ikke har tilknyttet certifikater i NemLog-in, da certifikater ikke bruges til login.

  I bedes synkronisere større antal brugere (tusinder) via API'et om natten eller som minimum udstrække synkroniseringen over en længere periode (fx 60-120 min). Derudover bør I ikke foretage autentifikation for hver eneste bruger, der opdateres, men i stedet opdatere mange brugere med samme login.

• Hvis du får en fejl, der hedder http 429 (Too Many Requests)

  Der er en begrænsning på brugen af API'et baseret på antal kald inden for en given tidsperiode. Dette er indført for at undgå urimelig belastning af systemet og sikre driftsstabiliteten. Det betyder, at brug af API'et, der overskrider denne grænse, vil resultere i returkoden http 429 (Too Many Requests).

  Hvis man fx synkroniserer et større antal brugere (tusinder) over en kort periode, kan man få denne fejlkode. Hvis det sker, anbefaler vi, at I straks stopper synkroniseringen og evt. genoptager den senere med indlagt forsinkelse mellem kaldene.

Integration af Lokal IdP

• Kontakt MitID Erhverv Forvaltningen forud for test

  Hvis I ønsker at teste Lokal IdP, skal I kontakte MitID Erhverv Forvaltningen for at få adgang. Når I skriver til MitID Erhverv Forvaltningen, skal I huske at oplyse:

  • testorganisationens CVR-nummer
  • at der er tale om integrationstestmiljøet
  • at I skal teste Lokal IdP.

  MitID Erhverv Forvaltningen kan så åbne for funktionerne for jeres testorganisation.

  MitID Erhverv Forvaltningen: E-mail

• Vejledninger, specifikationer og metadata

  Når I vil integrere en Lokal IdP og vil være ansvarlig for autentifikation af jeres lokale brugere, skal OIOSAML Local IdP Profile overholdes til integrationen med NemLog-ins broker.

  Vejledning:

  Integration med NemLog-in – Local IdP (pdf) (på engelsk) (senest opdateret den 14. december 2023)

  Metadata:

  I kan hente metadata for Lokal IdP integration:

  Metadata

  Husk at:

  • sætte levetid i Assertion for lokal IdP til maksimalt 10 minutter for at undgå, at den afvises af NemLog-in
  • anvende Log viewer på miljøet, hvis du har brug for at debugge et afvist request.

  Logviewer:

  NemLog-in DevTest4-miljøet: Log viewer

Komponenter i DevTest4-miljøet

• Miljøoversigt

  I denne guide finder du links og en tegning, som illustrerer DevTest4-miljøet:

  DevTest4 (pre-produktionsmiljø) miljøoversigt (pdf)