Beskyttelse af følsomme oplysninger under overførsel er afgørende for moderne forretningskommunikation, og S/MIME giver en gennemprøvet metode til at sikre e‑mailindhold. Aspose.Email Cloud SDK for .NET gør det muligt for udviklere at kryptere og dekryptere S/MIME‑e‑mailmeddelelser i .NET med minimal kode. I denne vejledning vil du se et komplet C#‑eksempel, tilsvarende cURL‑kald og praktiske tips til at sikre, at dine meddelelser forbliver fortrolige.
Komplett kodeeksempel: Krypter og dekrypter S/MIME e‑mailmeddelelser i .NET
Dette eksempel demonstrerer, hvordan man krypterer og dekrypterer en S/MIME‑e‑mail ved hjælp af Aspose.Email Cloud‑biblioteket.
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);
}
}
}
Bemærk: Dette kodeeksempel demonstrerer kernefunktionaliteten. Før du bruger det i dit projekt, skal du sørge for at opdatere alle filstier og konfigurationsværdier, så de matcher dit faktiske miljø, bekræfte at alle nødvendige afhængigheder er korrekt installeret, og teste grundigt i dit udviklingsmiljø. Hvis du støder på problemer, så se venligst den den officielle dokumentation eller kontakt supportteamet for assistance.
S/MIME e-mailkryptering og -dekryptering via REST API ved hjælp af cURL
Nedenfor er REST‑opkaldene, der udfører de samme handlinger som C#‑koden ovenfor. Erstat pladsholderværdierne med dine faktiske legitimationsoplysninger og filnavne.
# 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. Opret e‑mail‑JSON‑payloaden (gem som 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"
For en komplet reference over alle endepunkter, se den officielle API-dokumentation.
Forstå kryptering og dekryptering af S/MIME e‑mailbeskeder i .NET‑kode
-
Konfigurationsopsætning -
Configuration‑objektet indeholder dinClientId,ClientSecretog basis‑URL’en. Dette er påkrævet for hvert API‑kald.var config = new Configuration { ClientId = ClientId, ClientSecret = ClientSecret, BaseUrl = "https://api.aspose.cloud" }; -
Upload af filer -
UploadFileToStoragelæser en lokal fil og sender den til Aspose Cloud‑lagring ved hjælp afStorageApi.UploadFile.var fileBytes = File.ReadAllBytes(localPath); storageApi.UploadFile(new UploadFileRequest { Path = remotePath, File = fileBytes }); -
Opbygning af e‑mailen - Et
EmailDto‑objekt udfyldes med afsender, modtager, emne og en ren‑tekst‑krop.var email = new EmailDto { From = new MailAddress { Address = "sender@example.com" }, ... }; -
Kryptering -
EncryptRequesttager e‑mail‑objektet og stien til det offentlige certifikat.EmailApi.Encryptreturnerer etEmailDto, der indeholder den krypterede MIME‑indhold.var encryptRequest = new EncryptRequest(email, "certs/public.cer"); var encryptedEmail = emailApi.Encrypt(encryptRequest); -
Dekryptering -
DecryptRequestleverer den krypterede e‑mail, stien til den private nøgle og dens adgangskode.EmailApi.Decryptproducerer den oprindelige besked.var decryptRequest = new DecryptRequest(encryptedEmail, "certs/private.pfx", PrivateKeyPassword); var decryptedEmail = emailApi.Decrypt(decryptRequest);
Disse trin svarer direkte til de REST‑kald, der blev vist tidligere, og giver dig fleksibilitet til at vælge mellem C# og rå HTTP.
Forudsætninger og opsætning for S/MIME e‑mailbehandling
- Installer Aspose.Email Cloud SDK for .NET:
dotnet add package Aspose.Email-Cloud
- Sørg for, at du har en gyldig Aspose Cloud‑konto, og få
ClientIdogClientSecret. - Download SDK‑binærerne fra den officielle udgivelsesside: Aspose.Email Cloud SDK for .NET Download.
- Placér dit offentlige certifikat (
*.cer) og din private nøgle (*.pfx) i en lokal mappe klar til upload.
Konfigurationsindstillinger for S/MIME-operationer
- Base URL - Du kan ændre
BaseUrliConfiguration‑objektet, hvis du har brug for at målrette en anden region.var config = new Configuration { BaseUrl = "https://api.aspose.cloud" }; - Timeout Settings - Juster HTTP‑klientens timeout for store meddelelser.
config.Timeout = 300000; // 5 minutes - Logging - Aktivér anmodnings-/svarelogning til fejlfinding via SDK’ens indbyggede logger (se API‑referencen for detaljer).
For en komplet liste over parametre, se API‑referencen.
Bedste praksis for sikker S/MIME e‑mailhåndtering
- Gem certifikater og private nøgler i Aspose Cloud‑lagring ved hjælp af sikre stier og begræns adgangstilladelser.
- Valider certifikatkæder før kryptering for at undgå køretidsfejl.
- Hold adgangskoden til den private nøgle uden for kildekoden; brug miljøvariabler eller en hemmelighedshåndtering.
- Efter dekryptering skal du verificere beskedens integritet ved at kontrollere emnet og brødteksten mod forventede værdier.
- Log kun ikke‑følsomme oplysninger; skriv aldrig rå private nøgler til konsoloutput.
Afslutning
Kryptering og dekryptering af S/MIME‑e‑mailbeskeder i .NET er ligetil med Aspose.Email Cloud SDK for .NET. Biblioteket håndterer den tunge løftning af certifikatstyring, MIME‑formattering og kryptografiske operationer, så du kan fokusere på forretningslogik. Husk at sikre dine legitimationsoplysninger, brug stærke adgangskoder til private nøgler, og test arbejdsgangen med rigtige certifikater, før du implementerer i produktion. Til kommerciel brug har du brug for en betalt licens; du kan gennemgå priser på produktsiden og få en midlertidig licens til evaluering på den midlertidige licensside.
Almindelige spørgsmål
-
Hvordan krypterer og dekrypterer Aspose.Email Cloud SDK for .NET S/MIME e‑mailmeddelelser i .NET?
SDK’en levererEncryptogDecryptmetoder, som accepterer enEmailDtoog certifikatstier. Den udfører S/MIME‑indpakning/udpakning på serversiden og returnerer det behandlede MIME‑indhold. -
Skal jeg køre en mailserver for at teste de krypterede beskeder?
Nej. SDK’en fungerer uafhængigt af enhver mailserver. Du kan kryptere, gemme.eml-filen og senere dekryptere den lokalt eller via API’en. -
Kan jeg bruge den samme kode med andre sprog?
Ja. Den underliggende REST API er sprog‑agnostisk. Du kan kalde de samme endpoints fra Java, Python, PHP eller enhver platform, der kan sende HTTP‑anmodninger. -
Hvor kan jeg finde flere eksempler og detaljerede API-specifikationer?
Detaljerede vejledninger og referencemateriale er tilgængelige i Aspose.Email Cloud-dokumentationen og API-referencen.