Integrasi Tandatangan Elektronik C# .NET

Mengintegrasikan Tandatangan Elektronik ke dalam Aplikasi C# .NET

Dalam persekitaran perniagaan digital hari ini, tandatangan elektronik telah menjadi elemen yang sangat diperlukan dalam aplikasi perisian untuk memperkemas aliran kerja, memastikan pematuhan, dan mengurangkan kerja kertas. Bagi pembangun yang menggunakan C# .NET, mengintegrasikan fungsi tandatangan elektronik boleh mengubah proses dokumen statik menjadi interaksi yang dinamik dan selamat. Integrasi ini membolehkan aplikasi .NET—sama ada aplikasi web yang dibina menggunakan ASP.NET Core, penyelesaian desktop menggunakan WPF, atau sistem perusahaan berasaskan .NET Framework—untuk membenamkan fungsi tandatangan secara langsung, membolehkan pengguna melihat, menandatangani dan menjejaki dokumen tanpa meninggalkan aplikasi. Dari sudut pandangan perniagaan, ini bukan sahaja meningkatkan kecekapan tetapi juga mematuhi peraturan global, seperti Akta ESIGN di Amerika Syarikat atau eIDAS di Kesatuan Eropah, yang memerlukan tandatangan digital yang selamat dan boleh disahkan untuk memastikan kesahan undang-undang.

Proses bermula dengan memilih penyedia tandatangan elektronik yang menawarkan API yang mantap yang serasi dengan .NET. Kebanyakan platform menyediakan SDK atau API RESTful yang boleh digunakan dengan mudah melalui HttpClient dalam C#, menjadikan integrasi mudah. Pertimbangan utama termasuk pengesahan API (biasanya OAuth 2.0), pengurusan sampul surat (untuk pembungkusan dokumen), dan sokongan webhook untuk kemas kini status masa nyata. Perniagaan yang menggunakan pendekatan ini dapat melihat pengurangan kos operasi—kajian menunjukkan penjimatan sehingga 80% dalam masa pemprosesan dokumen—sambil mengekalkan jejak audit untuk memastikan pematuhan.

Untuk melaksanakan integrasi, mulakan dengan mendaftarkan akaun pembangun dengan penyedia pilihan anda. Contohnya, menggunakan API DocuSign, anda boleh memasang pakej NuGet mereka (DocuSign.eSign) atau membuat panggilan HTTP langsung. Berikut ialah garis besar asas untuk mencipta dan menghantar sampul surat menggunakan C#:

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using Newtonsoft.Json;

public class DocuSignIntegration
{
    private readonly HttpClient _httpClient;
    private readonly string _baseUrl = "https://demo.docusign.net/restapi";
    private readonly string _accessToken; // Diperoleh melalui OAuth

    public DocuSignIntegration(string accessToken)
    {
        _httpClient = new HttpClient();
        _accessToken = accessToken;
        _httpClient.DefaultRequestHeaders.Add("Authorization", quot;Bearer {_accessToken}");
    }

    public async Task<string> CreateEnvelopeAsync(string documentPath, string signerEmail, string signerName)
    {
        // Sediakan definisi sampul surat
        var envelopeDefinition = new
        {
            status = "sent",
            emailSubject = "Sila tandatangani dokumen ini",
            documents = new[]
            {
                new
                {
                    documentBase64 = Convert.ToBase64String(await File.ReadAllBytesAsync(documentPath)),
                    name = "Dokumen Contoh",
                    fileExtension = Path.GetExtension(documentPath).TrimStart('.'),
                    documentId = "1"
                }
            },
            recipients = new
            {
                signers = new[]
                {
                    new
                    {
                        email = signerEmail,
                        name = signerName,
                        recipientId = "1",
                        tabs = new
                        {
                            signHereTabs = new[]
                            {
                                new { xPosition = "100", yPosition = "100", documentId = "1", pageNumber = "1" }
                            }
                        }
                    }
                }
            }
        };

        var json = JsonConvert.SerializeObject(envelopeDefinition);
        var content = new StringContent(json, Encoding.UTF8, "application/json");

        var response = await _httpClient.PostAsync(quot;{_baseUrl}/v2.1/accounts/{accountId}/envelopes", content);
        if (response.IsSuccessStatusCode)
        {
            var result = await response.Content.ReadAsStringAsync();
            dynamic data = JsonConvert.DeserializeObject(result);
            return data.envelopeId;
        }
        throw new Exception("Gagal mencipta sampul surat");
    }
}

Petikan kod ini menunjukkan penciptaan sampul surat yang mengandungi dokumen dan tab tandatangan. Dalam aplikasi .NET sebenar, anda perlu mengendalikan ralat, memuat naik fail dengan selamat, dan berintegrasi dengan elemen UI (seperti komponen Blazor) untuk pratonton tandatangan dalam aplikasi. Untuk senario yang lebih maju, seperti penghalaan bersyarat atau lampiran, muatan boleh dilanjutkan melalui medan khusus penyedia. Pengesahan melalui JWT atau kebenaran kod kebenaran memastikan pengurusan token yang selamat, biasanya menggunakan pustaka .NET seperti IdentityModel.

Selain fungsi asas, integrasi .NET boleh memanfaatkan webhook untuk meninjau atau menerima panggilan balik acara tandatangan. Menggunakan penghalaan titik akhir ASP.NET Core, sediakan pengawal untuk mengendalikan ini:

[ApiController]
[Route("api/[controller]")]
public class WebhookController : ControllerBase
{
    [HttpPost("esign-status")]
    public async Task<IActionResult> HandleStatusUpdate([FromBody] dynamic envelopeStatus)
    {
        // Proses status: completed, declined, etc.
        var envelopeId = envelopeStatus.envelopeId;
        var status = envelopeStatus.status;
        // Kemas kini pangkalan data atau maklumkan pengguna
        await Task.CompletedTask; // Placeholder untuk logik perniagaan
        return Ok();
    }
}

Persediaan ini membolehkan penyegerakan masa nyata, yang penting untuk aplikasi perusahaan yang mengendalikan kontrak volum tinggi. Dari sudut pandangan perniagaan, integrasi sedemikian mengurangkan pergantungan pada alat pihak ketiga, dengan itu mengurangkan kos—API tandatangan elektronik biasanya dicaj setiap sampul surat, jadi mengoptimumkan panggilan adalah penting. Pembangun juga harus mempertimbangkan kebolehskalaan: corak tak segerak .NET boleh mengendalikan permintaan serentak dengan cekap, tetapi had kadar API perlu dipantau (contohnya, 100 panggilan/minit untuk banyak penyedia).

Untuk pematuhan, pastikan integrasi menyokong piawaian seperti cincangan SHA-256 untuk mengesahkan integriti dokumen. Di kawasan yang mempunyai peraturan yang ketat, seperti di bawah eIDAS EU, tandatangan lanjutan (tandatangan elektronik yang berkelayakan) mungkin memerlukan token perkakasan atau pengesahan biometrik, yang boleh disepadukan melalui sambungan penyedia. Ujian dalam persekitaran kotak pasir adalah penting untuk mengelakkan isu pengeluaran.

Membandingkan platform tandatangan elektronik dengan DocuSign atau Adobe Sign?

eSignGlobal menawarkan penyelesaian tandatangan elektronik yang lebih fleksibel dan kos efektif dengan pematuhan global, harga yang telus dan proses penerimaan yang lebih pantas.

👉 Mulakan Percubaan Percuma

Penyedia Tandatangan Elektronik Popular untuk Integrasi .NET

Apabila memilih penyedia untuk integrasi C# .NET, faktor seperti kematangan API, harga dan pematuhan serantau memainkan peranan penting. Di bawah, kami menggariskan pemain utama, memfokuskan pada alat pembangun dan kesesuaian komersial mereka.

DocuSign

DocuSign ialah peneraju dalam pasaran tandatangan elektronik, menawarkan sokongan API yang komprehensif untuk pembangun .NET melalui API REST eSignature dan SDK rasmi mereka. Platformnya mengendalikan segala-galanya daripada tandatangan dokumen mudah kepada aliran kerja yang kompleks, termasuk logik bersyarat, penghantaran pukal dan pengumpulan pembayaran. Harga bermula dari $10/bulan untuk kegunaan peribadi, meningkat kepada $40/pengguna/bulan untuk Business Pro, dengan had sampul surat pengguna tahunan sekitar 100/tahun untuk pelan tahunan. Untuk perusahaan, pelan peningkatan tersuai termasuk SSO, log audit lanjutan dan keupayaan IAM untuk pengurusan berpusat. Kekuatan DocuSign terletak pada liputan globalnya dan integrasi dengan alat seperti Microsoft 365, menjadikannya sesuai untuk aplikasi .NET untuk pasukan jualan, HR atau undang-undang. Walau bagaimanapun, ciri tambahan seperti penghantaran SMS atau pengesahan ID menimbulkan caj bermeter tambahan, yang boleh bertambah untuk pengguna volum tinggi.

Adobe Sign

Adobe Sign, sebahagian daripada Adobe Document Cloud, menyediakan integrasi .NET yang lancar melalui API REST dan SDK mereka, menekankan keselamatan peringkat perusahaan dan keserasian Acrobat. Ia menyokong ciri seperti borang web, lampiran penandatangan dan automasi aliran kerja, dengan harga bermula dari $10/pengguna/bulan untuk kegunaan individu hingga peringkat perusahaan tersuai. Platform ini cemerlang dalam industri kreatif atau domain intensif dokumen, menawarkan pengisian borang dipacu AI dan mematuhi piawaian seperti ESIGN dan eIDAS. Untuk pembangun .NET, pengesahan menggunakan OAuth, dan penciptaan sampul surat menyerupai corak DocuSign tetapi dengan sambungan yang lebih ketat kepada ekosistem Adobe. Kelemahan termasuk potensi kos yang lebih tinggi untuk analitik lanjutan dan fleksibiliti yang lebih rendah di Asia Pasifik (APAC) disebabkan oleh cabaran kediaman data.

eSignGlobal

eSignGlobal meletakkan dirinya sebagai penyelesaian tandatangan elektronik serba boleh dengan sokongan API .NET yang mantap, memfokuskan pada pematuhan global yang meliputi 100+ negara dan wilayah arus perdana. Ia mempunyai kelebihan di Asia Pasifik (APAC), di mana peraturan tandatangan elektronik adalah berpecah-belah, berstandard tinggi dan dikawal ketat—berbeza dengan ESIGN/eIDAS yang lebih berorientasikan rangka kerja di Barat. APAC memerlukan piawaian "integrasi ekosistem", memerlukan integrasi perkakasan/API yang mendalam dengan identiti digital kerajaan (G2B), jauh melampaui pendekatan berasaskan e-mel atau pengisytiharan kendiri yang biasa di AS/EU. Pelan Essential eSignGlobal bermula pada hanya $16.6/bulan untuk menghantar sehingga 100 dokumen, tempat duduk pengguna tanpa had dan pengesahan kod akses, menawarkan nilai tinggi pada pematuhan. Ia berintegrasi dengan lancar dengan iAM Smart Hong Kong dan Singpass Singapura, bersaing dengan DocuSign dan Adobe Sign dari segi harga dan pengoptimuman serantau, dengan rancangan pengembangan global yang berterusan.

Mencari alternatif yang lebih bijak kepada DocuSign?

eSignGlobal menawarkan penyelesaian tandatangan elektronik yang lebih fleksibel dan kos efektif dengan pematuhan global, harga yang telus dan proses penerimaan yang lebih pantas.

👉 Mulakan Percubaan Percuma

HelloSign (Dropbox Sign)

HelloSign, kini sebahagian daripada Dropbox, menawarkan API mesra pengguna untuk integrasi .NET, menyokong ciri seperti templat, peringatan dan kerjasama pasukan. Harga bermula dari $15/bulan untuk Essentials, menyokong templat tanpa had tetapi dengan had sampul surat. Ia dipuji kerana kesederhanaannya untuk pasukan kecil tetapi mungkin kekurangan kedalaman ciri peringkat perusahaan dalam DocuSign atau Adobe Sign, terutamanya automasi yang kompleks.

Perbandingan Platform Tandatangan Elektronik

Untuk membantu dalam membuat keputusan, berikut ialah perbandingan neutral penyedia utama berdasarkan integrasi pembangun, harga dan ciri (anggaran 2025, USD, terpakai untuk pembayaran tahunan):

Jadual ini menyerlahkan pertukaran: DocuSign sesuai untuk penskalaan, Adobe untuk kedalaman integrasi, eSignGlobal untuk liputan global yang kos efektif dan HelloSign untuk kemudahan penggunaan.

Kesimpulan

Mengintegrasikan tandatangan elektronik ke dalam aplikasi C# .NET membuka kunci proses digital yang cekap dan mematuhi untuk perniagaan di seluruh dunia. Walaupun DocuSign kekal sebagai pilihan yang kukuh untuk ramai orang, alternatif seperti eSignGlobal menawarkan pilihan yang neutral dan mematuhi serantau, terutamanya untuk operasi APAC yang mencari keseimbangan antara harga dan integrasi ekosistem. Nilaikan berdasarkan keperluan khusus anda untuk mencari padanan terbaik.