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

Skal I oprette en it-systemudbyder eller brugerorganisation med et selvvalgt navn og CVR-nummer, skal I bruge Swagger API'et. I kan selv vælge:

• navn på organisationen
• CVR-nummer på organisationen.

Bemærk, at I ikke kan:

• bruge allerede eksisterende CVR-numre
• ændre navnet på organisationen, når først I har oprettet testorganisationen.

Den oprettede it-systemudbyder kan bruges til test i:

• NemLog-in Administration i DevTest4-miljøet (pre-produktionsmiljøet)
• MitID Erhverv i både integrationstestbenet og produktionsbenet i DevTest4-miljøet (pre-produktionsmiljøet).

At oprette en it-systemudbyder eller brugerorganisation med et selvvalgt navn og CVR-nummer, er en avanceret metode til at oprette en it-systemudbyder til test. NemLog-in anbefaler derfor, at I opretter en brugerorganisation eller it-systemudbyder med et fiktivt CVR-nummer, hvis ingen særlige forhold ikke taler imod det. Læs vejledningen til det her:

Fiktivt CVR-nummer: Sådan opretter I en it-systemudbyder til test

Trin for trin-vejledning: Opret en it-udbyder til test

• 1. Gå til EIA TestPortal Services (Swagger UI)

  EIA TestPortal Services

  Linket fører jer direkte til afsnittet "/api/organization/tuextended", hvor I kan oprette en it-systemudbyder til test. Forklaringen om API'et bliver automatisk foldet ud.

  Hvis det ikke sker, skal I blot finde og trykke på:

  • /api/organization/tuextended

  Her kan I vælge at indtaste en "X-API-KEY". I finder indtastningsfeltet under menuen "Parameters".

  

• 2. Vælg "Try it out"

  I trykker på knappen "Try it out", som ligger i linjen efter API'ets navn.

  

  Feltet "Request body" bliver nu redigerbart. 

  

• 3. Ret oplysninger under "Request body"

  I skal indtaste følgende 8 oplysninger. Oplysningerne indtastes mellem det andet sæt anførselstegn ("") i indtastningseksemplet.

  Oplysninger	Indtastningseksempel:	Forklaring
  	"organizationType": "Public"	Angiv "Public" for offentlig organisation, "Private" for privat organisation*. En offentlig eller privat organisation afgør, hvad I kan anvende i NemLog-in. Læs mere efter denne tabel.
  Navn på organisationen:	"name": "Min testorganisation 1234"	Det navn, som I ønsker at give til jeres organisation til test. Navnet kan ikke ændres efterfølgende.
  CVR-nummer på organisationen:	"cvrNumber": "81559418"	Et 8-cifret nummer. CVR-nummeret skal være fiktivt eller jeres egnet CVR-nummer. I må ikke bruge andres CVR-nummer.
  Om organisationen må generere kvalificerede signaturer:	"enableQualifiedCertificates": true	Om organisationen skal kunne signere kvalificeret under testen.
  NSIS- sikringsniveau:	"physicalPersonIAL": "Substantial"	I kan angive NSIS (National Standard for Identiteters Sikringsniveauer) for identifikationsproces af MitID Erhverv-brugere. Hvis sikringsniveauet er sat til betydelig (substantial) eller høj (high), er det muligt, at organisationsadministrator kan give identitetsadministratorer lov til at oprette brugere direkte på det højere niveau.
  E-mailadresse:	"adminEmail": "admin@example.com"	E-mailadresse på administrator for organisationen. E-mailadressen kan bruges til at fremsøge oplysninger om den oprettede private MitID-bruger til test på følgende side: MitID Simulator i DevTest4 (pre produktionsmiljøet)
  Adgangskode:	"password": "myTestPw"	Denne adgangskode bruges til at fremsøge oplysninger om jeres private MitID-bruger til test, som er oprettet i MitID Simulatoren. Du kan finde brugernavn på testbrugeren under feltet "username" i svaret fra Swagger interface. MitID Simulator i DevTest4 (pre produktionsmiljøet)
  Administrators CPR-nummer:	"adminCpr": "1211571009"	Brug et fiktivt CPR-nummer, som endnu ikke er brugt i MitID simulatoren for at oprette en ny MitID bruger til test. Hvis I indtaster et eksisterende CPR-nummer i MitID Simulatoren, genbruges brugeren med det CPR-nummer, og brugeren oprettes i MitID Erhverv.

  * Om I er en offentlig eller privat organisation afgør, hvad I kan bruge og gøre i NemLog-in. Hvis I er en privat organisation, kan I:

  • bruge login på it-systemer med MitID, MitID Erhverv eller Lokal IdP
  • få mulighed for at underskrive et dokument eller en aftale med MitID eller MitID Erhverv
  • bruge login på jeres webservices med MitID, MitID Erhverv eller Lokal IdP via Security Token Service (STS).

  Hvis I er en offentlig organisation, kan I tilbyde det samme som en privat organisation, men I kan også:

  • tilbyde login med Single Sign-On (SSO) med MitID, MitID Erhverv eller Lokal IdP, så brugerne kan være logget ind på tværs af selvbetjeninger og myndigheder
  • hente oplysninger fra CPR
  • tilbyde brug af fuldmagter fra Digital Fuldmagt-selvbetjeningen, som er den offentlige digitale fuldmagtløsning.
• 4. Vælg "Excute"

  Når I har rettet oplysningerne i JSON-strukturen beskrevet i trin 3, skal I trykke på knappen "Execute", som ligger under overskriften "Request body".

  

  Menuen "Responses" bliver synlig under indtastningsfeltet for indholdet fra JSON-filen, hvor I finder svaret fra Swagger under overskriften "Curl".

  

• 5. Tjek statuskode

  I kan finde statuskoden under "Server reponse", som ligger efter svaret fra Swagger under "Curl". Hvis oprettelsen er succesfuld, er statuskoden 200.

• 6. Jeres it-systemudbyder til test er klar

  Hvis I gerne vil finde login-oplysningerne igen, skal I lede efter svaret fra Swagger. I finder oplysningerne under menuen "Responses", der ligger under menuen "Curl", som vist i trin 4.

  Når I logger ind i NemLog-in Administration og MitID Erhverv i DevTest4-miljøet (pre-produktionsmiljøet), skal I bruge:

  • et bruger-ID, som ligger ved "username" i svaret fra Swagger
  • en adgangskode, som ligger ved "password" i svaret fra Swagger.

  Hvis I har oprettet en it-systemudbyder:

  NemLog-in Administration i DevTest4 (pre-produktionsmiljøet)

  Når I har oprettet en brugerorganisation:

  MitID Erhverv - integrationstestben i DevTest4 (pre-produktionsmiljøet)

  MitID Erhverv - produktionsben i DevTest4 (pre-produktionsmiljøet)

Trin for trin-vejledning: Tilføj administrator

Hvis I ikke længere kan huske bruger-ID til administratoren i jeres it-systemudbyder til test, kan I tilføje en ny administrator.

I skal dog have det password, som er vist i trin 7 under oprettelsen.

• 1. Gå til EIA TestPortal Services

  EIA TestPortal Services

  Linket fører jer direkte til afsnittet "/api/organization/tuextended", hvor I kan oprette en it-systemudbyder til test. Forklaringen om API'et bliver automatisk foldet ud.

  Hvis det ikke sker, find og tryk da på:

  • /api/organization/tuextended

  Herunder kan I vælge at indtaste en X-API-KEY. I finder indtastningsfeltet under menuen ”Parameters”.

  

• 2. Vælg "Try it out"

  I trykker på knappen "Try it out", som ligger i linjen efter API-navnet.

  

  Feltet "Request body" bliver nu redigerbart. 

  

• 3. Ret oplysninger under "Request body"

  I skal kun indtaste følgende oplysninger:

  • "cvrNumber", hvor I indtaster CVR-nummer for den it-systemudbyder til test, som I har oprettet
  • "adminE-mail", hvor I indtaster e-mailadresse for den nye administrator
  • "password", hvor I indtaster jeres adgangskode, som I fik i trin 7 ved oprettelsen
  • "adminCPR", hvor I indtaster et fiktivt CPR-nummer.

  Andre oplysninger skal slettes.

  Eksempel på indtastning:

  {

  "cvrNumber": "88554418",

  "adminEmail": "admin@example.com",

  "password": "myTestPw",

  "adminCpr": "1211330010"

  }

  

  Oplysningerne indtastes mellem det andet sæt anførselstegn ("").

• 4. Vælg "Excute"

  Når I har rettet oplysningerne i JSON-strukturen beskrevet i trin 3, skal I trykke på knappen "Execute", som ligger under overskriften ”Request body”.

  

  Menuen "Responses" bliver synlig under indtastningsfeltet for indholdet fra JSON-filen, hvor I finder svaret fra Swagger under overskriften ”Curl”.

  

• 5. Tjek statuskode

  I kan finde statuskoden under "Server reponse", som ligger efter svaret fra Swagger under "Curl". Hvis oprettelsen er succesfuld, er statuskoden 200.