Nastavení FCM komunikace |
  
|
Nastavení FCM komunikace |
|
Nejprve je potřeba vytvořit Firebase projekt.
Přihlaste se svým google účtem do https://firebase.google.com/
Přejděte do Go to console
Přidejte projekt stisknutím Create a project
Zadejte jméno projektu, který vytváříte a potvrďte stiskem tlačítka Continue
Další obrazovku potvrďte stiskem tlačítka Continue
Vyberte Default Account for Firebase a dokončete stiskem tlačítka Create project
Vyčkejte, než se projekt vytvoří, úspěšné vytvoření projektu je potvrzeno zobrazením textu Your Firebase project is ready, pokračujte stiskem tlačítka Continue
Následně vyberte, zda se jedná o projekt pro Android nebo iOS
Android:
Klikněte na ikonu s Androidem (v případě již nějaké existující aplikace, klikněte nejprve na tlačítko Add app)
Zde zadejte Android package name ve tvaru com.company.appname a potvrďte tlačítkem Register app
V této části stáhněte soubor google-services.json (Tento je třeba vložit do kódu DataSMS klienta.) a stiskněte tlačítko Next
Stiskněte tlačítko Next
Potvrďte tlačítkem Continue to console
iOS:
Klikněte na ikonu s iOS+ (v případě již nějaké existující aplikace, klikněte nejprve na tlačítko Add app)
Zde zadejte Apple bundle ID ve tvaru com.company.appname a potvrďte tlačítkem Register app
V této části stáhněte soubor GoogleService-Info.plist (Tento je třeba vložit do kódu DataSMS klienta.) a stiskněte tlačítko Next
Stiskněte tlačítko Next
Stiskněte tlačítko Next
Potvrďte tlačítkem Continue to console
V nastavení konkrétního projektu pod volbou Project overview (ozubené kolo) > Project settings > Cloud Messaging > Apple app configuration >
Apple apps konfigurace aplikace pod jménem com.company.appname, 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 také Team ID - identifikátor Apple účtu, a potvrdit tlačítkem Upload
Dále je v nastavení konkrétního projektu pod volbou Project overview (ozubené kolo)> Project settings > Service accounts > Firebase Admin SDK tlačítko Generate new private key, kterým vygenerujete FCM service account soubor.
(Obsah tohoto souboru se musí vložit v Konfigurátoru UMS do Nastavení FCM linky, do políčka FCM service account soubor.)
Vygenerování klíče je potřeba potvrdit stiskem tlačítka Generate key
Obsah tohoto souboru se použije v Konfigurátoru UMS v Nastavení FCM linky.
A dále pro vytvoření prostupů z MobilChange Serveru hodnoty:
"auth_uri": https://accounts.google.com/o/oauth2/auth
"token_uri": https://oauth2.googleapis.com/token
"auth_provider_x509_cert_url": https://www.googleapis.com/oauth2/v1/certs
"client_x509_cert_url": https://www.googleapis.com/robot/v1/metadata/x509/firebase-adminsdk-%číslo a projekt%.iam.gserviceaccount.com
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=Hodnota z pole 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".