يعد حماية المعلومات الحساسة أثناء النقل أمرًا أساسيًا لتواصل الأعمال الحديثة، ويوفر 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. 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. إنشاء حمولة JSON للبريد الإلكتروني (احفظها كـ 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"

للحصول على مرجع كامل لجميع نقاط النهاية، راجع الوثائق الرسمية لواجهة برمجة التطبيقات.

فهم تشفير وفك تشفير رسائل البريد الإلكتروني S/MIME في كود .NET

  1. إعداد التكوين - كائن Configuration يحتوي على ClientId و ClientSecret وعنوان URL الأساسي. هذا مطلوب لكل استدعاء API.

    var config = new Configuration { ClientId = ClientId, ClientSecret = ClientSecret, BaseUrl = "https://api.aspose.cloud" };
    
  2. رفع الملفات - UploadFileToStorage يقرأ ملفًا محليًا ويرسله إلى تخزين Aspose Cloud باستخدام StorageApi.UploadFile.

    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
    
  2. تأكد من أن لديك حساب Aspose Cloud صالح واحصل على ClientId و ClientSecret.
  3. قم بتنزيل ملفات SDK الثنائية من صفحة الإصدار الرسمية: Aspose.Email Cloud SDK for .NET Download.
  4. ضع شهادة العامة (*.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 والعمليات التشفيرية، مما يتيح لك التركيز على منطق الأعمال. تذكر تأمين بيانات الاعتماد الخاصة بك، واستخدام كلمات مرور قوية للمفاتيح الخاصة، واختبار سير العمل باستخدام شهادات حقيقية قبل النشر في بيئة الإنتاج. للاستخدام التجاري ستحتاج إلى ترخيص مدفوع؛ يمكنك مراجعة الأسعار على صفحة المنتج والحصول على ترخيص مؤقت للتقييم عبر temporary license page.

الأسئلة الشائعة

  • كيف يقوم Aspose.Email Cloud SDK for .NET بتشفير وفك تشفير رسائل البريد الإلكتروني S/MIME في .NET؟
    توفر SDK طرق Encrypt و Decrypt التي تقبل كائن EmailDto ومسارات الشهادات. تقوم بتنفيذ تغليف/فك تغليف S/MIME على جانب الخادم وتعيد محتوى MIME المعالج.

  • هل أحتاج إلى تشغيل خادم بريد لاختبار الرسائل المشفرة؟
    لا. يعمل SDK بشكل مستقل عن أي خادم بريد. يمكنك تشفير الملف، حفظ ملف .eml، ثم فك تشفيره لاحقًا محليًا أو عبر الـ API.

  • هل يمكنني استخدام نفس الكود مع لغات أخرى؟
    نعم. واجهة برمجة التطبيقات REST الأساسية لا تعتمد على لغة معينة. يمكنك استدعاء نفس نقاط النهاية من Java أو Python أو PHP أو أي منصة يمكنها إرسال طلبات HTTP.

  • أين يمكنني العثور على المزيد من الأمثلة ومواصفات API التفصيلية؟
    تتوفر أدلة تفصيلية ومواد مرجعية في Aspose.Email Cloud documentation ومرجع API.

اقرأ المزيد