ASP.NET MVC samples project

The ASP.NET MVC samples project shows how to use Rest PKI together with Web PKI on a project using ASP.NET MVC 5. It is hosted on GitHub at:

https://github.com/LacunaSoftware/PkiSuiteSamples/tree/master/dotnet/mvc

Running the project

Download the project or clone the repository
Open the project folder (dotnet\mvc)
Open the solution file (.sln) on Visual Studio
Generate an API access token on the REST PKI website
Paste your access token on the file web.config
Run the solution. Make sure your system allows automatic Nuget package restore (if it doesn't, manually restore the packages).

Project map

This section lists where to find the relevant parts in each feature sample on the project.

Authentication with digital certificate

Controller: AuthenticationRestController
Views:
- AuthenticationRest/Index.cshtml (JavaScript on signature-form.js)
- AuthenticationRest/Failed.cshtml
- AuthenticationRest/Success.cshtml

PAdES signature with file already on server

Controller: PadesSignatureRestController
Views:
- PadesSignatureRest/Index.cshtml (JavaScript on signature-form.js)
- PadesSignatureRest/SignatureInfo.cshtml

PAdES signature with file uploaded by user

After the file upload (which is crudely implemented merely for demonstration purposes on the controller UploadController and view Upload/Index.cshtml) is done the control flow is the same as in the sample PAdES signature with file already on server, but with the URL parameter userfile filled.

PAdES co-signature

After the control flow of the sample PAdES signature with file already on server is completed and the link Co-sign with another certificate is clicked, the same control flow is repeated, but now with the URL parameter userfile filled.

PAdES marks

This feature is demonstrated as an optional configuration on the PAdES signature with file already on server sample which by default starts commented out. To enable it, uncomment the following line on PadesSignatureController:

signatureStarter.PdfMarks.Add(PadesVisualElements.GetPdfMark(1));

Tip

Try changing the argument to the GetPdfMark(int) method to see different PDF mark configurations

The relevant code is on the class PadesVisualElements, method GetPdfMark(int).

CAdES signature with file uploaded by user

After the file upload (which is crudely implemented merely for demonstration purposes on the controller UploadController and view Upload/Index.cshtml) is done the control flow is the same as in the sample CAdES signature with file already on server, but with the URL parameter userfile filled.

CAdES co-signature

After the control flow of the sample CAdES signature with file already on server is completed and the link Co-sign with another certificate is clicked, the same control flow is repeated, but now with the URL parameter cmsfile filled.