Sometimes it can be handy to connect into an IMAP(s) server to verify it is working as expected, or to view emails via a command line interface. In this example I’m connecting to a Microsoft Exchange 2016 Server with IMAP enabled, specifically IMAPS, so running on port 993.<\/p>\n\n\n\n
Firstly we need to connect and login:<\/p>\n\n\n\n
openssl s_client -crlf -connect mail.example.org:993<\/code><\/pre>\n\n\n\nOnce connected, you can login. Notice the “a” at the front of the line, this is needed or you’ll get the following error: LOGIN BAD Command Error. 12<\/strong><\/p>\n\n\n\na LOGIN username password<\/code><\/pre>\n\n\n\nList Folder Structure<\/h2>\n\n\n\n
Once you are connected, you can then view a list folders by using the following:<\/p>\n\n\n\n
a LIST \"\" \"*\"<\/code><\/pre>\n\n\n\nOkay, so in the list we can see our “Inbox”, it will appear like:<\/p>\n\n\n\n
* LIST \"INBOX\/\" \"*\"<\/code><\/pre>\n\n\n\nWe can see the folder structure (if there is one) within “Inbox” and we can also see that there are 31 messages in the root of the “Inbox”. Let’s have a look into it with:<\/p>\n\n\n\n
a EXAMINE \"INBOX\/\"\na OK LIST completed.\na EXAMINE INBOX\n* 31 EXISTS\n* FLAGS (\\Seen \\Answered \\Flagged \\Deleted \\Draft $MDNSent)\n* OK [PERMANENTFLAGS ()] Permanent flags\n* OK [UNSEEN 23] Is the first unseen message\n* OK [UIDVALIDITY 14] UIDVALIDITY value\n* OK [UIDNEXT 239318] The next unique identifier value\na OK [READ-ONLY] EXAMINE completed.<\/code><\/pre>\n\n\n\nSo we can see that there are 31 emails in the “Inbox”. <\/p>\n\n\n\n
Select and Fetch Messages<\/h2>\n\n\n\n
Let’s SELECT the “Inbox” with the below. EXAMINE is the same as SELECT, however the former is read-only, the latter sets the future commands to use this folder as the target.<\/p>\n\n\n\n
a SELECT \"INBOX\/\"<\/code><\/pre>\n\n\n\nLet’s fetch the first 5 messages in the “Inbox”, getting the subject of these messages:<\/p>\n\n\n\n
f fetch 1:5 (BODY[HEADER.FIELDS (Subject)])<\/code><\/pre>\n\n\n\nNice, so let’s get more of the header fields, to help us see all the messages, we’ll retrieve the Subject, Date and From fields, as per the below:<\/p>\n\n\n\n
f fetch 1:5 (BODY[HEADER.FIELDS (Subject Date From)])<\/code><\/pre>\n\n\n\nWe get an output like:<\/p>\n\n\n\n
From: Bob Smith <bob@domain.com>\nSubject: A test message 1\nDate: Fri, 21 Jun 2024 15:04:08 +0100\n\n)\n* 2 FETCH (BODY[HEADER.FIELDS (Subject Date From)] {174}\nFrom: Bob Smith <bob@domain.com>\nDate: Thu, 10 Oct 2024 13:17:51 +0000\nSubject: A test message 2\n [EXT]\n\n)\n* 3 FETCH (BODY[HEADER.FIELDS (Subject Date From)] {121}\nFrom: Bob Smith <bob@domain.com>\nSubject: A test message 3\nDate: Wed, 16 Oct 2024 14:56:35 +0000\n\n)\n* 4 FETCH (BODY[HEADER.FIELDS (Subject Date From)] {167}\nFrom: Bob Smith <bob@domain.com>\nSubject: A test message 4\nDate: Mon, 11 Nov 2024 11:02:27 +0000\n\n)\n* 5 FETCH (BODY[HEADER.FIELDS (Subject Date From)] {136}\nFrom: Bob Smith <bob@domain.com>\nSubject: A test message 5\nDate: Mon, 18 Nov 2024 15:33:08 +0000\n\n)\nf OK FETCH completed.<\/code><\/pre>\n\n\n\nYou’ll notice that the messages are showing up in reverse date order.<\/p>\n\n\n\n
One problem with using FETCH is that it marks the messages as “Seen” i.e. read. If we don’t want to do this, we can use .PEEK, such as:<\/p>\n\n\n\n
f fetch 1:5 (BODY.PEEK[HEADER.FIELDS (Subject Date From)])<\/code><\/pre>\n\n\n\nRead a Message<\/h2>\n\n\n\n
So finally, let’s open and read one of the messages, there are few bits we can do here. One thing to note is we’re reading in plain text, there is no formatting (for HTML) so we’ll see lots of seemingly superfluous information, unless of course everyone who sends you email does so in plain text! We’ll use the “.PEEK” on the end, so it doesn’t mark the message as read.<\/p>\n\n\n\n
a FETCH 1 BODY.PEEK[TEXT]\na FETCH 1 BODY.PEEK[HEADER]\na FETCH 1 BODY.PEEK[]<\/code><\/pre>\n\n\n\nClose\/Logout Session<\/h2>\n\n\n\n
When you are done:<\/p>\n\n\n\n
a LOGOUT<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"Sometimes it can be handy to connect into an IMAP(s) server to verify it is working as expected, or to view emails via a command line interface. In this example I’m connecting to a Microsoft Exchange 2016 Server with IMAP enabled, specifically IMAPS, so running on port 993. Connect and Login Firstly we need to … Read more<\/a><\/p>\n","protected":false},"author":4,"featured_media":4361,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[32,20],"tags":[],"class_list":["post-4358","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-exchange","category-random"],"_links":{"self":[{"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=\/wp\/v2\/posts\/4358","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=4358"}],"version-history":[{"count":4,"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=\/wp\/v2\/posts\/4358\/revisions"}],"predecessor-version":[{"id":4364,"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=\/wp\/v2\/posts\/4358\/revisions\/4364"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=\/wp\/v2\/media\/4361"}],"wp:attachment":[{"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=4358"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=4358"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=4358"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}