Insight Push Notifications¶
Optional part, only if you want to enable push notifications in your mobile apps.
Installation¶
-
Configure location of db-files in x:\GIS\Insight\Wildfly\standalone\configuration\standalone.xml
- Edit path-Entry for files if necessary and restart Wildfly-Service
<connection-url>jdbc:h2:/gis/insight/db/insightdb</connection-url>
- Edit path-Entry for files if necessary and restart Wildfly-Service
-
Copy insight-push.war into x:\GIS\Insight\Wildfly\standalone\standalone\deployments
-
Wait until you can see a file called:
insight-push.war.deployed
-
The server has to communicate to the URL:
- https://fcm.googleapis.com
- https://oauth2.googleapis.com
- For this communication you can configure a proxy:
\GIS\Insight\Wildfly\bin\standalone.conf
"JAVA_OPTS="$JAVA_OPTS -Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=3128 -Dhttps.proxyHost=proxy.example.com -Dhttps.proxyPort=3128"
x:\GIS\Insight\Wildfly\bin\standalone.conf.bat
set "JAVA_OPTS=%JAVA_OPTS% -Dhttp.proxyHost=proxy.company.com -Dhttp.proxyPort=3128 -Dhttps.proxyHost=proxy.company.com -Dhttps.proxyPort=3128"
-
Proxy and truststore Java opts
JAVA_OPTS="$JAVA_OPTS -Djavax.net.ssl.trustStore=pathto/keystore.jks"
JAVA_OPTS="$JAVA_OPTS -Djavax.net.ssl.trustStorePassword=trustStorePassword"
JAVA_OPTS="$JAVA_OPTS -Dhttp.proxyUser=user"
JAVA_OPTS="$JAVA_OPTS -Dhttp.proxyPassword=password"
JAVA_OPTS="$JAVA_OPTS -Dhttp.proxyHost=host"
JAVA_OPTS="$JAVA_OPTS -Dhttp.proxyPort=port"
JAVA_OPTS="$JAVA_OPTS '-Dhttp.nonProxyHosts=localhost|127.0.0.1'"
JAVA_OPTS="$JAVA_OPTS -Dhttps.proxyUser=user"
JAVA_OPTS="$JAVA_OPTS -Dhttps.proxyPassword=password"
JAVA_OPTS="$JAVA_OPTS -Dhttps.proxyHost=host"
JAVA_OPTS="$JAVA_OPTS -Dhttps.proxyPort=port"
JAVA_OPTS="$JAVA_OPTS '-Dhttps.nonProxyHosts=localhost|127.0.0.1'"
-
You can test the communication with this URL:
-
https://<yourdomain.com>/insight/push/push/test
On insight server:
-
http://localhost:8080/insight-push/rest/push/test
Success response is: {"message": "Firebase-Server is available"}
For debugging, you can take a look at: x:\GIS\Insight\Wildfly\standalone\log\server.log
-
-
Send Push-Notification
Enable Insight Push on Client¶
-
To enable push notifications for the insight-mobile-App, you have to add the following property to config.json.
<httpd-server>\htdocs\insight\mobile\config.json
(More details: Client Configuration){ ... "pushNotification": true ... }
-
For test purposes it is possible to trigger a test message:
- Client Device -> Insight Mobile -> Menu -> Settings -> Send test push notification.
- On success, a dialog shows you a success message.
- On error, you have to take a look at:
<wildfly>\standalone\log\server.log
-
Send Push-Notification
Data protection notice¶
Communication with Firebase-Server does not contain any personal data. And there is also no traceability.