Egov.Integrations.MSign.Soap 8.0.19

MSign SOAP Digital Signature

This package is intended for Service Provider integration built on ASP.NET Core 8.0+ with MSign using SOAP protocol for digital signature operations.

Getting Started

Please go through the following instructions to integrate your project with MSign.

Prerequisites

Before being able to integrate with MSign, a Service Provider, including its certificate, must be registered accordingly in MSign. MSign accepts certificates issued by STISC.

Installing

Install the following package from NuGet

Install-Package Egov.Integrations.MSign.Soap

Then follow the instructions from Configuration and Usage sections below.

Configuration

Add the following configuration section to your appsettings.json:

{
	...
	"Certificate": {
		"Path": "Files\\Certificates\\msign-sample.pfx",
		"Password": "yourpfxpassword"
	},
	"MSignSoap": {
		"ApiAddress": "https://msign.staging.egov.md:8443/MSign.svc",
		"FrontendAddress": "https://msign.staging.egov.md",
		"ServiceRootUrl": "https://localhost:44379"
	}
	...
}

where ServiceRootUrl is the base path of your published service.

Please note that your Service must be published using https protocol.

Usage

Add the following code snippet to your Startup.ConfigureServices method:

services.AddMSignSoapClient(builder.Configuration.GetSection("MSignSoap"));

In your controller, inject IMSignSoapClient and use it to create signature requests:

public class HomeController : ControllerBase
{
    private readonly IMSignSoapClient _msignClient;

    public HomeController(IMSignSoapClient msignClient)
    {
        _msignClient = msignClient;
    }

    public async Task<IActionResult> IndexAsync()
    {
        var requestID = await _msignClient.PostSignRequestAsync(new SignRequest
        {
            ShortContentDescription = "Sample HASH signature",
            ContentType = ContentType.Hash,
            Contents = new[]
            {
                new SignContent
                {
                    Content = SHA1.HashData(new byte[] { 0xDE, 0xAD, 0xBE, 0xEF })
                }
            }
        });

        // example Relay State
        var relayState = Guid.NewGuid().ToString();

        return Redirect(_msignClient.BuildRedirectAddress(requestID, Url.Action(nameof(MSignResponse))!, relayState));
    }

    public async Task<IActionResult> MSignResponse(string requestID, string relayState)
    {
        var response = await _msignClient.GetSignResponseAsync(requestID, null);

        if (response.Status == SignStatus.Success)
        {
            // Process successful signature
            return Ok();
        }

        // Handle signature failure
        return BadRequest(response.Message);
    }
}