Preconditions
- Visual Studio 2019
- .Net Framework 4.0
- Java Runtime (JRE) 8
- Company / developer have access to the test environment
- Access through company's firewall (Can be verified by running the test tool in the OOAPI project)
- Access through Nets DanID firewall (Can be verified by running the test tool in the OOAPI project)
- Company / developer have a test VOCES certificate and issued to a .pkcs12 file.
Walkthrough
1. Download the latest .net source and unzip it. This is found in Code (Kildekode).
2. Open the project in Visual Studio (ooapi.net.sln)
3. Set the path for the company test certificate (bundled with this application)
This certificate is used to sign NemID client parameters and to call the PID/CPR webservice. It is located in the \tuexample.net\certificates folder.
When you get the test company certificate (test VOCES) it will most likely be a pkcs12 file. To replace the DanID test certificate just rename the certificate file extension to
.pfx.
Browse and look in web.config for <add key="pfxFile" and change the physical path to correspond to where the DanID Test certificate is located on your installation.
Browse and look in app.config(ooapi) for <add key="pfxFile" and change the physical path to correspond to where the DanID Test certificate is located on your installation.
To run unittests for ooapi also set <add key="pfxFile" in app.config in the test.ooapi project.
4. Verify access to the DanID test environment (remember to register for access before running the tests)
Run the OOAPI.net subproject from Visual Studio to verify system access.
Choose
9 to connect to the Preprod test environment.
Follow the instructions in the DOS shell, and verify that all tests are compeleted succesfully.
5. Run TU-example project
Run the TU-example project and verify that it works.
The webpage should be displayed in your preferred browser as below.
If any errors occur, check for help in the FAQ for developers (in Danish).
6. Create test identity in Developers
To test your implementation, you need test users that correspond to different user scenarios. You find guidelines for test in Documentation.
https://appletk.danid.dk/developers/
7. Test TU-example
Click
Prøv demo on the TU-variant 01 tab.
Click Login ind med nøglekort.
After a successful login, the following page should be displayed.
8. Test access to PID/CPR service
Test call to PID/CPR service at this URL:
http://localhost:[valid port number]/extras/checkPID.aspx.
Get the port number from your local installation.
Type in valid PID data from newly created test identity, and verify by clicking
Check PID.
This should produce the following page.
Now check invalid PID/CPR data by inserting invalid data and click Check PID.
This should produce the following page.
19. Change DanID certificate to your own test VOCES certificate
Change the following in the
APP.config file of the TU example.
Set password for the new test certificate.
Refer to the new certificate on the file system. Note that this certificate file should be in the .pfx file format. If the file extension is .pkcs12 simply rename it to .pfx.
Change the following in the
WEB.config file of the TU example.
Set password for the test certificate.
Refer to the new certificate on the file system. Note that this certificate file should be in the .pfx file format. If the file extension is .pkcs12 simply rename it to .pfx.
Change the SPID.
Remember to change logonto parameter from
DanID Test TU to your friendlyname. The friendly name was chosen by you upon requesting access to DanID's test environment.
10. Run/test TU-example projectRun/test the TU-example project again to verify that it works with your own certificate and friendlyname.