Definer Eller rediger SMTP-e-postserveren
- Velg Administrasjon () > System.
- Velg Mail > Utgående E-Post for å åpne SIDEN smtp-E-Postserver.
Hvis INGEN SMTP-e-postserver er definert, vises En Konfigurer ny SMTP-e-postserver på siden. Hvis man allerede er definert, VIL smtp-postserverens detaljer bli vist på siden, sammen med et sett med operasjonskoblinger til høyre. -
Klikk Enten Konfigurer ny SMTP-e-postserver for å definere en ny SMTP-e-postserver, Eller Rediger-koblingen til høyre for å redigere den eksisterende SMTP-e-postserveren, som åpner Siden Legg Til / Oppdater SMTP-E-Postserver.
-
Fullfør den øverste delen av denne siden som følger:
Navn
Angi et vilkårlig navn for å identifisere denne smtp-e-postserverkonfigurasjonen.
Beskrivelse
(Valgfritt) Angi en vilkårlig beskrivelse som beskriver SMTP-e-postserveren. Denne beskrivelsen vises under Navnet PÅ SMTP-e-postserveren PÅ KONFIGURASJONSSIDEN for smtp-E-Postserveren.
fra adresse
Angi e-postadressen som brukes i feltet’ avsenderadresse ‘(eller’ fra’) i varslingsmeldinger sendt Av Jira, med mindre det overstyres i en prosjektkonfigurasjon.
angi bare en e-postadresse for dette feltet (f.eks.[email protected]
). Jira vil bruke denne verdien til å konstruere hele’ fra ‘ header basert på gjeldende bruker ("Joe Bloggs (Jira) <[email protected]>"
).
for å endre ‘ fra ‘ – overskriften, gå Til Administrasjon > System > Generell Konfigurasjon og (under Innstillinger), rediger e-post fra-feltet.E-post prefiks
Angi emnet for e-post sendt fra denne serveren vil bruke denne strengen som prefiks. Dette er nyttig for brukerne dine, slik at De kan filtrere e-postvarsler Fra Jira basert på dette prefikset.
Skjermbilde: Legg TIL (Eller Oppdater) SMTP-E-Postserver
Angi et vertsnavn eller en jndi-plassering for SMTP-e-postserveren
den andre delen av Siden Legg Til/Oppdater SMTP-E-Postserver angir Serverdetaljene FOR SMTP-e-postserveren Som Jira vil sende e-post til. Det er to måter du kan gjøre dette. Enten:
- angi DETALJENE FOR smtp-verten FOR SMTP – e-postserveren;
eller: - angi jndi-plasseringen til et objekt
javax.mail.Session
– det vil si at DU bruker JNDI til å slå opp EN SMTP-e-postserver som du har forhåndskonfigurert i programserveren. Dette har følgende fordeler:- Bedre sikkerhet: e-postdetaljene er ikke tilgjengelige For jira-administratorer via jira-administrasjonsgrensesnittet og lagres ikke I jira-sikkerhetskopieringsfiler.
- Flere SMTP-alternativer: for eksempel kan du bytte TIL RSET i stedet FOR NOOP for testing av tilkoblinger ved å sette egenskapen
mail.smtp.userset
. - Sentralisert administrasjon: e-postdetaljer konfigureres på samme sted som databasedetaljer, og kan konfigureres via administrasjonsverktøyene for applikasjonsserveren.
Angi detaljene FOR smtp-verten
De fleste konfigurerer Jiras SMTP – e-postserver ved å angi DETALJENE FOR smtp-verten for denne e-postserveren direkte i Jira.
-
fyll ut følgende skjemafelt i DELEN smtp-vert På Siden Legg TIL/Oppdater Smtp-E-Postserver (ovenfor):
Tjenesteleverandør
(ikke tilgjengelig når du oppdaterer en eksisterende SMTP-e-postserver)Velg mellom å bruke DIN EGEN SMTP-postserver( Dvs. Tilpasset), Eller Enten Gmail (Dvs. Google Apps Mail / Gmail) eller Yahoo! (Dvs. Yahoo! Mail Plus) som tjenesteleverandør for SMTP-e-postserveren din.
Hvis Du velger Enten Gmail eller Yahoo! alternativer og deretter bytte tilbake Til Egendefinert, fylles noen av nøkkelfeltene i denne delen automatisk ut med de relevante smtp-e-postserverinnstillingene for disse tjenesteleverandørene.Protokoll Velg mellom OM SMTP-postserveren din er en standard (dvs. SMTP) eller en sikker (DVS.SECURE_SMTP ) en.
Vertsnavn
Angi vertsnavnet ELLER IP-adressen TIL SMTP-e-postserveren. F. eks.
smtp.yourcompany.com
SMTP-Port
(Valgfritt) SMTP-portnummeret, vanligvis 25 FOR SMTP eller 465 FOR SMTPS, som enten antas hvis dette feltet er tomt.
Timeout
(Valgfritt) Angi tidsavbruddsperioden i millisekunder, som behandles som 10000 hvis dette feltet er tomt. Angi 0 eller en negativ verdi her vil resultere I Jira venter på ubestemt TID FOR SMTP-serveren til å svare.
TLS
(Valgfritt) Merk av i denne boksen hvis smtp-verten bruker Tls-protokollen (Transport Layer Security).
Brukernavn
(Valgfritt) hvis SMTP-verten krever godkjenning, angir du brukernavnet for disse godkjenningslegitimasjonene her. (De fleste bedriftsservere krever godkjenning for å videresende e-post til ikke-lokale brukere.)
Passord *
( Valgfritt) Igjen, hvis SMTP-verten krever godkjenning, spcify passordet knyttet til brukernavnet du angav ovenfor.
når du redigerer en eksisterende smtp-e-postserver, merker Du Av For Endre Passord for å få tilgang til og endre dette feltet.vær oppmerksom:
-
hvis serverens oppstartsskript bruker systemegenskapene
-Dmail
(f.eks.mail.smtp.host
ellermail.smtp.port
), overstyrer de innstillingene du angir i skjemaet ovenfor. I tillegg kan du manuelt angi vertsnavnet Som jira rapporterer seg selv TIL SMTP-serveren ved å angi-Dmail.smtp.localhost
- SMTP-EN må støtte innholdstypen for flere deler. Uten denne posten vil ikke kunne sende.
-
- (Valgfritt) Klikk På Test Connection-knappen for å sjekke At Jira kan kommunisere MED SMTP-e-postserveren du nettopp har konfigurert.
- Klikk På Legg til (Eller Oppdater) – knappen for å lagre jiras SMTP-serverkonfigurasjon.
Angi En ‘Jndi-Plassering’
som et alternativ til å angi SMTP-vertsdetaljer direkte i Jira, kan du konfigurere DEM i applikasjonsserveren, og deretter slå opp en forhåndskonfigurert e-postøkt via JNDI.
i Delen Jndi-Plassering På Siden Legg Til/Oppdater Smtp-E-Postserver (ovenfor) angir du plasseringen til et javax.mail.Session
– objekt som skal brukes når du sender e-post, I Feltet Jndi-Plassering. Dette begynner med prefikset java:comp/env/
Konfigurere en jndi-plassering
Jndi-Plasseringen du angir I Jira, avhenger Av jiras applikasjonsserver og konfigurasjon. Jndi-plasseringer konfigureres vanligvis i programserveren som kjører Jira. Derfor Må Jira startes på nytt etter at du har konfigurert en jndi-plassering for at konfigurasjonen skal være tilgjengelig I Jira.
For Eksempel I Tomcat 6 (applikasjonsserveren som er buntet med ‘anbefalte’ distribusjoner Av Jira), VIL JNDI-Plasseringen være java:comp/env/mail/JiraMailServer
og du vil legge til følgende avsnitt i conf/server.xml
I jira application installation directory, inne i <Context/>
node:
<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>
eller hvis du ikke krever godkjenning (f. eks. hvis du sender via localhost, eller bare internt i selskapet):
<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>
hvis Du kjører Jira på en annen applikasjonsserver Enn Apache Tomcat (som ikke er en Støttet jira-konfigurasjon), bør en lignende metode for å konfigurere en jndi-plassering til SMTP-postserveren gjelde for den applikasjonsserveren.
hvis du har problemer med å koble til, legg til en mail.debug="true"
parameter til <Resource/>
– elementet (over), som lar DEG se smtp-nivå ‘debugging’ detaljer når du tester tilkoblingen.
Flytt JavaMail-Klassene
Du må også sørge for At JavaMail-klassene (vanligvis i jar-bibliotekfiler) er til stede i applikasjonsserverens klassebane, og at disse ikke er i konflikt med Jiras JAR-bibliotekfiler. Dette er nødvendig fordi applikasjonsserveren selv (ikke Jira) etablerer SMTP-tilkoblingen, og som sådan kan applikasjonsserveren ikke se jar-bibliotekfilene i jiras classloader.
Noen operativsystemer kan pakke JavaMail-klassene med applikasjonsservere (For Eksempel Tomcat I Red Hat Enterprise Linux). Dette kan komme I konflikt Med jiras kopi Av JavaMail-klassene, noe som resulterer i feil som:
java.lang.NoClassDefFoundError: javax/mail/Authenticator
eller:
java.lang.IllegalArgumentException: Mail server at location is not of required type javax.mail.Session.
Lettere applikasjonsservere Som Apache Tomcat (inkludert den som er innlemmet I De anbefalte distribusjonene Av Jira), kommer ikke alltid Med JavaMail.
sjekk programserverens lib/
katalog for å unngå konflikter:
- hvis applikasjonsserveren allerede inneholder
mail-1.4.1.jar
ogactivation-1.1.1.jar
, fjerner du baremail-1.4.1.jar
ogactivation-1.1.1.jar
fra underkatalogen<jira-application-dir>/WEB-INF/lib/
I installasjonsmappen For jira-programmet. - hvis programserveren ikke inneholder
mail-1.4.1.jar
ogactivation-1.1.1.jar
, flytter dumail-1.4.1.jar
ogactivation-1.1.1.jar
fra<jira-application-dir>/WEB-INF/lib/
– underkatalogen I jira-programinstallasjonsmappen tillib/
– underkatalogen I jira-installasjonsmappen (for’ anbefalte ‘ distribusjoner Av Jira) ellerlib/
– underkatalogen på programserveren som kjører Jira.
SMTP OVER SSL
du kan kryptere e-postkommunikasjon Mellom Jira og e-postserveren via SSL, forutsatt at e-postserveren støtter SSL.
for Det Første må DU importere smtp-serversertifikatet til En Java keystore. Prosessen er beskrevet På Siden Konfigurere EN SSL-tilkobling Til Active Directory.
Viktig Merknad: Uten å importere sertifikatet, Vil Jira ikke kunne kommunisere med e-postserveren din.
for Det Andre redigerer du e-postserverens tilkoblingsegenskaper og angir starttls
og SSLSocketFactory
. Fra {$Jira_INSTALL}/conf/server.xml
(dette eksemplet bruker Gmail-serveren):
<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"/>
Feilsøking
et nyttig tips for feilsøking av e-postrelaterte problemer I Jira er å sette egenskapen -Dmail.debug=true
ved oppstart. Dette vil føre til at protokollnivådetaljer Om Jiras e-postinteraksjoner blir logget. I tillegg vil det å skru OPP jiras loggnivå vise når tjenesten kjører og hvordan e-post behandles.
Vanlige Problemer
- Hvis Jira ikke ser ut til å opprette eller sende e-post Eller opprette problemer og kommentarer fra e-post, Kan det hende at jira-installasjonen din har Feil i Minnet. Vennligst sjekk loggfilene for OutOfMemory feil. Hvis Det er OutOfMemory feil, kan du starte Jira og undersøke feilene.
- hvis du finner noen innkommende e-poster bare forsvinne, sjekk at du ikke har ved et uhell startet en ny kopi Av Jira(f. eks. i et staging miljø) som laster ned og sletter e-postmeldinger. Se Siden Gjenoppretting av data for flagg du bør angi for å hindre at e-post behandles.
- hvis Du mottar Mail Relay-feil, må Du kontrollere At Du har angitt Brukernavn og Passord I DELEN Smtp-Vert på konfigurasjonssiden For Jira smtp-E-Postserveren.
Få Hjelp
hvis du ikke kan løse et problem selv, kan du opprette en støttesak i ‘Jira’ – prosjektet, så hjelper Vi deg.