nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

How do I set up an Office 365 email account for Jira Service Desk

Bill Kunneke

We have created a Jira SD project and want to associate an external email with the project. We've navigated to Project Settings -> Email Requests and tested the work flow with the built in Atlassian email and the flow works. But now we want to add a custom email address and here lies our problem.

Background details on the email:

Microsoft Office 365
NOT a shared mailbox, it's a regular user
We've tested to make sure someone can login to the account from a browser

When we navigate to Project Settings -> Email Requests -> Add a custom email address and fill in the appropriate settings, we can't get Jira to connect to the email. We've worked with our IT and tried over 20 combinations of protocols (POP3, iMAP, etc) with numerous port settings (both the defaults and the ones recommended by Microsoft). We've read through documentation, read posts on the net, but we can't find a resolution.

Some of the error messages we've received:

Authenticate failed
No login methods supported
Logon failure unknown user name or password
Command is not valid in this state
Timeout trying to reach server

Our IT is just as baffled as we are, we never expected this to be an issue in setting up a new Service Desk project. What else can I provide to help us solve what should be a relatively simple set up?

Accepted answers

Peter Hamilton-Harding

I've had lots of "fun" getting incoming IMAP and outgoing SMTP to work using the one mailbox, finally there. I know I'm not answering every question above, but hope my findings can help. Obviously replace 'fake', 'tenant', and 'domain' with your real ones.

-Must not be a shared mailbox

-Before you do anything in Jira, sign in to the damn mailbox in OWA and make sure it actually works just as a mailbox. Any problems you have at this point are for Microsoft Support/Forums. Don't forget to test both directions internally and externally

-Incoming Mail IMAP settings:
Protocol: SECURE_IMAP
Host Name: outlook.office365.com
Port: 993
Username: fake@tenant.onmicrosoft.com

-Outgoing mail SMTP settings:
From address: fake@domain.com
Protocol: SMTP
Hostname: tenant.mail.protection.outlook.com (replace this with the MX endpoint for your O365 tenant, always ends with "mail.protection.outlook.com")
SMTP Port: 25
TLS: Yes
Username: fake

All comments

Rodrigo Baldasso

Hi Bill,

Those messages are a bit generic for me to give you a straightforward answer, but, it is likely an issue with the SSL certificate. Are you using a custom domain or Microsoft's Office 365 default url when trying to set up the mailbox?

-Rodrigo.

Bill Kunneke

The mail server is outlook.office365.com.

Allan Libby

I am also having the same issue. Jira only says 'Unfortunately JIRA couldn't connect to the mail server. Here is what the mail server said: "Connection timed out: connect"'

Bill Kunneke

We finally gave up on it, couldn't get help here or on the web. My suggestion was to stay on Zendesk but ultimately we hacked around the issue by creating a GMail account that auto forwards to the Microsoft account. It's ugly, but it works. Best of luck.

Jack Brickey_h10pa4

This is working fine for me so a bit perplexed as to why it is not for others. @Bill Kunneke and @Allan Libby did you open a support request w/ Atlassian Support?

Allan Libby

Not yet, that is the next step.

Bill Kunneke

I did open a ticket with Atlassian Support and it didn't get resolved. The funny thing is, we carved out all this time to test Service Desk and never in my wildest dreams would I have thought that connecting to a mail service would take more than 5 minutes. Hours of work over the last few months though has not gotten me a single step closer. Someone on the team hacked a work around, it'll have to do but it baffles me why Office 365 email would be so problematic.

Jack Brickey_h10pa4

If memory serves it only took 5m for us. Define a new O365 email, enter it into the project emails configuration and attach to a request type. I will look at how the email is configured in O365 and comment back here. If possible could you post screenshots of your project config email screen?

Allan Libby

Those are the exact settings I have as well. I am asking our host to make sure port 993 is allowed out to the microsoft IP range.

IT-Support COI

Same problem here and only with o365. Atlassian plz help!

Allan Libby

We are still trying to get time with our security officer to make sure traffic on port 993 is being allowed out to the O365 IP ranges. I'd suggest doing the same to rule that out. If you do, please let us know if that worked for future generations to be able to solve the problem ;-)

Matt Doar_tzgiej

Not all 0365 accounts enable IMAP access.

IT-Support COI

Hello Matt,thanks for your quick reply. I already checked if IMAP is enabled, it is. And of course I tried POP and SMTPI tried to send a mail via Jira, I get an authentication error. Interesting is the DEBUG

Message at the end:DEBUG SMTP: need username and password for authentication
DEBUG SMTP: protocolConnect returning false, host=outlook.office365.com, user=jira, password=<null>

Why "user=jira" and pass "null"?

Check my attachemts, I inserted the correct credentials.

Here is the complete log:

An error has occurred with sending the test email:
com.atlassian.mail.MailException: com.sun.mail.util.MailConnectException: Couldn't connect to host, port: outlook.office365.com, 25; timeout 10000;
  nested exception is:
    java.net.ConnectException: Verbindungsaufbau abgelehnt

DEBUG: getProvider() returning javax.mail.Provider[TRANSPORT,smtp,com.sun.mail.smtp.SMTPTransport,Oracle]
DEBUG SMTP: need username and password for authentication
DEBUG SMTP: protocolConnect returning false, host=outlook.office365.com, user=jira, password=<null>
DEBUG SMTP: useEhlo true, useAuth true
DEBUG SMTP: trying to connect to host "outlook.office365.com", port 25, isSSL false

Allan Libby

We just solved this by allowing outgoing traffic on port 993 to the outlook ip ranges as listed in this microsoft article:

https://docs.microsoft.com/en-us/office365/enterprise/urls-and-ip-address-ranges

Jack Brickey_h10pa4

Thanks for sharing here @Allan Libby

IT-Support COI

Allan, thanks for your reply. I'll test it soon, I'm currently on holiday.

IT-Support COI

Jack, thanks for your reply. I'll test it soon, I'm currently on holiday.

Peter Hamilton-Harding

-Must not be a shared mailbox

hewi

I had the same problem and none of the answers above helped me.

I verified that my jira server had port 993 access to O365, so that wasn't the issue. The test email from jira went through when the email settings were entered, so I knew that wasn't an issue.

It turned out to be something silly in the scheme of things - under "Global Mail Settings" in the System configuration, "Email puller" and "Email processor" were both turned off.

Within a few minutes of enabling these, the incoming mail was parsed by Jira and added into the queue as I expected.

Dawn Fama

Shouldn't your SMTP be a gateway host on your network, not office365 domain?

I had similar issues connecting JIRA to O365 and it turned out to be a security policy. When I requested the mailbox to be created, I had to specify I needed it to be imaps (secure IMAP enabled) so they would add the account to the correct exception group.

robc_91zdbx

Office 365. Local firewall ports are irrelevant. Office 365 also supports IMAPS out of the box. Since we use SSO and MFA I created an APP password for our service account and we always get Authentication errors. We have used this same setup with other providers without issue.

Andy cashen

Newbie here I am just setting our company emails but it says you have to verify your domains in Jira. Assuming that people with issues had done this ?

Matthew Alexander_8e12f4

I hate to necro this but I've seen other recent posts on this thread and wanted to say that this was the solution for me. Easy and simple using these configuration settings, thanks!

Ilia Fonariov

I'm going to add as well that after migrating to Office 365, we were unable to see Full Name of user who triggered a Jira notification, and this comment helped resolve the issue as well!

We were using

Host name: outlook.office365.com

SMTP Port: 587

Emails came in, but just said "JIRA" for all of them. After updating the port to Peter's suggestion above as well as the Hostname, now the emails are displaying the full name of user.

Thanks!

David Pressley_564gxx

We banged our heads against a wall with all possible combinations, and in the end, realized that we were referencing our tenant, when it should have been:

outlook.office65.com
SMTP: 587
username + password

Vikash Kumar_0pzbj4

Putting it here for your help : we are changing basic authentication to oauth2.0 for Jira ServiceDesk project --> Email setting.

What would be the behavior for this change?

Will it read/process all the emails from the mailbox including older and already processed ones (as we are continuing with the same mailbox only changing the authentication mechanism)?

Or it will only read new emails?

Thanks,

Welcome!

It looks like you're new here. Sign in or register to get started.

Quick Links

Find more posts tagged with

jira-service-desk

jira-service-desk-cloud