Microsoft MVP성태의 닷넷 이야기
닷넷: 2328. C# - MailKit: SMTP, POP3, IMAP 지원 라이브러리 [링크 복사], [링크+제목 복사],
조회: 4332
글쓴 사람
정성태 (seongtaejeong at gmail.com)
홈페이지
첨부 파일
 

(시리즈 글이 7개 있습니다.)
기타: 58. Outlook에 설정한 SMTP/POP3(예:천리안 메일) 계정 암호를 잊어버린 경우
; https://www.sysnet.pe.kr/2/0/11010

기타: 59. outlook.live.com 메일 서비스의 아웃룩 POP3 설정하는 방법
; https://www.sysnet.pe.kr/2/0/11011

.NET Framework: 761. C# - SmtpClient로 SMTP + SSL/TLS 서버를 이용하는 방법
; https://www.sysnet.pe.kr/2/0/11537

개발 환경 구성: 454. Azure 가상 머신(VM)에서 SMTP 메일 전송하는 방법
; https://www.sysnet.pe.kr/2/0/11994

.NET Framework: 848. C# - smtp.daum.net 서비스(Implicit SSL)를 이용해 메일 보내는 방법
; https://www.sysnet.pe.kr/2/0/11995

오류 유형: 757. 구글 메일 - 아웃룩에서 메일 전송 시 Sending' reported error (0x800CCC0F, 0x800CCC92)
; https://www.sysnet.pe.kr/2/0/12784

닷넷: 2328. C# - MailKit: SMTP, POP3, IMAP 지원 라이브러리
; https://www.sysnet.pe.kr/2/0/13908




C# - MailKit: SMTP, POP3, IMAP 지원 라이브러리

이번엔 라이브러리 소개를 해볼까요? ^^

Sending Emails with Gmail Using MailKit in .NET Web API: The Complete Guide
; https://dev.to/mamun_akand/sending-emails-with-gmail-using-mailkit-in-net-web-api-4lj5

jstedfast/MailKit - cross-platform mail client library built on top of MimeKit.
; https://github.com/jstedfast/MailKit

물론, 간단하게 SMTP를 이용해도 되지만,

C# - SmtpClient로 SMTP + SSL/TLS 서버를 이용하는 방법
; https://www.sysnet.pe.kr/2/0/11537

좀 더 기능이 다양한 MailKit도 좋은 선택이 될 수 있습니다. ^^ 사용법도 매우 간단한데요, 아래는 Gmail을 이용한 메일 발송 예제입니다.

using MailKit.Net.Smtp;
using MailKit.Security;
using MimeKit;

// Install-Package MailKit

internal class Program
{
    static async Task Main(string[] args)
    {
        var smtpServer = "smtp.gmail.com";
        var port = 587;

        // 사용자의 상황에 맞게 변경
        (string fromMail, string password) = ("...user_email...", "...user password...");
        string toEmail = "test@email.com";
        string mailSubject = "Test Mail";
        string mailBody = "This is a test mail";

        var email = new MimeMessage();
        email.From.Add(new MailboxAddress("Your Name", fromMail));
        email.To.Add(new MailboxAddress("To Name", toEmail));
        email.Subject = mailSubject;
        email.Body = new TextPart("html") { Text = mailBody };

        using var smtp = new SmtpClient();
        await smtp.ConnectAsync(smtpServer, port, SecureSocketOptions.StartTls);
        await smtp.AuthenticateAsync(fromMail, password);
        await smtp.SendAsync(email);
        await smtp.DisconnectAsync(true);
    }
}

그 외, POP3를 사용해 메일을 가져오는 예제나, IMAP을 이용한 예제도 github에 잘 소개돼 있으니 참고하세요. ^^




만약 이런 오류가 발생한다면?

MailKit.Security.AuthenticationException
  HResult=0x80131500
  Message=535: 5.7.8 Username and Password not accepted. For more information, go to
5.7.8  https://support.google.com/mail/?p=BadCredentials d2e1a72fcca58-739710db4cfsm6759700b3a.176 - gsmtp
  Source=MailKit
  StackTrace:
   at MailKit.Net.Smtp.SmtpClient.<AuthenticateAsync>d__7.MoveNext()
   at ConsoleApp1.Program.<Main>d__0.MoveNext() in C:\temp\ConsoleApp1\ConsoleApp1\Program.cs:line 34
   at ConsoleApp1.Program.<Main>(String[] args)

Inner Exception 1:
SmtpCommandException: 5.7.8 Username and Password not accepted. For more information, go to
5.7.8  https://support.google.com/mail/?p=BadCredentials d2e1a72fcca58-739710db4cfsm6759700b3a.176 - gsmtp

메시지에 나오듯이 코드에 입력한 "Username / Password"가 올바르지 않은 경우인데요, App password를 정상적으로 입력했는지 확인해 보세요.

Sign in with app passwords
; https://support.google.com/mail/answer/185833?hl=en

App passwords
; https://myaccount.google.com/apppasswords




.NET Framework 4 프로젝트에서 MailKit을 사용하는 경우 Connect 호출 시 이런 오류가 발생한다면?

smtp.Connect(smtpServer, port, SecureSocketOptions.StartTls);

[ArgumentException: The specified value is not valid in the 'SslProtocolType' enumeration.
Parameter name: sslProtocolType]
   System.Net.Security.SslState.ValidateCreateContext(Boolean isServer, String targetHost, SslProtocols enabledSslProtocols, X509Certificate serverCertificate, X509CertificateCollection clientCertificates, Boolean remoteCertRequired, Boolean checkCertRevocationStatus, Boolean checkCertName) +942
   System.Net.Security.SslStream.AuthenticateAsClient(String targetHost, X509CertificateCollection clientCertificates, SslProtocols enabledSslProtocols, Boolean checkCertificateRevocation) +71
   MailKit.Net.Smtp.SmtpClient.SslHandshake(SslStream ssl, String host, CancellationToken cancellationToken) in D:\src\MailKit\MailKit\Net\Smtp\SmtpClient.cs:1313
   MailKit.Net.Smtp.SmtpClient.PostConnect(Stream stream, String host, Int32 port, SecureSocketOptions options, Boolean starttls, CancellationToken cancellationToken) in D:\src\MailKit\MailKit\Net\Smtp\SmtpClient.cs:1359

[SslHandshakeException: An error occurred while attempting to establish an SSL or TLS connection.

This usually means that the SSL certificate presented by the server is not trusted by the system for one or more of
the following reasons:

1. The server is using a self-signed certificate which cannot be verified.
2. The local system is missing a Root or Intermediate certificate needed to verify the server's certificate.
3. A Certificate Authority CRL server for one or more of the certificates in the chain is temporarily unavailable.
4. The certificate presented by the server is expired or invalid.
5. The set of SSL/TLS protocols supported by the client and server do not match.

See https://github.com/jstedfast/MailKit/blob/master/FAQ.md#ssl-handshake-exception for possible solutions.
]
   MailKit.Net.Smtp.SmtpClient.PostConnect(Stream stream, String host, Int32 port, SecureSocketOptions options, Boolean starttls, CancellationToken cancellationToken) in D:\src\MailKit\MailKit\Net\Smtp\SmtpClient.cs:1376
   MailKit.Net.Smtp.SmtpClient.Connect(String host, Int32 port, SecureSocketOptions options, CancellationToken cancellationToken) in D:\src\MailKit\MailKit\Net\Smtp\SmtpClient.cs:1507
   ...[생략]...
   System.Web.UI.Control.OnLoad(EventArgs e) +99
   System.Web.UI.Control.LoadRecursive() +154
   System.Web.UI.Page.ProcessRequestMain(Boolean includeStagesBeforeAsyncPoint, Boolean includeStagesAfterAsyncPoint) +4077
]

검색해 보면 이런 답변이 있는데요,

SslHandshakeException: An error occurred while attempting to establish an SSL or TLS connection
; https://stackoverflow.com/questions/59026301/sslhandshakeexception-an-error-occurred-while-attempting-to-establish-an-ssl-or

제시된 4개의 해결책 중에 CheckCertificateRevocation과 ServerCertificateValidationCallback은 답이 되지 않았고 SmtpClient.SslProtocols에 옵션을 설정하는 것으로 해결되었습니다.

using var smtp = new MailKit.Net.Smtp.SmtpClient();
smtp.SslProtocols = SslProtocols.Ssl3 | SslProtocols.Tls | SslProtocols.Tls11 | SslProtocols.Tls12 | SslProtocols.Tls13;
smtp.Connect(smtpServer, port, SecureSocketOptions.StartTls);
smtp.Authenticate(fromMail, password);
smtp.Send(email);
smtp.Disconnect(true);




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]







[최초 등록일: ]
[최종 수정일: 4/3/2025]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




... 46  47  [48]  49  50  51  52  53  54  55  56  57  58  59  60  ...
NoWriterDateCnt.TitleFile(s)
12782정성태8/14/202115910오류 유형: 756. 파이썬 - 윈도우 환경에서 pytagcloud의 한글 출력 방법
12781정성태8/14/202118048오류 유형: 755. 파이썬 - konlpy 사용 시 JVM과 jpype1 관련 오류
12780정성태8/13/202117144.NET Framework: 1088. C# - 버스 노선 및 위치 정보 조회 API 사용을 위한 기초 라이브러리 [2]
12779정성태8/13/202119570개발 환경 구성: 596. 공공 데이터 포털에서 버스 노선 및 위치 정보 조회 API 사용법
12778정성태8/12/202115264오류 유형: 755. PyCharm - "Manage Repositories"의 목록이 나오지 않는 문제
12777정성태8/12/202117478오류 유형: 754. Visual Studio - Input or output cannot be redirected because the specified file is invalid.
12776정성태8/12/202115610오류 유형: 753. gunicorn과 uwsgi 함께 사용 시 ERR_CONNECTION_REFUSED
12775정성태8/12/202129617스크립트: 22. 파이썬 - 윈도우 환경에서 개발한 Django 앱을 WSL 환경의 gunicorn을 이용해 실행
12774정성태8/11/202119605.NET Framework: 1087. C# - Collection 개체의 다중 스레드 접근 시 "Operations that change non-concurrent collections must have exclusive access" 예외 발생
12773정성태8/11/202118785개발 환경 구성: 595. PyCharm - WSL과 연동해 Django App을 윈도우에서 리눅스 대상으로 개발
12772정성태8/11/202119067스크립트: 21. 파이썬 - 윈도우 환경에서 개발한 Django 앱을 WSL 환경의 uwsgi를 이용해 실행 [1]
12771정성태8/11/202117806Windows: 196. "Microsoft Windows Subsystem for Linux Background Host" / "Vmmem"을 종료하는 방법
12770정성태8/11/202117571.NET Framework: 1086. C# - Windows Forms 응용 프로그램의 자식 컨트롤 부하파일 다운로드1
12769정성태8/11/202114456오류 유형: 752. Python - ImportError: No module named pip._internal.cli.main 두 번째 이야기
12768정성태8/10/202115943.NET Framework: 1085. .NET 6에 포함된 신규 BCL API [1]파일 다운로드1
12767정성태8/10/202116841오류 유형: 752. Python - ImportError: No module named pip._internal.cli.main
12766정성태8/9/202114875Java: 32. closing inbound before receiving peer's close_notify
12765정성태8/9/202116279Java: 31. Cannot load JDBC driver class 'org.mysql.jdbc.Driver'
12764정성태8/9/202154412Java: 30. XML document from ServletContext resource [/WEB-INF/applicationContext.xml] is invalid
12763정성태8/9/202118630Java: 29. java.lang.NullPointerException - com.mysql.jdbc.ConnectionImpl.getServerCharset
12762정성태8/8/202121163Java: 28. IntelliJ - Unable to open debugger port 오류
12761정성태8/8/202117544Java: 27. IntelliJ - java: package javax.inject does not exist [2]
12760정성태8/8/202113851개발 환경 구성: 594. 전용 "Command Prompt for ..." 단축 아이콘 만들기
12759정성태8/8/202119628Java: 26. IntelliJ + Spring Framework + 새로운 Controller 추가 [2]파일 다운로드1
12758정성태8/7/202119270오류 유형: 751. Error assembling WAR: webxml attribute is required (or pre-existing WEB-INF/web.xml if executing in update mode)
12757정성태8/7/202119883Java: 25. IntelliJ + Spring Framework 프로젝트 생성
... 46  47  [48]  49  50  51  52  53  54  55  56  57  58  59  60  ...