SMS O2 Connector

Popis programu

Program slouží pro komunikaci s webovou službou nabízenou O2 operátorem a nabízí tak možnost odesílat a přijímat SMS v textové podobě.
Je možné odeslat zprávu až do velikosti 1000 znaků. Zprávy jsou primárně odebírány z databáze, nelze psát vlastní zprávu přímo přes program. Program je schopen v případě výpadku WS služby zprávy pozdržet a udržet a opakovaně po čekání zkoušet, kdy bude služba opět dostupná. Jsou splněny všechny podmínky testování a poslední platné dokumentace implementace integrace.

• Záložka Database
• Záložka Webová služba O2
• Záložka Log
• Záložka Statistika
• Záložka Nastavení
• SSL/TSL chyby
• Replikace SMS

Záložka databáze

Jedná se o primární výchozí záložku programu, zde se nastavují hlavní parametry pro odesílání zpráv; kolik a jak často a odkud se přebírají.

• Interval milisekund načítání SMS z databáze
  • Udává jak často se načítají SMS z databáze a odesílají, udává se v milisekundách. Přednastavený údaj je nejkratší povolený interval od O2, nastavení kratšího by způsobilo chybování služby.
• Maximum SMS z DB
  • Udavá kolik SMS z databáze se načte za jeden interval pro odeslání. Přednastavený údaj je nejvyšší povolený počet od O2 pro daný interval, nastavení vyššího číslo způsobí chybování služby
• Databáze
  • Cesta k databázi SMS.
• Databáze – uživatel
  • Přihlašovací jméno k databázi.
• Databáze – heslo
  • Heslo daného uživatele.
• Test připojení k databázi
  • Pokusí se připojit k DB se zadanými údaji a výsledek zapíše do logu.

Záložka Webová služba O2

Zde se dá nastavit a upravit parametry připojení k WS. Většina parametrů by měla už být připravena při inicializaci z výchozího nastavení.

• URL WS
  • Adresa webové služby O2, měnit pouze po výzvě od O2.
• WS – uživatel
  • Uživatelské jméno přidělené od O2 pro připojení k webové službě.
• WS – heslo
  • Heslo uživatele pro připojení k webové službě.
• Klient Certifikát
  • Certifikát pro připojení k webové službě.
• Počet vláken odesílání SMS
  • Udává kolik vláken bude použito pro odesílání SMS. Přednastavený údaj je založen na dokumentaci webové služby, jedná se o nejvyšší možný počet, zvýšení hodnoty způsobí vyvolání výjimky na WS.
• Počet vláken přijímání SMS
  • Udává kolik vláken bude použito pro odesílání SMS. Přednastavený údaj je založen na dokumentaci webové služby, jedná se o nejvyšší možný počet, zvýšení hodnoty způsobí vyvolání výjimky na WS.
• Typ adresy odesílatele
  • Typ adresy odesílatele určuje jakou hodnotu uvidí příjemce SMS jako odesílatele. WS podporuje 3 typy, (virtuální) telefonní číslo, aplikační číslo a alphanumerické.
• Hodnota adresy odesílatele
  • Příslušná hodnota přidělená od O2, odpovídající zvolenému typu adresy.
• Otestovat připojení k WS
  • Odešle prázdný dotaz na WS čímž ověří její dostupnost. Výsledek zapíše do logu a zobrazí uživateli hlášku o výstupu.

Záložka Log

Do logu jsou vypisovány všechny informace o běhu programu a komunikace včetně přesných časových údajů.

Záložka Statistika

Záložka pro držení statistiky pro dlouhodobější monitorování služby.

• Počet odeslaných SMS
  • Počet úspěšně odeslaných SMS za celou dobu běhu programu od posledního spuštění.
• Počet neúspěšně poslaných SMS
  • Počet neúspěšně odeslaných SMS za celou dobu běhu programu od posledního spuštění.
• Server běží
  • Zobrazuje čas po který byla spuštěna samotná služba od posledního spuštění programu.
• Poslední odeslaná SMS
  • Čas kdy byla odeslána poslední SMS.
• Dnes odesláno SMS
  • Počet odeslaných SMS od půlnoci po přítomnost.
• Server spuštěn
  • Časová známka kdy byl server naposledy spuštěn.

Záložka Nastavení

Záložka pro možnosti případného sledování chyby a testování. Využije se pouze pro případy ladění a testování.

• Logovat SOAP
  • Zatrhnutím se do logu začnou zapisovat i kompletní SOAP komunikace.
• Logovat Fine Level
  • Zatrhnutím se do logu začnou zapisovat informace o konkrétních vláknech programu.
• Uložit Log do souboru
  • Uloží dosavadní záznam logu do textového souboru na disk.
• Vyčistit Log
  • Smaže dosavadní zápis v logu programu.
• Uložit aktuální nastavení
  • Uloží aktuální nastavené hodnoty do registrů, které načteny při příštím spuštění programu.

SSL/TSL chyby

Nelze vytvořit zabezpečený kanál

Po restartování serveru se může stát že se poškodí cesty k certifikátům a služba hlásí chybu : Nelze vytvořit zabezpečený kanál pro režim SSL/TLS s autoritou 160.218.11.110:9061.

Pro odstranění tohoto problému je třeba přeinstalovat certifikát CA na potřebných místech.

Postup opravy

• Vypnout program SMS O2 Connector
• Na ploše složka O2 Certifikáty/clientcgi.cer
• Nainstalovat certifikát na následující místa
• Certifikáty uživatele
  • Osobní
  • Důvěryhodné kořenové certifikační autority
  • Kořenové certifikační autority třetích stran
• Certifikáty počítače – vyžaduje admin potvrzení
  • Osobní
  • Důvěryhodné kořenové certifikační autority
• Nainstalovat i soukromý certifikát
  • Ve stejné složce Certifikáty/992671849.p12
  • Nainstalovat pro uživatele i počítač (automaticky vybrat úložiště)
  • Heslo je ve stejné složce v textovém souboru pod stejným názvem jako certifikát
• Spustit program SMS O2 Connector a zapnout odesílání zpráv. Chyba by tímto měla být odstraněna.

Vysvětlení

Po restartování serveru se neodstraní certifikáty v úložišti ale pravděpodobně se poškodí cesty k certifikátu. Tím pádem „certifikate store“ použitý v programu není schopný správně připojit celý certifikát. Certifikát se instaluje na 5 míst, je to nejmenší odzkoušený počet instalací při kterém služba správně funguje. Program vybírá certifikát z úložiště uživatele, ale framework používá i úložiště pc.