Configurando um servidor de email SMTP para enviar notificações | Administração Jira aplicativos de Data Center e Servidor 8.21 | Atlassian Documentação

Definir ou editar o servidor de email SMTP

Escolha a Administração ( ) > Sistema.
selecione Correio > correio de saída para abrir a página do servidor de correio SMTP.
Se nenhum servidor de correio SMTP foi definido, então um botão Configurar novo servidor de correio SMTP será mostrado na página. Se um já tiver sido definido, os detalhes do servidor de correio SMTP serão mostrados na página, juntamente com um conjunto de links de operação à direita.
clique no botão Configurar novo servidor de correio SMTP para definir um novo servidor de correio SMTP ou no link Editar à direita para editar o servidor de correio SMTP existente, que abrirá a página Adicionar / atualizar servidor de correio SMTP.

Completa a seção superior da página como segue:

Nome	Especifique um nome arbitrário para identificar este servidor de email SMTP de configuração.
Descrição	(Opcional) Especifique uma descrição arbitrário que descreve o servidor de email SMTP. Esta descrição aparece abaixo do nome do servidor de correio SMTP na página de configuração do servidor de correio SMTP.
do endereço	especifique o endereço de E-mail usado no campo ‘Endereço do remetente’ (ou ‘de’) das mensagens de notificação enviadas pelo Jira, a menos que seja substituído em uma configuração de projeto. especifique apenas um endereço de E-mail para este campo (por exemplo, `[email protected]`). O Jira usará esse valor para construir o cabeçalho ‘from’ completo com base no usuário atual (`"Joe Bloggs (Jira) <[email protected]>"`). para alterar o cabeçalho’ de’, Vá para administração > sistema > Configuração Geral e (em Configurações), edite o e-mail do campo.
prefixo de E-mail	especifique o assunto dos E-mails enviados deste servidor usará esta string como um prefixo. Isso é útil para seus usuários para que eles possam filtrar notificações por e-mail do Jira com base nesse prefixo.

Screenshot: Adicionar (ou atualizar) servidor de correio SMTP

Adicionar Página do servidor de correio SMTP.

especifique um nome de host ou local JNDI para o seu servidor de correio SMTP

a segunda parte da página Adicionar/atualizar servidor de correio SMTP especifica os detalhes do servidor do servidor de correio SMTP para o qual o Jira enviará correio. Existem duas maneiras de fazer isso. Ou:

especifique os detalhes do host SMTP do seu servidor de email SMTP;
ou:
especifique o local JNDI de um objeto javax.mail.Session – ou seja, use JNDI para procurar um servidor de email SMTP que você pré-configurou em seu servidor de aplicativos. Isso tem as seguintes vantagens:
- melhor segurança: os detalhes do email não estão disponíveis para os administradores do Jira por meio da interface de administração do Jira e não são armazenados em arquivos de backup do Jira.
- Mais opções SMTP: por exemplo, você pode alternar para RSET em vez de NOOP para testar conexões definindo a propriedade mail.smtp.userset.
- gestão centralizada: os detalhes do E-mail são configurados no mesmo local que os detalhes do banco de dados e podem ser configurados por meio de suas ferramentas de administração do servidor de aplicativos.

especifique os detalhes do host SMTP

a maioria das pessoas configura o servidor de email SMTP do Jira especificando os detalhes do host SMTP deste servidor de email diretamente no Jira.

na seção host SMTP da página Add/Update SMTP Mail Server (acima), preencha os seguintes campos de formulário:

Provedor de Serviço (não disponível quando atualizar um servidor de correio SMTP)	Escolher entre usar seu próprio servidor de email SMTP (i.e. Personalizado), ou Gmail (i.e. o Google Apps Email / Gmail), Yahoo! (ou seja, Yahoo! Mail Plus) como o provedor de serviços para o seu servidor de email SMTP. se você escolher Gmail ou Yahoo! opções e, em seguida, volte para Personalizado, alguns dos campos-chave nesta seção serão preenchidos automaticamente com as configurações relevantes do servidor de email SMTP para esses provedores de serviços.
Protocolo	escolha entre se o seu servidor de correio SMTP é um padrão (ou seja, SMTP) ou um seguro (ou seja, SECURE_SMTP).
nome do anfitrião	especifique o nome do host ou o endereço IP do seu servidor de email SMTP. Exemplo. `smtp.yourcompany.com`
Porta SMTP	(Opcional) O número da porta SMTP, normalmente de 25 para SMTP ou 465 para SMTPS, qualquer um dos quais presume-se se este campo for deixado em branco.
tempo de espera	(Opcional) Especifique o período de tempo limite em milissegundos, que é tratada como 10000 se este campo for deixado em branco. Especificar 0 ou um valor negativo aqui resultará em Jira esperando indefinidamente que o servidor SMTP responda.
TLS	(opcional) Marque esta caixa de seleção se o host SMTP usar o protocolo Transport Layer Security (TLS).
nome de usuário	(Opcional) Se o seu host SMTP requer autenticação, especifique o nome de usuário de autenticação de credenciais aqui. (A maioria dos servidores da empresa requer autenticação para retransmitir e-mails para usuários não locais.)
Password	(opcional) novamente, se seu host SMTP exigir autenticação, spcify a senha associada ao nome de usuário especificado acima. ao editar um servidor de email SMTP existente, marque a caixa de seleção Alterar senha para acessar e alterar este campo.

(aviso) por Favor, note:

Se o seu servidor de inicialização do script usa o -Dmail propriedades do sistema (e.g. mail.smtp.host ou mail.smtp.port), eles substituem as configurações que você especificar no formulário acima. Além disso, se necessário, você pode especificar manualmente o nome do host que o Jira se reporta ao servidor SMTP definindo -Dmail.smtp.localhost
o SMTP deve suportar o tipo de conteúdo de várias partes. Sem este e-mails não será capaz de enviar.

(opcional) clique no botão de conexão de teste para verificar se o Jira pode se comunicar com o servidor de email SMTP que você acabou de configurar.
clique no botão Adicionar (ou atualizar) para salvar a configuração do servidor de email SMTP do Jira.

especifique uma ‘localização JNDI’

como uma alternativa para especificar detalhes do host SMTP diretamente no Jira, você pode configurá-los em seu servidor de aplicativos e, em seguida, procurar uma sessão de E-mail pré-configurada via JNDI.

na seção JNDI Location da página Add/Update SMTP Mail Server (acima), especifique a localização de um objeto javax.mail.Session a ser usado ao enviar e-mail, no campo JNDI Location. Isso começará com o prefixo java:comp/env/

Configurando um local JNDI

o local JNDI especificado no Jira dependerá do servidor de aplicativos e da configuração do Jira. Os locais JNDI são normalmente configurados no servidor de aplicativos que executa o Jira. Portanto, o Jira precisará ser reiniciado após configurar um local JNDI para que essa configuração esteja disponível no Jira.

Por exemplo, no Tomcat 6 (o servidor de aplicativos empacotados com ‘recomendado’ distribuições do Jira), o JNDI Local seria java:comp/env/mail/JiraMailServer e adicione a seção a seguir ao conf/server.xml do seu Jira aplicação diretório de instalação, dentro do <Context/> nó:

<Context path="" docBase="${catalina.home}/atlassian-jira" reloadable="false"> ... <Resource name="mail/JiraMailServer" auth="Container" type="javax.mail.Session" mail.smtp.host="mail.yourcompany.com" mail.smtp.port="25" mail.transport.protocol="smtp" mail.smtp.auth="true" mail.smtp.user="jirauser" password="mypassword" /> ...</Context>

Ou se você não requerem autenticação (por exemplo, se você estiver enviando via localhost, ou apenas internamente dentro da empresa):

<Context path="" docBase="${catalina.home}/atlassian-jira" reloadable="false"> ... <Resource name="mail/JiraMailServer" auth="Container" type="javax.mail.Session" mail.smtp.host="localhost" mail.smtp.port="25" mail.transport.protocol="smtp" /> ...</Context>

se você estiver executando o Jira em um servidor de aplicativos diferente do Apache Tomcat (que não é uma configuração JIRA suportada), uma metodologia semelhante para configurar um local JNDI para seu servidor de email SMTP deve ser aplicada a esse servidor de aplicativos.

se você tiver problemas de conexão, adicione um parâmetro mail.debug="true" ao elemento <Resource/>(acima), que permitirá que você veja os detalhes de ‘depuração’ no nível SMTP ao testar a conexão.

Mova as Classes JavaMail

você também precisará garantir que as classes JavaMail (normalmente em arquivos da biblioteca JAR) estejam presentes no classpath do seu servidor de aplicativos e que elas não entrem em conflito com os arquivos da biblioteca JAR do Jira. Isso é necessário porque o próprio servidor de aplicativos (não o Jira) está estabelecendo a conexão SMTP e, como tal, o servidor de aplicativos não pode ver os arquivos da biblioteca JAR no classloader do Jira.

alguns sistemas operacionais podem agrupar as classes JavaMail com servidores de aplicativos (por exemplo, Tomcat no Red Hat Enterprise Linux). Este poderá entrar em conflito com o Jira cópia do JavaMail classes, resultando em erros como:

java.lang.NoClassDefFoundError: javax/mail/Authenticator

ou:

java.lang.IllegalArgumentException: Mail server at location is not of required type javax.mail.Session.

mais leve servidores de aplicativo, como o Apache Tomcat (incluindo um incorporadas a ‘recomendado’ distribuições do Jira), não vêm sempre com JavaMail.

para evitar conflitos, verifique o diretório lib/ do seu servidor de aplicativos:

se o servidor de aplicativos já contiver mail-1.4.1.jar e activation-1.1.1.jar, basta remover mail-1.4.1.jar e activation-1.1.1.jar do subdiretório <jira-application-dir>/WEB-INF/lib/ do Diretório de instalação do aplicativo Jira.
Se o servidor de aplicação não contém mail-1.4.1.jar e activation-1.1.1.jar e, em seguida, mova o mail-1.4.1.jar e activation-1.1.1.jar a partir do <jira-application-dir>/WEB-INF/lib/ subdiretório do Jira aplicativo de instalação para o directório a lib/ subdiretório do Jira diretório de instalação (por ‘recomendado’ distribuições do Jira) ou o lib/ subdiretório do servidor de aplicativos que executa o Jira.

SMTP sobre SSL

você pode criptografar as comunicações de E-mail entre o Jira e seu servidor de E-mail via SSL, desde que seu servidor de E-mail suporte SSL.

em primeiro lugar, você precisará importar o certificado do servidor SMTP para um keystore Java. O processo é descrito na página configurando uma conexão SSL para o Active Directory.

(aviso) Nota importante: sem importar o certificado, o Jira não poderá se comunicar com seu servidor de email.

em segundo lugar, edite suas propriedades de conexão do servidor de email e especifique starttls e SSLSocketFactory. De {$Jira_INSTALL}/conf/server.xml( este exemplo usa o servidor do Gmail):

<Resource name="mail/GmailSmtpServer" auth="Container" type="javax.mail.Session" mail.smtp.host="smtp.gmail.com" mail.smtp.port="465" mail.smtp.auth="true" mail.smtp.user="[email protected]" password="mypassword" mail.smtp.starttls.enable="true" mail.smtp.socketFactory.class="javax.net.ssl.SSLSocketFactory"/>

solução de problemas

uma dica útil para depurar problemas relacionados a email no Jira é definir a propriedade -Dmail.debug=true na inicialização. Isso fará com que os detalhes no nível do protocolo das interações de E-mail do Jira sejam registrados. Além disso, aumentar o nível de log do JIRA mostrará quando o serviço está em execução e como os e-mails são processados.

problemas comuns

se o Jira não parece estar criando ou enviando e-mails ou criando problemas e comentários de E-mail, sua instalação do Jira pode estar enfrentando erros OutOfMemory. Por favor, verifique seus arquivos de log para erros OutOfMemory. Se houver erros OutOfMemory, reinicie o Jira e investigue os erros.
se você encontrar alguns e-mails recebidos simplesmente desaparecer, verifique se você não iniciou acidentalmente uma segunda cópia do Jira (por exemplo. em um ambiente de teste) que está baixando e excluindo mensagens de E-mail. Consulte a página restaurar dados para sinalizadores que você deve definir para evitar que o e-mail seja processado.
se você receber erros’ mail Relay’, certifique-se de ter especificado o nome de usuário e senha na seção SMTP Host da página de configuração do servidor de email SMTP do Jira.

obter ajuda

se você não puder resolver um problema sozinho, crie um caso de suporte no projeto ‘Jira’ e ajudaremos.

Administração Jira Suporte de aplicações