Yksinkertaisten todennusongelmien korjaaminen Outlookissa MailKitin ja ASP.NET Core Web API:n avulla

Outlookin todennusongelmien ymmärtäminen ASP.NET Coren ja MailKitin avulla

Kun integroidaan Outlookin sähköpostitoiminto MailKitin avulla kehittäjät kohtaavat usein todennusongelmia. Yksi yleinen ongelma on "535: 5.7.139 Authentication unsuccessful" -virhesanoma. Tämä tapahtuu yleensä, kun perustodennusmenetelmä on poistettu käytöstä Outlook-palvelimessa, jolloin yhteysyritys epäonnistuu.

Microsoftin kaltaiset palveluntarjoajat ovat yhä useammin poistaneet käytöstä perustodennusta, joka on kerran käytetty laajasti turvallisuuden parantamiseksi. Sen sijaan suositaan nykyaikaisia ​​todennusmenetelmiä, kuten OAuth2. Tämä muutos voi aiheuttaa hämmennystä etenkin kehittäjille, jotka ovat tottuneet käyttämään käyttäjätunnuksia ja salasanoja suoraan.

Tässä tilanteessa olet saattanut käyttää oikeita Outlookin SMTP-palvelinasetuksia ja sovelluskohtaista salasanaa, mutta kohtasit silti todennusvirheitä. Näiden ongelmien tehokkaan ratkaisemisen kannalta on tärkeää ymmärtää, miksi perustodennus epäonnistuu. Virhe viittaa tietoturvapolitiikan täytäntöönpanoon eikä itse koodiin liittyvään ongelmaan.

Tässä artikkelissa tutkimme, miksi tämä virhe ilmenee, sen taustalla olevia syitä ja ohjeita, joilla voit ratkaista ongelman. Keskustelemme myös vaihtoehtoisista todennusmenetelmistä, kuten OAuth2:sta, varmistaaksemme turvallisen ja onnistuneen viestinnän Outlookin palvelimien kanssa.

Komento	Esimerkki käytöstä
ConfidentialClientApplicationBuilder.Create()	Tätä komentoa käytetään luottamuksellisen asiakassovelluksen luomiseen OAuth2-todennusta varten. Se on osa Microsoft Identity Client (MSAL) -kirjastoa ja alustaa sovelluksen asiakastunnuksella, jolloin se voi hankkia tunnuksia suojattua viestintää varten.
SaslMechanismOAuth2()	Tämä komento on erityinen MailKitille, ja sitä käytetään todentamiseen OAuth2-tunnuksella lähetettäessä sähköposteja. Se ohittaa perustodennuksen käyttämällä turvallisempaa menetelmää OAuth2-protokollan kautta.
AcquireTokenForClient(scopes).ExecuteAsync()	Tämä menetelmä hankkii OAuth2-tunnuksen asiakassovellukselle. Se on osa MSAL-kirjastoa ja on välttämätön sovellusliittymien, kuten Microsoft Graph- tai SMTP-palvelimien, käyttötunnisteiden luomiseksi.
GraphServiceClient	Tätä objektia käytetään Microsoft Graph API:ssa vuorovaikutukseen Microsoft-palvelujen kanssa. Sen avulla kehittäjät voivat lähettää sähköposteja, hallita käyttäjiä tai olla vuorovaikutuksessa muiden Microsoft 365:n resurssien kanssa OAuth2-tunnuksilla.
DelegateAuthenticationProvider()	Tätä komentoa käytetään Microsoft Graph API -pyyntöjen todennusprosessin määrittämiseen. Se määrittää OAuth2-tunnuksen jokaiselle API-pyynnölle dynaamisesti, mikä varmistaa turvallisen viestinnän.
SendMail(message, false).Request().PostAsync()	Tämä komento on osa Graph API:ta, joka lähettää muodostetun sähköpostiviestin asynkronisesti. Se lähettää viestin käyttäjän postilaatikkoon Microsoft Graphin suojatun sähköpostin lähetystoiminnon avulla.
SmtpClient.AuthenticateAsync()	MailKitissä tämän komennon avulla asiakas voi todentaa sähköpostipalvelimen avulla valtuustietoja, kuten OAuth2-tunnuksia. Se korvaa perinteisen käyttäjätunnuksen ja salasanan todennusmenetelmän.
SecureSocketOptions.StartTls	Tätä komentoa käytetään muodostettaessa yhteyttä SMTP-palvelimeen suojatun, salatun yhteyden pakottamiseksi STARTTLS-protokollan kautta varmistaen, että tiedot siirretään turvallisesti verkon yli.
MimeMessage	Tämä luokka edustaa sähköpostiviestiä MailKit-kirjastossa. Se sisältää tiedot, kuten sähköpostin lähettäjän, vastaanottajan, aiheen ja tekstin. Se on välttämätöntä sähköpostin sisällön luomisessa ja muotoilussa ennen lähettämistä.

OAuth2-integroinnin tutkiminen suojattua sähköpostin lähettämistä varten

Yllä olevat skriptit on suunniteltu käsittelemään havaitaan lähetettäessä sähköposteja Outlookin SMTP-palvelimen kautta käyttämällä MailKit ASP.NET Core Web API -sovellusliittymässä. Virhe johtuu siitä, että Microsoft on poistanut perustodennuksen käytöstä turvallisuuden parantamiseksi ja pakottanut kehittäjät ottamaan käyttöön OAuth2:n, turvallisemman todennustavan. Ensimmäisessä ratkaisussa käytimme MailKitiä OAuth2-tunnuksilla sähköpostin todentamiseen ja lähettämiseen. Käyttäjätunnuksen ja salasanan sijaan OAuth2 vaatii tunnuksen, jonka Microsoft Identity Client (MSAL) luo ja jota käytetään pyyntöjen turvalliseen todentamiseen.

Aluksi ratkaisu käyttää MSAL-kirjastoon kuuluvaa ConfidentialClientApplicationBuilder.Create()-menetelmää asiakassovelluksen luomiseen. Tämä vaihe alustaa sovelluksen tärkeillä valtuustiedoilla, kuten asiakastunnuksella, vuokralaisen tunnuksella ja asiakkaan salaisuudella, joita tarvitaan OAuth2-tunnuksen luomiseen. Kun sovellus on rakennettu, AcquireTokenForClient()-menetelmä noutaa tunnuksen, joka tarvitaan todentamiseen Outlookin SMTP-palvelimella. Käyttämällä "SaslMechanismOAuth2()" -mekanismia MailKit voi sitten todentaa sähköpostin lähetysprosessin tällä tunnuksella ohittaen perustodennuksen kokonaan. Tämä menetelmä varmistaa, että sovellus noudattaa nykyaikaisia ​​suojausprotokollia ja välttää vanhentuneita menetelmiä.

Toisessa ratkaisussa Microsoft Graph API:ta käytetään sähköpostien lähettämiseen ilman suoraa vuorovaikutusta SMTP-palvelimen kanssa. Microsoft Graph tarjoaa all-in-one-ratkaisun Microsoft-palvelujen, mukaan lukien Outlook-sähköpostien, hallintaan. Graph API hyödyntää OAuth2-todennusta "DelegateAuthenticationProvider()" -palvelun kautta, joka määrittää OAuth2-tunnuksen jokaiselle pyynnölle. Tämä tunnus luodaan samalla tavalla MSAL:n avulla. "GraphServiceClient" -objekti mahdollistaa suojatun viestinnän Microsoftin palvelimien kanssa, jolloin API voi lähettää sähköpostiviestejä saumattomasti. Tämä menetelmä on erityisen hyödyllinen niille, jotka haluavat käsitellä laajempaa Microsoft-palveluiden määrää harvemmilla suorilla yhteyksillä yksittäisiin palveluihin, kuten SMTP:hen.

Lopuksi, kolmannessa ratkaisussa tutkimme perinteisempää lähestymistapaa käyttämällä sisäänrakennettua .NET:n nimiavaruus. Vaikka se käyttää edelleen OAuth2:ta todentamiseen, tämä menetelmä korvaa MailKitin System.Net.Mailin SMTP-asiakkaalla sähköpostien lähettämiseen. OAuth2-tunnus välitetään valtuustietona tavallisen käyttäjätunnuksen ja salasanan yhdistelmän sijaan. Sähköposti muodostetaan ja lähetetään käyttämällä tyypillisiä "MailMessage"- ja "SmtpClient"-objekteja. Tämä lähestymistapa voi olla hyödyllinen kehittäjille, jotka haluavat työskennellä alkuperäisten .NET-kirjastojen kanssa, mutta vaativat silti suojatun OAuth2-todennuksen sähköpostien lähettämiseen.

Kaikki nämä menetelmät eivät ainoastaan ​​ratkaise perustodennuksen poistamista käytöstä, vaan myös varmistavat tulevaisuuden ASP.NET Core Web API -sähköpostin lähetystoiminnon. Jokainen ratkaisu korostaa turvallisuuden tärkeyttä OAuth2:n kautta, joka korvaa vanhentuneet ja vähemmän turvalliset todennustavat. Hyödyntämällä nykyaikaisia ​​todennuskirjastoja, kuten MSAL ja Microsoft Graph, kehittäjät voivat varmistaa, että heidän sovelluksensa ovat uusimpien suojausstandardien mukaisia, mutta tarjoavat silti luotettavat sähköpostin lähetysominaisuudet.

// Step 1: Install required NuGet packages
// MailKit, MimeKit, and Microsoft.Identity.Client for OAuth2

using MailKit.Net.Smtp;
using MimeKit;
using Microsoft.Identity.Client;

// Step 2: Configure OAuth2 authentication
var clientId = "your-client-id";
var tenantId = "your-tenant-id";
var clientSecret = "your-client-secret";

var cca = ConfidentialClientApplicationBuilder
    .Create(clientId)
    .WithClientSecret(clientSecret)
    .WithAuthority(new Uri($"https://login.microsoftonline.com/{tenantId}"))
    .Build();

var scopes = new[] { "https://outlook.office365.com/.default" };
var result = await cca.AcquireTokenForClient(scopes).ExecuteAsync();

// Step 3: Send email using OAuth2 token
var emailMessage = new MimeMessage();
emailMessage.From.Add(new MailboxAddress("Your Name", "your-email@outlook.com"));
emailMessage.To.Add(new MailboxAddress("Recipient", "recipient@example.com"));
emailMessage.Subject = "Subject";
emailMessage.Body = new TextPart("plain") { Text = "Hello, this is a test email." };

using (var smtpClient = new SmtpClient())
{
    await smtpClient.ConnectAsync("smtp.office365.com", 587, SecureSocketOptions.StartTls);
    await smtpClient.AuthenticateAsync(new SaslMechanismOAuth2("your-email@outlook.com", result.AccessToken));
    await smtpClient.SendAsync(emailMessage);
    await smtpClient.DisconnectAsync(true);
}

// Step 1: Add Microsoft.Graph NuGet package
using Microsoft.Graph;
using Microsoft.Identity.Client;

// Step 2: Configure Graph API and authentication
var confidentialClient = ConfidentialClientApplicationBuilder.Create(clientId)
    .WithTenantId(tenantId)
    .WithClientSecret(clientSecret)
    .Build();

var graphClient = new GraphServiceClient(new DelegateAuthenticationProvider(async (requestMessage) =>
{
    var authResult = await confidentialClient.AcquireTokenForClient(scopes).ExecuteAsync();
    requestMessage.Headers.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", authResult.AccessToken);
}));

// Step 3: Prepare and send email via Graph API
var message = new Message
{
    Subject = "Test Email",
    Body = new ItemBody
    {
        ContentType = BodyType.Text,
        Content = "Hello, this is a test email sent via Microsoft Graph API."
    },
    ToRecipients = new List<Recipient>()
    {
        new Recipient { EmailAddress = new EmailAddress { Address = "recipient@example.com" } }
    }
};

await graphClient.Users["your-email@outlook.com"].SendMail(message, false).Request().PostAsync();

// Step 1: Configure OAuth2 with System.Net.Mail
var smtpClient = new SmtpClient("smtp.office365.com")
{
    Port = 587,
    EnableSsl = true,
    UseDefaultCredentials = false,
    Credentials = new NetworkCredential("your-email@outlook.com", accessToken)
};

// Step 2: Construct the email message
var mailMessage = new MailMessage
{
    From = new MailAddress("your-email@outlook.com"),
    Subject = "Test Email",
    Body = "This is a test email sent using System.Net.Mail with OAuth2.",
    IsBodyHtml = true
};

mailMessage.To.Add("recipient@example.com");

// Step 3: Send the email
await smtpClient.SendMailAsync(mailMessage);

Sähköpostin lähettämisen nykyaikaisten tietoturvastandardien käyttöönotto

Nykyaikaisten sähköpostijärjestelmien yhteydessä perustodennus nähdään yhä enemmän vanhentuneena ja epävarmana. Tämä pätee erityisesti suuriin palveluntarjoajiin, kuten Outlook, jotka ovat poistaneet perustodennuksen käytöstä turvatakseen OAuth2:n kaltaisia ​​turvallisempia mekanismeja. Perustodennus, joka perustuu yksinomaan käyttäjätunnukseen ja salasanaan, on alttiina raa'an voiman hyökkäyksille, ja se voi vaarantua, jos tunnistetiedot varastetaan. Siksi siirtyminen OAuth2:een, kuten Microsoft kannustaa, varmistaa, että tunnukset vaihdetaan turvallisesti paljastamatta käyttäjän tunnistetietoja.

Yksi keskeinen näkökohta OAuth2:n käyttöönotossa on käyttöoikeustunnusten käsite. Sen sijaan, että luottaisi suoraan SMTP-palvelimien kautta tapahtuvaan todennukseen, OAuth2 myöntää aikasidottuja tunnuksia, jotka mahdollistavat suojatun pääsyn resursseihin, kuten sähköpostipalveluihin. Nämä tunnukset myöntää valtuutuspalvelin, ja kehittäjät voivat hankkia ne käyttämällä kirjastoja, kuten Microsoft Identity Client (MSAL). Näiden tunnuksien avulla sovellukset saavat rajoitetun pääsyn käyttäjän tilille, mikä vähentää pitkittyneisiin, staattisiin valtuustietoihin liittyviä riskejä.

Lisäksi OAuth2:n käyttöönotto ei ainoastaan ​​yhdenmukaista sovelluksesi nykyaikaisten tietoturvakäytäntöjen kanssa, vaan myös valmistelee sitä tulevaa kehitystä varten. Monet sovellusliittymät, mukaan lukien pilvipohjaisten palvelujen sovellusliittymät, luottavat nyt vahvasti OAuth2:een turvallisessa viestinnässä. Tämä varmistaa, että sähköpostin lähetystoiminto pysyy toimivana ja turvallisena palveluiden kehittyessä. Integroiville kehittäjille kanssa , OAuth2:n hyödyntäminen tuo joukon tietoturvaparannuksia token-pohjaisesta todennuksesta salattuihin lähetyksiin protokollien, kuten STARTTLS, kautta.

1. Mikä aiheuttaa 535: 5.7.139 -virheen Outlookissa?
2. Tämä virhe ilmenee, koska Outlookin SMTP-palvelimen perustodennus on poistettu käytöstä. Microsoft vaatii nyt OAuth2:ta suojattua todennusta varten.
3. Kuinka voin ottaa OAuth2:n käyttöön MailKitissä?
4. Voit ottaa OAuth2:n käyttöön käyttämällä määrittääksesi sovelluksesi ja sähköpostin lähettämisen todentamiseksi tunnuksilla.
5. Mikä on vaihtoehto perustodennukselle sähköpostien lähettämiseen Outlookissa?
6. OAuth2 on ensisijainen vaihtoehto. Se käyttää tunnuksia käyttäjätunnusten ja salasanojen sijasta turvalliseen, aikarajalliseen todentamiseen.
7. Onko Microsoft Graph API parempi kuin SMTP:n käyttäminen sähköpostien lähettämiseen?
8. Microsoft Graph API on laajempi palvelu, joka pystyy käsittelemään muutakin kuin vain sähköpostien lähettämistä. Se on monipuolisempi ja suositeltavaa, jos tarvitset pääsyn erilaisiin Microsoft 365 -resursseihin.
9. Kuinka testaan, toimiiko OAuth2 oikein sovelluksessani?
10. Voit ottaa käyttöön yksikkötestejä varmistaaksesi, että OAuth2-tunnuksesi luodaan ja välitetään oikein sähköpostin lähetyspalveluun.

Outlookin perustodennusvirheen ratkaiseminen edellyttää nykyaikaisten suojausstandardien, kuten OAuth2:n, käyttöönottoa. Tämä lähestymistapa poistaa perustodennuksen haavoittuvuudet ja tarjoaa turvallisemman tavan lähettää viestejä Outlookin SMTP-palvelimen kautta.

Integroimalla OAuth2:n ASP.NET Coren ja MailKitin kanssa kehittäjät voivat turvata sovelluksensa tulevaisuuden kannalta, mikä varmistaa turvallisen viestinnän ja päivitettyjen palveluntarjoajan vaatimusten noudattamisen. Tämä ei ainoastaan ​​ratkaise todennusongelmaa, vaan myös parantaa yleistä turvallisuutta ja toimivuutta.