ESigningService.Client 1.2.0

ESigningService.Client

A self-contained .NET client SDK for the Emudra (emSigner) e-signing microservice. Drop it into any .NET 8+ service (ASP.NET Core, Worker Service, console) to call the signing APIs without re-implementing the HTTP contract.

What's in the box

• IEmudraSigningFacade / EmudraSigningFacade — strongly-typed HTTP facade
• AddEmudraSigningClient(...) — DI registration over IHttpClientFactory
• EmudraClientOptions — typed configuration
• EmudraClientException — surfaces gateway status code and response body
• Request/result models (InitiateSigningRequest, SigningInitResult, SignedDocumentResult, TransactionStatusResult, CertificateDataResult)

Install

dotnet add package ESigningService.Client

Register

From configuration (binds the EmudraClient section):

builder.Services.AddEmudraSigningClient(
    builder.Configuration.GetSection(EmudraClientOptions.SectionName));

Or inline:

builder.Services.AddEmudraSigningClient(o =>
{
    o.BaseUrl = "https://gateway.example/esigning";
    o.TimeoutSeconds = 100;
});

appsettings.json:

{
  "EmudraClient": {
    "BaseUrl": "https://gateway.example/esigning",
    "BearerToken": null,
    "TimeoutSeconds": 100
  }
}

Use

public sealed class MySigningWorkflow(IEmudraSigningFacade signing)
{
    public async Task<string> SignAsync(string pdfBase64, string reference, CancellationToken ct)
    {
        var init = await signing.InitiateSigningAsync(new InitiateSigningRequest
        {
            FileBase64         = pdfBase64,
            ReferenceNumber    = reference,
            SignerName         = "TreasuryOfficer",
            SuccessCallbackUrl = "https://app/callback/success",
            FailureCallbackUrl = "https://app/callback/failure",
            CancelCallbackUrl  = "https://app/callback/cancel",
        }, ct);

        // Redirect the user to init.SigningUrl, then after the callback:
        var signed = await signing.GetSignedDocumentAsync(
            init.TransactionNumber, init.ReferenceNumber, ct);

        return signed.IsSuccess
            ? signed.SignedPdfBase64!
            : throw new InvalidOperationException(signed.ErrorMessage);
    }
}

EmudraClientException carries StatusCode and ResponseBody for diagnostics.

Compatibility

Multi-targets net7.0 and net8.0, so it is consumable from net7, net8, net9 and net10 projects (including the net7 TreasuryServer monolith and the net10 microservice). The only package dependencies are Microsoft.Extensions.Http and Microsoft.Extensions.Options.ConfigurationExtensions.

GetSigningResultAsync(transactionNumber, referenceNumber) calls the high-level api/v1/sign/result endpoint and returns the signed PDF; it throws EmudraClientException (carrying the HTTP status code) on a non-success response so callers can distinguish a definitive rejection (4xx) from a transient gateway failure (5xx).