Nejprve je potřeba vytvořit Firebase projekt pro získání FCM server key.
Přihlaste se svým google účtem do https://firebase.google.com/
Přejděte do Go to console
A přidejte projekt stisknutím Add project
Zde zadejte jméno projektu a následně vyberte, zda se jedná o projekt pro Android nebo iOS
Android:
Zde zadejte Package name ve tvaru com.company.appname
a potvrďte tlačítkem Register app
V následující části stáhněte soubor google-services.json
(Tento je třeba vložit do kódu DataSMS klienta.)
iOS:
Zde zadejte Package name ve tvaru com.company.appname
a potvrďte tlačítkem Register app
V následující části stáhněte soubor GoogleService-Info.plist
(Tento je třeba vložit do kódu DataSMS klienta.)
V nastavení konkrétního projektu je pod volbou Cloud Messaging > iOS app configuration
iOS app konfigurace, kde je potřeba uploadovat APNs Authentication Key pro komunikaci s Apple.
(Tento se musí vytvořit v Apple účtu, pod kterým bude aplikace distribuovaná.
Současně je třeba vyplnit Key ID - toto je defaultně součástí názvu vygenerovaného APNs, pokud není název po jeho vytvoření změnen.
A Team ID - identifikátor Apple účtu.)
Dále je v nastavení konkrétního projektu pod volbou Cloud Messaging > Project credentials údaj Server key.
(Tento se musí vložit v Konfigurátoru UMS do Nastavení FCM linky, do atributu FCM server key.)
Dále je potřeba nainstalovat a nakonfigurovat MxService
Konfigurace MxService je zapsána v souboru application.properties v pracovní složce ..\Apache Software Foundation\Tomcat 8.5\conf\MxService\conf\.
Zde je třeba vyplnit:
(Níže uvedené údaje v konfiguračním souboru musí být totožné s nastavením v Konfigurátoru UMS > Nastavení FCM linky.)
LineCfgUsername=Jméno uživatele MxService služby
LineCfgPassword=Heslo uživatele MxService služby
DataSMSLineIds=FCM server key v MD5 Hash
Pokud používáme více linek, tak je oddělíme čárkou.
RefIdToLineIdMappings={"Referenční ID klienta":"FCM server key v MD5 Hash"}
Pokud používáme více linek, tak je oddělíme čárkou.
(Pokud chcete heslo změnit, smažte obsah položky a vepište tam nové. Aplikace MxService po spuštění tato hesla zakóduje.)
Pro převod FCM server key do MD5 Hash můžeme použít generátor, např. https://www.md5hashgenerator.com/,
nebo si ho můžeme přečíst v logu FCM linky, který je zapsán v souboru MxKernel[NazevLinky]_datum.log v pracovní složce ..\DATASYS UMS\Log\MobilChange\
na řádku INFO MXLine [NazevLinky] - Line ID:
Poznámka:
V defaultním nastavení je obsah zpráv chráněn výchozím RSA šifrováním.
V tomto případě mobilní DataSMS klient při registraci k serveru v atributu "keyId" odesílá hodnotu "1".
Pokud si vygenerujete vlastní RSA private a public key, např. programem PuTTYgen (https://www.puttygen.com/) můžete tento (private key) zapsat v Konfigurátoru UMS > Nastavení FCM linky do atributu Zašifrovaný RSA privátní klíč 1 případně do Zašifrovaný RSA privátní klíč 2.
Následně je ale třeba Zašifrovaný RSA veřejný klíč 1 či Zašifrovaný RSA veřejný klíč 2 vložit do kódu DataSMS klienta. Včetně nastavení odesílání hodnoty "LineDriver1" či "LineDriver2" v atributu "keyId".