Microsoft MVP성태의 닷넷 이야기
닷넷: 2328. C# - MailKit: SMTP, POP3, IMAP 지원 라이브러리 [링크 복사], [링크+제목 복사],
조회: 6524
글쓴 사람
정성태 (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

비밀번호

댓글 작성자
 




... 91  [92]  93  94  95  96  97  98  99  100  101  102  103  104  105  ...
NoWriterDateCnt.TitleFile(s)
11726정성태10/7/201828906사물인터넷: 49. 라즈베리 파이를 이용해 원격 컴퓨터의 전원 스위치 제어파일 다운로드1
11724정성태10/5/201828830개발 환경 구성: 407. 유니코드와 한글 - "Hangul Compatibility Jamo"파일 다운로드1
11723정성태10/4/201819882개발 환경 구성: 406. "Docker for Windows" 컨테이너 내의 .NET Core 응용 프로그램에서 직렬 포트(Serial Port, COM Port) 사용 방법
11722정성태10/4/201825603.NET Framework: 798. C# - Hyper-V 가상 머신의 직렬 포트와 연결된 Named Pipe 간의 통신파일 다운로드1
11721정성태10/4/201826055.NET Framework: 797. Linux 환경의 .NET Core 응용 프로그램에서 직렬 포트(Serial Port, COM Port) 사용 방법파일 다운로드1
11720정성태10/4/201827444개발 환경 구성: 405. Hyper-V 가상 머신에서 직렬 포트(Serial Port, COM Port) 사용
11719정성태10/4/201828159.NET Framework: 796. C# - 인증서를 윈도우에 설치하는 방법
11718정성태10/4/201823025개발 환경 구성: 404. (opkg가 설치된) Synology NAS(DS216+II)에 cmake 설치
11717정성태10/3/201824769사물인터넷: 48. 넷두이노의 C# 네트워크 프로그램 [1]
11716정성태10/3/201826158사물인터넷: 47. Raspberry PI Zero (W)에 FTDI 장치 연결 후 C/C++로 DTR 제어파일 다운로드1
11715정성태10/3/201823915사물인터넷: 46. Raspberry PI Zero (W)에 docker 설치
11714정성태10/2/201824245사물인터넷: 45. Raspberry PI에 ping을 hostname으로 하는 방법
11713정성태10/2/201824976개발 환경 구성: 403. Synology NAS(DS216+II)에 docker 설치 후 .NET Core 2.1 응용 프로그램 실행하는 방법
11712정성태10/2/201830746.NET Framework: 795. C# - 폰트 목록을 한글이 아닌 영문으로 구하는 방법 [3]
11711정성태10/2/201825679오류 유형: 490. 윈도우 라이선스 키 입력 오류 0xc004f050, 0xc004e028
11710정성태10/2/201825236.NET Framework: 794. C# - 같은 모양, 다른 값의 한글 자음을 비교하는 호환 분해 [5]
11709정성태9/30/201824055개발 환경 구성: 402. .NET Core 콘솔 응용 프로그램을 docker로 실행/디버깅하는 방법 [1]
11708정성태9/30/201827327개발 환경 구성: 401. .NET Core 콘솔 응용 프로그램을 배포(publish) 시 docker image 자동 생성 [2]파일 다운로드1
11707정성태9/30/201828888오류 유형: 489. ASP.NET Core를 docker에서 실행 시 "Failed with a critical error." 오류 발생 [1]
11706정성태9/29/201822988개발 환경 구성: 400. Synology NAS(DS216+II)에서 실행한 gcc의 Segmentation fault [2]
11705정성태9/29/201823507개발 환경 구성: 399. Synology NAS(DS216+II)에 gcc 컴파일러 설치
11704정성태9/29/201829442기타: 73. Synology NAS 신호음(beep) 끄기 [1]파일 다운로드1
11703정성태9/27/201822197개발 환경 구성: 398. Blazor 환경 구성 후 빌드 속도가 너무 느리다면? [2]
11702정성태9/26/201819956사물인터넷: 44. 넷두이노(Netduino)의 네트워크 설정 방법
11701정성태9/26/201825862개발 환경 구성: 397. 공유기를 일반 허브로 활용하는 방법파일 다운로드1
11700정성태9/21/201825680Graphics: 25. Unity - shader의 직교 투영(Orthographic projection) 행렬(UNITY_MATRIX_P)을 수작업으로 구성
... 91  [92]  93  94  95  96  97  98  99  100  101  102  103  104  105  ...