Outlook.com SMTP: Replace Password Login with OAuth2
See more SMTP Examples
This replacement for the older password-login sample tests OAuth2 authentication without sending a message. The historical filename is retained for existing links. Setting OAuth2AccessToken makes Chilkat use XOAUTH2; leave SmtpPassword empty. No session log or token is printed.
Personal Outlook.com: This includes Microsoft-hosted Outlook.com, Hotmail, and Live mailboxes. Use delegated OAuth2; ordinary passwords and app passwords are not a replacement for Modern Authentication. SMTP uses smtp-mail.outlook.com:587 with STARTTLS; incoming IMAP/POP use outlook.office365.com on ports 993/995 with implicit TLS. Enable POP or IMAP under Settings > Mail > Forwarding and IMAP before using that protocol. See current Outlook.com settings.
First authorize the account with https://outlook.office.com/SMTP.Send and offline_access, then refresh the access token when needed. This example reads qa_data/tokens/hotmail.json from a private working directory. Microsoft Graph permissions such as Mail.Send or Mail.Read do not authorize these mail protocols. Do not print tokens or authentication logs.
Microsoft reference documentation
Chilkat PureBasic Downloads
IncludeFile "CkMailMan.pb"
IncludeFile "CkJsonObject.pb"
Procedure ChilkatExample()
success.i = 0
; Assumes Chilkat is unlocked. See Global Unlock Sample.
token.i = CkJsonObject::ckCreate()
If token.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
success = CkJsonObject::ckLoadFile(token,"qa_data/tokens/hotmail.json")
If success <> 1
Debug "Could not read qa_data/tokens/hotmail.json from the private working directory."
CkJsonObject::ckDispose(token)
ProcedureReturn
EndIf
If (CkJsonObject::ckJsonTypeOf(token,"access_token") <> 1) OR (CkJsonObject::ckStringOfEquals(token,"access_token","",1) = 1)
Debug "An OAuth access token is required. Authorize or refresh the account first."
CkJsonObject::ckDispose(token)
ProcedureReturn
EndIf
mailbox.s = "user@example.com"
mailman.i = CkMailMan::ckCreate()
If mailman.i = 0
Debug "Failed to create object."
ProcedureReturn
EndIf
CkMailMan::setCkSmtpHost(mailman, "smtp-mail.outlook.com")
CkMailMan::setCkSmtpPort(mailman, 587)
CkMailMan::setCkSmtpSsl(mailman, 0)
CkMailMan::setCkStartTLS(mailman, 1)
CkMailMan::setCkRequireSslCertVerify(mailman, 1)
; Microsoft SMTP submission uses STARTTLS on port 587, not implicit TLS on 465.
CkMailMan::setCkSmtpUsername(mailman, mailbox)
CkMailMan::setCkSmtpPassword(mailman, "")
CkMailMan::setCkOAuth2AccessToken(mailman, CkJsonObject::ckStringOf(token,"access_token"))
success = CkMailMan::ckSmtpConnect(mailman)
If success <> 1
Debug "Could not establish the SMTP STARTTLS connection."
CkJsonObject::ckDispose(token)
CkMailMan::ckDispose(mailman)
ProcedureReturn
EndIf
success = CkMailMan::ckSmtpAuthenticate(mailman)
CkMailMan::ckCloseSmtpConnection(mailman)
If success <> 1
Debug "SMTP authentication failed. Check token expiry, scope, mailbox, and account settings."
CkJsonObject::ckDispose(token)
CkMailMan::ckDispose(mailman)
ProcedureReturn
EndIf
Debug "SMTP OAuth2 authentication succeeded; no message was sent."
CkJsonObject::ckDispose(token)
CkMailMan::ckDispose(mailman)
ProcedureReturn
EndProcedure