Mobilchange news Obsah dokumentace Uživatelská dokumentace Administrátorská dokumentace Rejstřík pojmů Technická podpora Hledání on-line

Instalace a nastavení SMTP receiveru

Popis

Aplikace SMTPreceiver umožňuje odesílat zprávy ze SMTP serveru přímo na server MobilChange / FaxChange bez nutnosti směrování do POP3 mailboxu. Dále umožňuje klientům či aplikacím odesílat zprávy přímo pomocí protokolu SMTP bez nutnosti komunikace s vlastním SMTP serverem. Pracuje jako proces SMTP_Receiver spouštěný UMS.TaskManagerem.

Jak SMTPreceiver funguje: naslouchá na definované adrese a portu a očekává příchozí zprávy. Jakmile nějakou přijme, zpracuje ji takto:

Takto je možno posílat veškerou poštu přes SMTPreceiver, ten z ní vybírá zprávy typu FAX a/nebo SMS a běžné zprávy předává forward SMTP serveru (tato funkce je dostupná od verze instalačního CD 4-6-05).

Instalace

Nainstalujte MobilChange / FaxChange a při výběru typu gatewaye zvolte SMTP. Při dotazu na POP3 server nechte kolonku prázdnou. Při instalaci MobilChange / FaxChange vám bude nabídnut setup SMTP receiveru, případně jej můžete doinstalovat dodatečně.
Instalační soubory jsou umístěny na CD v adresáři support\smtprcvd\setup\setup.exe
Po spuštění tohoto programu instalátor detekuje FaxChange i MobilChange a v případě potřeby se zeptá, se kterým produktem se má integrovat.
Následuje dotaz na jméno SMTP serveru, od kterého bude receiver přijímat SMS / faxy ke zpracování. Na tomto serveru je možné nastavit přístupová práva jednotlivým uživatelům. SMTP receiver 1
Zadání uživatelského jména a hesla, pod kterým běží služby MobilChange / FaxChange (dialog se objeví jen pokud ještě není nainstalován servis UMS.TaskManager).
Tento účet musí být členem skupiny Administrators - použijte účet pod nímž již běží MobilChange / FaxChange.
Účet lze zadat jako lokální ve tvaru <jméno_serveru\název_účtu> nebo jako doménový ve tvaru <doména\název_účtu>. Doporučujeme používat doménový servisní účet. Toto je nutno mít na zřeteli zejména při instalaci MobilChange / FaxChange) na standalone server.
Pokud zadáte chybně heslo, instalační program na to upozorní.
SMTP receiver 2
Poté se provede instalace a na její závěr se nejprve zobrazí dialog s informací o serveru, na který je SMTPreceiver napojen a kde se nachází log soubor s informacemi o činnosti SMTP receiveru. SMTP receiver 3
Jako poslední se objeví dialog, ve kterém jsou informace o tom, jak dopadla instalace a v případě problémů je vypsán jejich seznam. Po stisku tlačítka Konec je instalace dokončena. SMTP receiver 4

Základní konfigurace:

[HKLM\SOFTWARE\Datasys\UMS\SMTPreceiver]
output_code_page=cp1250 kódová stránka pro výstupní soubory
log_console=EWIT množství zápisů do konzole (v debug režimu).
log_event_log=EW množství zápisů do eventlogu.
log_file=EWIT množství zápisů do file logu, je-li zapnuto.
smtp_port=25 TCP port, na kterém SMTPreceiver "naslouchá"
id_allocated= poslední přidělená ID zprávy. Nastavuje SMTPreceiver.
authentication_lib ProgID COM objektu zajišťujícího autentifikaci klientů
logging_file_name Cesta k logovacímu souboru
thread_priority Priorita pracovních threadů 0 normální -1=nižší, -2=nízká, -15="idle"
thread_num=5 Povolený počet současně připojených klientů
socket_timeout=60 Timeout TCP čtení a zápisu v sekundách
log_rcv_data=0 Logovat přijatá data zprávy. Je aktivní pouze pokud je zvoleno logování trace informací
Úrovně logování: E =error; W =warning; I =info; T =trace

[HKLM\SOFTWARE\Datasys\UMS\SMTPreceiver\clients] - globální seznam klientů, ktreří se smí k smtpreceiveru připojit. Připojení je možné pro klienty, kteří jsou uvedeni v tomto seznamu, nebo některém ze seznamů povolených klientů aplikace
0=localhost Seznam povolených klientů. Na jednom řádku může být více hodnot oddělených "," a může být použito více klíčů.
1=cxhlpsrv,syscae.syscae.cz  
2=192.168.1.0-192.168.1.31,192.168.2.0-192.168.2.255 Zadání rozsahem povolených adres

Konfigurace jednotlivých "aplikací"

[HKLM\SOFTWARE\Datasys\UMS\SMTPreceiver\applications\<jmeno_aplikace>] - konfigurace pro aplikaci jmeno_aplikace
output_folder=D:\FaxChange\mail\in Cesta k adresáři, kam se mají ukládat soubory, které jsou určeny pro tuto aplikaci.
process_attachments=0 Mají se předávat attachmenty? 0 = zahodit
enabled=1 Aplikace je aktivní. 0= nezpracovává se.
format_preference=txt Formát výstupu z aplikace (povoleno txt;eml;mht;htm).
ctl_type=fax typ řídícího souboru ( "sms" nebo "fax")
cmd_tags=SOFTWARE\Datasys\FaxChange\info\smtp_tag Jméno klíče v registry, kde je uložena definice "zavináčových příkazů"
process_anonymous=0 Zpracovat zprávy odeslané  anonymním odesílatelem (typicky doručenky)
process_att_msg=0 Zpracovat přiloženou emailovou zprávu namísto vlastní zprávy
nonstandard_data_terminator=\r\n  .\r\n Nestandardni ukončení dat zprávy

[HKLM\SOFTWARE\Datasys\UMS\SMTPreceiver\applications\<jmeno_aplikace>\clients\nonstandard_data_terminator] - Seznam adres klientů, kteří používají nestandardní  zprávy
0=localhost Seznam klientů. Na jednom řádku může být více hodnot oddělených "," a může být použito více klíčů.
1=cxhlpsrv,syscae.syscae.cz  
2=192.168.1.0-192.168.1.31,192.168.2.0-192.168.2.255 Zadání rozsahem povolených adres

[HKLM\SOFTWARE\Datasys\UMS\SMTPreceiver\applications\<jmeno_aplikace>\clients] - Seznam adres klientů, kteří smí aplikaci použít. Pokud není vyplněno, je aplikace povolena pro všechny klienty
0=localhost Seznam povolených klientů. Na jednom řádku může být více hodnot oddělených "," a může být použito více klíčů.
1=cxhlpsrv,syscae.syscae.cz  
2=192.168.1.0-192.168.1.31,192.168.2.0-192.168.2.255 Zadání rozsahem povolených adres

[HKLM\SOFTWARE\Datasys\UMS\SMTPreceiver\applications\<jmeno_aplikace>\addresses]
addr_re_0=?(P<number>\+?[\d]+)@fax Regulární výraz pro rozsah adres patřících této aplikaci. Další hodnoty mohou být zadány jako "add_re_1" atd.
Uvedený příklad = vše z adresy číslo@fax odpovídá zvoleném filtru.
SMTP=(?:(?P<name>[^/]+)/(?:(?P<company>[^/]+)
/(?:(?P<dept>[^/]+)/)?)?)?(?P<number>[+i]?\d+)@fax$
Jméno, firma, oddělení a faxové číslo získáno z adresy ve tvaru [<jmeno>[/<firma>[/<oddělení>/]]]<faxčíslo>@fax
IMCEAFAX=^IMCEAFAX-(?:(?P<name_imcea>[^_]+)_(?:(?P<company_imcea>[^_]+)
_(?:(?P<dept_imcea>[^_]+)_)?)?)?(?P<number_imcea>[\+i]?\d+)@[^@]+$
Položky:
     telefonní číslo (number_imcea),
     firma (company_imcea)
     oddělení (dept_imcea)
     jméno (name_imcea)
jsou extrahovány a dekódovány z adresního formátu použitým MS Exchange při překladu vlastního adresního formátu do formátu SMTP
UMSDIAL=^IMCEAFAX-(?P<number_imcea>(?:i|\+2B)?(?:[\dx]|\+20|\+28|\+29)+)
  (?:\+05(?P<code_0>[\da-fA-F]{4})\+20(?P<value_0>.*?)(?=\+05))?
  (?:\+05(?P<code_1>[\da-fA-F]{4})\+20(?P<value_1>.*?)(?=\+05))?
  (?:\+05(?P<code_2>[\da-fA-F]{4})\+20(?P<value_2>.*?)(?=@))?
  @[^@]+$
Formát adresy předaný MS Exchange pro zprávu odeslanou pomocí aplikace umsdial.
code_x  obsahuje kod položky, value_x  obsahuje hodnotu položky. Číslo a hodnoty položek jsou dekódovány.

[HKLM\SOFTWARE\Datasys\UMS\SMTPreceiver\applications\<jmeno_aplikace>\from_enabled]
1=.* Regulární výraz. Filtr povolených odesilatelů používající tuto aplikaci.

[HKLM\SOFTWARE\Datasys\UMS\SMTPreceiver\applications\<jmeno_aplikace>\from_disabled]
1=.*@fax$ Regulární výraz. Seznam zakázaných odesilatelů kteří nemají přístup k této aplikaci. Umožňuje filtrování odesilatelů
2=.*@gsm$  

[HKLM\SOFTWARE\Datasys\UMS\SmtpReceiver\applications\<jmeno_aplikace>\ctl_settings]
Speciální nastavení pro konfiguraci vlastností zpráv
system|maxlen = 1 Uloží do CTL souboru do sekce "system" řádek uvedený za znakem |
system|dr = 0
system|no_send_info = 1
system|nomodify = 1
system|priority = normal
system|user_app_id|parse|subject = .*ID:(\d+).* Uloží do do CTL souboru do sekce "system" hodnotu "user_app_id" získanou parsováním pole "subjekt" zprávy daným regulárním výrazem.


[HKLM\SOFTWARE\Datasys\UMS\SMTPreceiver\applications\<jmeno_aplikace>\transform]
Speciální nastavení umožňující transformovat - měnit obsah doručovaných zpráv.

Jména možných tranformací

Jméno transformace (název textové hodnoty v registry) V CTL se přenese do položky
subject system/subject
txt Obsah textového souboru
from/name from/name
from/username from/username
from/email from/email (zpáteční adresa)
from/gateway from/gateway (písmeno gatewaye)
from/smtp from/smtp (užívá se pro účtování SMS/faxu uživateli)

Seznam položek, které mohou vystupovat v substitučním výrazu

Jméno položky Význam
address Adresa předaná v MAIL FROM:
app Jméno aplikace
format Formát textu zprávy
messageFromAddress Adresa odesílatele uložená v hlavičce zprávy
messageFromName Jméno odesílatele uložené v hlavičce zprávy
messageReplyToAddress Email adresa uvedená v reply-to  v hlavičce zprávy
messageReplyToName Jméno odesílatele uvedené v reply-to v hlavičce zprávy
messageReturnPath Email adresa z položky "Return-Path"
msgFileName Jméno souboru, obsahující text zprávy
pri priorita zprávy
subject Předmět zprávy

Příklad tvaru transformačního řetězce:

txt = "Právě je <%time.strftime("%x %X")%>\n Zprava od:<%messageFromName%> <%messageFromAddress%>\n<%subject%>\n odpoved zaslete na adresu: <%messageReplyToAddress|'lamparna@petrolej.org'%> \n<%msg%>"

zpět na začátek