حفاظت از اطلاعات حساس در حین انتقال برای ارتباطات تجاری مدرن ضروری است و S/MIME روشی ثابت‌شده برای ایمن‌سازی محتوای ایمیل فراهم می‌کند. Aspose.Email Cloud SDK for .NET به توسعه‌دهندگان امکان می‌دهد پیام‌های ایمیل S/MIME را در .NET با حداقل کد رمزنگاری و رمزگشایی کنند. در این راهنما، یک مثال کامل به زبان C#، فراخوانی‌های معادل cURL و نکات عملی برای اطمینان از محرمانه ماندن پیام‌های شما را مشاهده خواهید کرد.

مثال کامل کد: رمزنگاری و رمزگشایی پیام‌های ایمیل S/MIME در .NET

این مثال نشان می‌دهد که چگونه یک ایمیل S/MIME را با استفاده از کتابخانه Aspose.Email Cloud رمزگذاری و رمزگشایی کنید.

using System;
using System.Collections.Generic;
using System.IO;
using System.Text;
using Aspose.Email.Cloud.Sdk.Api;
using Aspose.Email.Cloud.Sdk.Client;
using Aspose.Email.Cloud.Sdk.Model;
using Aspose.Email.Cloud.Sdk.Model.Requests;

namespace SmimeEncryptionDemo
{
    class Program
    {
        // Replace with your actual Aspose Cloud credentials
        private const string ClientId = "YOUR_CLIENT_ID";
        private const string ClientSecret = "YOUR_CLIENT_SECRET";

// File names used in Aspose Cloud storage
        private const string PublicCertFile = "public.cer";
        private const string PrivateKeyFile = "private.pfx";
        private const string PrivateKeyPassword = "pfxPassword";

// Local temporary files
        private const string EncryptedEmailPath = "encrypted_message.eml";
        private const string DecryptedEmailPath = "decrypted_message.eml";

static void Main()
        {
            // Configure Aspose Email Cloud SDK
            var config = new Configuration
            {
                ClientId = ClientId,
                ClientSecret = ClientSecret,
                BaseUrl = "https://api.aspose.cloud"
            };

var emailApi = new EmailApi(config);
            var storageApi = new StorageApi(config);

try
            {
                // -------------------------------------------------
                // Upload certificate and private key to cloud storage
                // -------------------------------------------------
                UploadFileToStorage(storageApi, PublicCertFile, "certs/" + PublicCertFile);
                UploadFileToStorage(storageApi, PrivateKeyFile, "certs/" + PrivateKeyFile);

// -------------------------------------------------
                // Build a simple email message
                // -------------------------------------------------
                var email = new EmailDto
                {
                    From = new MailAddress { Address = "sender@example.com" },
                    To = new List<MailAddress>
                    {
                        new MailAddress { Address = "recipient@example.com" }
                    },
                    Subject = "S/MIME Encryption Demo",
                    Body = new TextBody { Text = "Hello, this is a secure S/MIME message." }
                };

// -------------------------------------------------
                // Encrypt the email using the public certificate
                // -------------------------------------------------
                var encryptRequest = new EncryptRequest(email, "certs/" + PublicCertFile);
                var encryptedEmail = emailApi.Encrypt(encryptRequest);

// Save encrypted message locally for inspection
                File.WriteAllBytes(EncryptedEmailPath, Encoding.UTF8.GetBytes(encryptedEmail.Raw));
                Console.WriteLine($"Encrypted email saved to '{EncryptedEmailPath}'.");

// -------------------------------------------------
                // Decrypt the previously encrypted email using the private key
                // -------------------------------------------------
                var decryptRequest = new DecryptRequest(encryptedEmail, "certs/" + PrivateKeyFile, PrivateKeyPassword);
                var decryptedEmail = emailApi.Decrypt(decryptRequest);

// Save decrypted message locally
                File.WriteAllBytes(DecryptedEmailPath, Encoding.UTF8.GetBytes(decryptedEmail.Raw));
                Console.WriteLine($"Decrypted email saved to '{DecryptedEmailPath}'.");

// -------------------------------------------------
                // Verify that decryption succeeded
                // -------------------------------------------------
                Console.WriteLine("Decrypted Email Subject: " + decryptedEmail.Subject);
                Console.WriteLine("Decrypted Email Body: " + ((TextBody)decryptedEmail.Body).Text);
            }
            catch (ApiException apiEx)
            {
                // Common API errors (authentication, missing files, invalid certificates, etc.)
                Console.WriteLine($"API Error: {apiEx.ErrorCode} - {apiEx.Message}");
            }
            catch (Exception ex)
            {
                // General errors (IO, serialization, etc.)
                Console.WriteLine($"Unexpected error: {ex.Message}");
            }
        }

private static void UploadFileToStorage(StorageApi storageApi, string localPath, string remotePath)
        {
            if (!File.Exists(localPath))
                throw new FileNotFoundException($"File '{localPath}' not found.");

var fileBytes = File.ReadAllBytes(localPath);
            var uploadRequest = new UploadFileRequest
            {
                Path = remotePath,
                File = fileBytes
            };
            storageApi.UploadFile(uploadRequest);
        }
    }
}

توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، اطمینان حاصل کنید که مسیرهای فایل و مقادیر پیکربندی را به‌گونه‌ای به‌روزرسانی کنید که با محیط واقعی شما مطابقت داشته باشد، بررسی کنید که تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک به تیم پشتیبانی مراجعه نمایید.

رمزنگاری و رمزگشایی ایمیل S/MIME از طریق REST API با استفاده از cURL

در زیر تماس‌های REST آمده‌اند که همان عملیات کد C# بالا را انجام می‌دهند. مقادیر جایگزین را با اعتبارنامه‌ها و نام‌های فایل واقعی خود جایگزین کنید.

# 1. Get an access token
curl -X POST "https://api.aspose.cloud/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
# 2. Upload the public certificate
curl -X PUT "https://api.aspose.cloud/v4.0/email/storage/file/certs/public.cer" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "public.cer"

3. بارگذاری کلید خصوصی

# 3. Upload the private key
curl -X PUT "https://api.aspose.cloud/v4.0/email/storage/file/certs/private.pfx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "private.pfx"
# 4. Create the email JSON payload (save as email.json)
cat > email.json <<EOF
{
  "from": { "address": "sender@example.com" },
  "to": [ { "address": "recipient@example.com" } ],
  "subject": "S/MIME Encryption Demo",
  "body": { "text": "Hello, this is a secure S/MIME message." }
}
EOF
# 5. Encrypt the email
curl -X POST "https://api.aspose.cloud/v4.0/email/encrypt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d @email.json \
     -F "certificate=certs/public.cer"
# 6. Decrypt the email
curl -X POST "https://api.aspose.cloud/v4.0/email/decrypt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d @encrypted_email.json \
     -F "certificate=certs/private.pfx" \
     -F "password=pfxPassword"

برای مرجع کامل تمام نقطهٔ انتهایی، مستندات رسمی API را ببینید.

درک رمزگذاری و رمزگشایی پیام‌های ایمیل S/MIME در کد .NET

  1. پیکربندی - شیء Configuration شامل ClientId، ClientSecret و URL پایه شما است. این برای هر فراخوانی API ضروری است.

    var config = new Configuration { ClientId = ClientId, ClientSecret = ClientSecret, BaseUrl = "https://api.aspose.cloud" };
    
  2. بارگذاری فایل‌ها - UploadFileToStorage یک فایل محلی را می‌خواند و با استفاده از StorageApi.UploadFile آن را به ذخیره‌سازی Aspose Cloud ارسال می‌کند.

    var fileBytes = File.ReadAllBytes(localPath);
    storageApi.UploadFile(new UploadFileRequest { Path = remotePath, File = fileBytes });
    
  3. ساخت ایمیل - یک شیء EmailDto با فرستنده، گیرنده، موضوع و متن ساده پر می‌شود.

    var email = new EmailDto { From = new MailAddress { Address = "sender@example.com" }, ... };
    
  4. رمزنگاری - EncryptRequest شیء ایمیل و مسیر گواهی عمومی را می‌گیرد. EmailApi.Encrypt یک EmailDto حاوی محتوای MIME رمزنگاری‌شده برمی‌گرداند.

    var encryptRequest = new EncryptRequest(email, "certs/public.cer");
    var encryptedEmail = emailApi.Encrypt(encryptRequest);
    
  5. رمزگشایی - DecryptRequest ایمیل رمزنگاری‌شده، مسیر کلید خصوصی و رمز عبور آن را فراهم می‌کند. EmailApi.Decrypt پیام اصلی را تولید می‌کند.

    var decryptRequest = new DecryptRequest(encryptedEmail, "certs/private.pfx", PrivateKeyPassword);
    var decryptedEmail = emailApi.Decrypt(decryptRequest);
    

این مراحل مستقیماً به تماس‌های REST نشان داده شده در بالا مرتبط هستند و به شما انعطاف‌پذیری می‌دهند تا بین C# و HTTP خام انتخاب کنید.

پیش‌نیازها و تنظیمات برای پردازش ایمیل S/MIME

  1. نصب Aspose.Email Cloud SDK برای .NET:
dotnet add package Aspose.Email-Cloud
  1. اطمینان حاصل کنید که یک حساب کاربری معتبر Aspose Cloud دارید و ClientId و ClientSecret را دریافت کنید.
  2. باینری‌های SDK را از صفحه رسمی انتشار دانلود کنید: Aspose.Email Cloud SDK for .NET Download.
  3. گواهی عمومی (*.cer) و کلید خصوصی (*.pfx) خود را در یک پوشه محلی قرار دهید تا آماده بارگذاری باشد.

گزینه‌های پیکربندی برای عملیات S/MIME

  • Base URL - می‌توانید BaseUrl را در شیء Configuration تغییر دهید اگر نیاز به هدف‌گیری منطقه‌ای متفاوت دارید.
    var config = new Configuration { BaseUrl = "https://api.aspose.cloud" };
    
  • Timeout Settings - زمان‌سنجی کلاینت HTTP را برای پیام‌های بزرگ تنظیم کنید.
    config.Timeout = 300000; // 5 minutes
    
  • Logging - برای اهداف اشکال‌زدایی، ثبت درخواست/پاسخ را از طریق لاگر داخلی SDK فعال کنید (برای جزئیات به مرجع API مراجعه کنید).

برای دریافت فهرست کامل پارامترها، به مرجع API مراجعه کنید.

بهترین شیوه‌ها برای مدیریت امن ایمیل S/MIME

  • گواهی‌ها و کلیدهای خصوصی را در ذخیره‌سازی Aspose Cloud با استفاده از مسیرهای امن ذخیره کنید و دسترسی‌ها را محدود کنید.
  • زنجیره‌های گواهی را قبل از رمزنگاری اعتبارسنجی کنید تا از خطاهای زمان اجرا جلوگیری شود.
  • رمز عبور کلید خصوصی را خارج از کد منبع نگه دارید؛ از متغیرهای محیطی یا یک مدیر راز استفاده کنید.
  • پس از رمزگشایی، یکپارچگی پیام را با بررسی موضوع و متن نسبت به مقادیر مورد انتظار تأیید کنید.
  • فقط اطلاعات غیرحساس را ثبت کنید؛ هرگز کلیدهای خصوصی خام را به خروجی کنسول ننویسید.

جمع‌بندی

رمزنگاری و رمزگشایی پیام‌های ایمیل S/MIME در .NET به‌صورت ساده‌ای با Aspose.Email Cloud SDK for .NET انجام می‌شود. این کتابخانه مدیریت گواهی‌نامه‌ها، قالب‌بندی MIME و عملیات‌های رمزنگاری را به‌صورت خودکار انجام می‌دهد و به شما امکان می‌دهد بر منطق کسب‌وکار تمرکز کنید. به یاد داشته باشید که اعتبارنامه‌های خود را ایمن کنید، از رمزهای قوی برای کلیدهای خصوصی استفاده کنید و جریان کار را با گواهی‌نامه‌های واقعی قبل از استقرار در محیط تولید تست کنید. برای استفاده تجاری به یک لایسنس پولی نیاز دارید؛ می‌توانید قیمت‌گذاری را در صفحه محصول بررسی کنید و برای ارزیابی یک لایسنس موقت دریافت کنید در صفحه لایسنس موقت.

سوالات متداول

  • چگونه Aspose.Email Cloud SDK for .NET پیام‌های ایمیل S/MIME را در .NET رمزنگاری و رمزگشایی می‌کند؟
    SDK متدهای Encrypt و Decrypt را فراهم می‌کند که یک EmailDto و مسیرهای گواهی‌نامه را می‌پذیرند. این متدها عملیات بسته‌بندی/بازکردن S/MIME را در سمت سرور انجام می‌دهند و محتوای MIME پردازش‌شده را برمی‌گردانند.

  • آیا برای تست پیام‌های رمزگذاری‌شده نیاز به اجرای یک سرور ایمیل دارم؟
    نه. SDK به‌صورت مستقل از هر سرور ایمیلی کار می‌کند. می‌توانید پیام را رمزگذاری کنید، فایل .eml را ذخیره کنید و بعداً به‌صورت محلی یا از طریق API آن را رمزگشایی کنید.

  • آیا می‌توانم از همان کد با زبان‌های دیگر استفاده کنم؟
    بله. API پایه REST مستقل از زبان است. می‌توانید همان نقطه‌های انتهایی را از جاوا، پایتون، PHP یا هر پلتفرمی که می‌تواند درخواست‌های HTTP ارسال کند، فراخوانی کنید.

  • کجا می‌توانم مثال‌های بیشتر و مشخصات دقیق API را پیدا کنم؟
    راهنماهای دقیق و مطالب مرجع در مستندات Aspose.Email Cloud و مرجع API موجود هستند.

بیشتر بخوانید