Configurarea unui server de mail SMTP pentru a trimite notificări / administrarea Centrului de date Jira applications și a serverului 8.21 / Atlassian Documentation

definiți sau editați serverul de mail SMTP

alegeți sistemul administrare ( ) >.
selectați Mail > e-mail de ieșire pentru a deschide pagina serverului de e-mail SMTP.
dacă nu a fost definit niciun server de e-mail SMTP, atunci pe pagină va fi afișat un buton Configure new SMTP mail server. Dacă unul a fost deja definit, atunci detaliile serverului de e-mail SMTP vor fi afișate pe pagină, împreună cu un set de legături de operare din dreapta.
Faceți clic fie pe butonul Configure New SMTP mail server pentru a defini un nou server de mail SMTP, fie pe linkul Edit din dreapta pentru a edita serverul de mail SMTP existent, care va deschide pagina Add/Update SMTP Mail Server.

completați secțiunea de sus a acestei pagini după cum urmează:

nume	specificați un nume arbitrar pentru a identifica această configurație a serverului de e-mail SMTP.
descriere	(opțional) specificați o descriere arbitrară care descrie serverul de e-mail SMTP. Această descriere apare sub numele serverului de e-mail SMTP pe pagina de configurare a serverului de e-mail SMTP.
de la adresa	specificați adresa de e-mail utilizată în câmpul ‘sender address’ (sau ‘from’) Al mesajelor de notificare trimise de Jira, cu excepția cazului în care este suprascrisă într-o configurație de proiect. specificați doar o adresă de e-mail pentru acest câmp (de exemplu, `[email protected]`). Jira va folosi această valoare pentru a construi antetul complet ‘from’ bazat pe utilizatorul curent (`"Joe Bloggs (Jira) <[email protected]>"`). pentru a schimba antetul ‘from’, accesați administrare > sistem > Configurare generală și (în Setări), editați câmpul Email from.
prefix de e-mail	specificați subiectul e-mailurilor trimise de pe acest server va folosi acest șir ca prefix. Acest lucru este util pentru utilizatorii dvs., astfel încât aceștia să poată filtra notificările prin e-mail de la Jira pe baza acestui prefix.

captură de ecran: Adăugați (sau actualizați) serverul de e-Mail SMTP

Adăugați pagina serverului de e-mail SMTP.

specificați un nume de gazdă sau o locație JNDI pentru serverul dvs. de e-mail SMTP

a doua parte a paginii Adăugare/actualizare server de e-mail SMTP specifică detaliile serverului serverului de e-mail SMTP către care Jira va trimite e-mailuri. Există două moduri în care puteți face acest lucru. Fie:

specificați detaliile gazdei SMTP ale serverului dvs. de e-mail SMTP;
sau:
specificați locația JNDI a unui obiect javax.mail.Session — adică utilizați JNDI pentru a căuta un server de e-mail SMTP pe care l-ați preconfigurat în serverul de aplicații. Aceasta are următoarele avantaje:
- securitate mai bună: detaliile de e-mail nu sunt disponibile administratorilor Jira prin interfața de administrare Jira și nu sunt stocate în fișierele de rezervă Jira.
- mai multe opțiuni SMTP: de exemplu, puteți trece la RSET în loc de NOOP pentru testarea conexiunilor prin setarea proprietății mail.smtp.userset.
- managementul centralizat: detaliile de e-mail sunt configurate în același loc cu detaliile bazei de date și pot fi configurate prin instrumentele de administrare a serverului de aplicații.

specificați detaliile gazdei SMTP

majoritatea persoanelor configurează serverul de poștă SMTP Jira specificând detaliile gazdei SMTP ale acestui server de poștă direct în Jira.

în secțiunea gazdă SMTP din pagina Adăugare / actualizare server de Mail SMTP (de mai sus), completați următoarele câmpuri de formular:

furnizor de servicii (nu este disponibil la actualizarea unui server de mail SMTP existent)	Alegeți între utilizarea propriului server de e-mail SMTP (adică personalizat) sau Gmail (adică Google Apps Mail / Gmail) sau Yahoo! (adică Yahoo! Mail Plus) ca furnizor de servicii pentru serverul dvs. de e-mail SMTP. daca alegi Gmail sau Yahoo! opțiuni și apoi reveniți la Personalizat, unele dintre câmpurile cheie din această secțiune vor fi populate automat cu setările relevante ale serverului de e-mail SMTP pentru acești furnizori de servicii.
Protocol	alegeți dacă serverul dvs. de e-mail SMTP este un standard (adică SMTP) sau unul securizat (adică SECURE_SMTP).
Nume gazdă	specificați numele de gazdă sau adresa IP a serverului dvs. de e-mail SMTP. Eg. `smtp.yourcompany.com`
portul SMTP	(opțional) numărul portului SMTP, de obicei 25 pentru SMTP sau 465 pentru SMTPS, oricare dintre acestea fiind asumate dacă acest câmp este lăsat necompletat.
Timeout	(opțional) specificați perioada de expirare în milisecunde, care este tratată ca 10000 dacă acest câmp este lăsat necompletat. Specificarea 0 sau o valoare negativă aici va duce la Jira așteptare pe termen nelimitat pentru serverul SMTP pentru a răspunde.
TLS	(opțional) Bifați această casetă de selectare dacă gazda SMTP utilizează protocolul Transport Layer Security (TLS).
Nume utilizator	(opțional) dacă gazda SMTP necesită autentificare, specificați numele de utilizator al acestor acreditări de autentificare aici. (Majoritatea serverelor companiei necesită autentificare pentru a transmite e-mail utilizatorilor non-locali.)
parolă	(opțional) din nou, dacă gazda SMTP necesită autentificare, spcify parola asociată cu numele de utilizator specificat mai sus. când editați un server de mail SMTP existent, bifați caseta de selectare Modificare parolă pentru a accesa și modifica acest câmp.

(atenție) vă rugăm să rețineți:

Dacă scriptul de pornire al serverului dvs. utilizează proprietățile sistemului -Dmail (de exemplu, mail.smtp.host sau mail.smtp.port), acestea vor suprascrie setările pe care le specificați în formularul de mai sus. În plus, dacă este necesar, puteți specifica manual numele gazdei pe care Jira îl raportează cu privire la serverul SMTP prin setarea -Dmail.smtp.localhost
SMTP trebuie să accepte tipul de conținut multipart. Fără aceste e-mailuri nu vor putea trimite.

(opțional) Faceți clic pe butonul Test Connection pentru a verifica dacă Jira poate comunica cu serverul de e-mail SMTP pe care tocmai l-ați configurat.
Faceți clic pe butonul Adăugare (sau actualizare) pentru a salva configurația serverului de e-mail SMTP Jira.

specificați o ‘locație JNDI’

ca alternativă la specificarea detaliilor gazdei SMTP direct în Jira, le puteți configura în serverul de aplicații și apoi puteți căuta o sesiune de e-mail preconfigurată prin JNDI.

în secțiunea Locație JNDI din pagina Adăugare/actualizare server de e-mail SMTP (de mai sus), specificați locația unui obiect javax.mail.Session de utilizat la trimiterea e-mailului, în câmpul Locație JNDI. Aceasta va începe cu prefixul java:comp/env/

configurarea unei locații JNDI

locația JNDI pe care o specificați în Jira va depinde de serverul de aplicații și de configurația Jira. Locațiile JNDI sunt de obicei configurate în serverul de aplicații care rulează Jira. Prin urmare, Jira va trebui să fie repornit după configurarea unei locații JNDI pentru ca acea configurație să fie disponibilă în Jira.

de exemplu, în Tomcat 6 (serverul de aplicații la pachet cu distribuțiile ‘recomandate’ ale Jira), locația dvs. JNDI ar fi java:comp/env/mail/JiraMailServer și ați adăuga următoarea secțiune la conf/server.xml din Directorul de instalare a aplicației Jira, în interiorul nodului <Context/> :

<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>

sau dacă nu aveți nevoie de autentificare (de exemplu, dacă trimiteți prin localhost sau numai intern în cadrul companiei):

<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>

dacă se întâmplă să rulați Jira pe un server de aplicații altul decât Apache Tomcat (care nu este o configurație Jira acceptată), o metodologie similară pentru configurarea unei locații JNDI pe serverul dvs. de e-mail SMTP ar trebui să se aplice acelui server de aplicații.

dacă aveți probleme de conectare, adăugați un parametru mail.debug="true" la elementul <Resource/> (de mai sus), care vă va permite să vedeți detaliile de depanare la nivel SMTP atunci când testați conexiunea.

mutați clasele JavaMail

de asemenea, va trebui să vă asigurați că clasele JavaMail (de obicei în fișierele bibliotecii JAR) sunt prezente în calea classpath a serverului dvs. de aplicații și că acestea nu intră în conflict cu fișierele bibliotecii JAR ale Jira. Acest lucru este necesar deoarece serverul de aplicații în sine (nu Jira) stabilește conexiunea SMTP și, ca atare, serverul de aplicații nu poate vedea fișierele bibliotecii JAR în classloader-ul Jira.

unele sisteme de operare pot grupa clasele JavaMail cu servere de aplicații (de exemplu, Tomcat în Red Hat Enterprise Linux). Acest lucru poate intra în conflict cu copia lui Jira a claselor JavaMail, rezultând erori precum:

java.lang.NoClassDefFoundError: javax/mail/Authenticator

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

serverele de aplicații mai ușoare, cum ar fi Apache Tomcat (inclusiv cel încorporat în distribuțiile recomandate ale Jira), nu vin întotdeauna cu JavaMail.

pentru a preveni orice conflict, verificați directorul lib/ al serverului de aplicații:

dacă serverul de aplicații conține deja mail-1.4.1.jar și activation-1.1.1.jar, atunci eliminați mail-1.4.1.jar și activation-1.1.1.jar din subdirectorul <jira-application-dir>/WEB-INF/lib/ din Directorul de instalare a aplicației Jira.
dacă serverul de aplicații nu conține mail-1.4.1.jar și activation-1.1.1.jar, atunci mutați mail-1.4.1.jar și activation-1.1.1.jar din subdirectorul <jira-application-dir>/WEB-INF/lib/ al directorului de instalare a aplicației Jira în subdirectorul lib/ al directorului de instalare Jira (pentru distribuțiile recomandate ale Jira) sau subdirectorul lib/ al serverului de aplicații care rulează Jira.

SMTP prin SSL

puteți cripta comunicațiile prin e-mail între Jira și serverul dvs. de e-mail prin SSL, cu condiția ca serverul dvs. de e-mail să accepte SSL.

în primul rând, va trebui să importați certificatul serverului SMTP într-un depozit de chei Java. Procesul este descris pe pagina configurarea unei conexiuni SSL la Active Directory.

(atenție) Notă importantă: fără a importa certificatul, Jira nu va putea comunica cu serverul dvs. de e-mail.

în al doilea rând, editați proprietățile conexiunii serverului de e-mail și specificați starttlsși SSLSocketFactory. De la {$Jira_INSTALL}/conf/server.xml (acest exemplu utilizează serverul 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"/>

depanarea

un sfat util pentru depanarea problemelor legate de e-mail în Jira este să setați proprietatea -Dmail.debug=true la pornire. Acest lucru va face ca detaliile la nivel de protocol ale interacțiunilor de e-mail ale Jira să fie înregistrate. În plus, creșterea nivelului jurnalului JIRA va arăta când serviciul rulează și cum sunt procesate e-mailurile.

probleme comune

dacă Jira nu pare să creeze sau să trimită e-mailuri sau să creeze probleme și comentarii din e-mail, instalarea Jira ar putea întâmpina erori OutOfMemory. Vă rugăm să verificați fișierele jurnal pentru erori OutOfMemory. Dacă există erori OutOfMemory, vă rugăm să reporniți Jira și investiga Erorile.
dacă găsiți că unele e-mailuri primite dispar pur și simplu, verificați dacă nu ați început accidental oa doua copie a Jira (de ex. într-un mediu de așteptare) care descarcă și șterge mesajele de e-mail. Consultați pagina de restaurare a datelor pentru steagurile pe care ar trebui să le setați pentru a preveni procesarea corespondenței.
dacă primiți erori ‘Mail Relay’, asigurați-vă că ați specificat numele de utilizator și parola în secțiunea gazdă SMTP a paginii de configurare a serverului de Mail SMTP Jira.

obținerea ajutorului

dacă nu puteți rezolva singur o problemă, creați un caz de asistență în proiectul ‘Jira’ și vă vom ajuta.

administrarea suportului Jira applications