Захист чутливої інформації під час передачі є важливим для сучасних ділових комунікацій, а 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
- Налаштування конфігурації - Об’єкт
Configurationмістить вашіClientId,ClientSecretта базовий URL. Це необхідно для кожного виклику API.
var config = new Configuration { ClientId = ClientId, ClientSecret = ClientSecret, BaseUrl = "https://api.aspose.cloud" };
- Завантаження файлів -
UploadFileToStorageчитає локальний файл і надсилає його в сховище Aspose Cloud за допомогоюStorageApi.UploadFile.
var fileBytes = File.ReadAllBytes(localPath);
storageApi.UploadFile(new UploadFileRequest { Path = remotePath, File = fileBytes });
- Створення електронного листа - Об’єкт
EmailDtoзаповнюється відправником, одержувачем, темою та текстовим вмістом.
var email = new EmailDto { From = new MailAddress { Address = "sender@example.com" }, ... };
- Шифрування -
EncryptRequestприймає об’єкт листа та шлях до публічного сертифіката.EmailApi.EncryptповертаєEmailDto, що містить зашифрований MIME‑вміст.
var encryptRequest = new EncryptRequest(email, "certs/public.cer");
var encryptedEmail = emailApi.Encrypt(encryptRequest);
- Розшифрування -
DecryptRequestпередає зашифрований лист, шлях до приватного ключа та його пароль.EmailApi.Decryptстворює оригінальне повідомлення.
var decryptRequest = new DecryptRequest(encryptedEmail, "certs/private.pfx", PrivateKeyPassword);
var decryptedEmail = emailApi.Decrypt(decryptRequest);
Ці кроки безпосередньо відповідають REST‑викликам, показаним раніше, і дають вам гнучкість у виборі між C# та чистим HTTP.
Передумови та налаштування для обробки електронної пошти S/MIME
- Встановіть Aspose.Email Cloud SDK for .NET:
dotnet add package Aspose.Email-Cloud - Переконайтеся, що у вас є дійсний обліковий запис Aspose Cloud і отримайте
ClientIdіClientSecret. - Завантажте бінарні файли SDK з офіційної сторінки релізу: Aspose.Email Cloud SDK for .NET Download.
- Розмістіть ваш публічний сертифікат (
*.cer) та приватний ключ (*.pfx) у локальній папці, готовій до завантаження.
Параметри конфігурації для операцій S/MIME
- Базовий URL - Ви можете змінити
BaseUrlу об’єктіConfiguration, якщо потрібно звертатися до іншого регіону.var config = new Configuration { BaseUrl = "https://api.aspose.cloud" }; - Налаштування тайм‑ауту - Налаштуйте тайм‑аут HTTP‑клієнта для великих повідомлень.
config.Timeout = 300000; // 5 minutes - Журналювання - Увімкніть журналювання запитів/відповідей для налагодження за допомогою вбудованого логера 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. -
Чи можу я використовувати той самий код з іншими мовами?
Так. Основний REST API не залежить від мови. Ви можете викликати ті ж самі кінцеві точки з Java, Python, PHP або будь‑якої платформи, яка може надсилати HTTP‑запити. -
Де я можу знайти більше прикладів та докладні специфікації API?
Докладні посібники та довідкові матеріали доступні в документації Aspose.Email Cloud та довідці API.