{"_id":"@appsensorlike/appsensorlike_reporting_engines_websocket","_rev":"10-8ee184d4a16c9777986c7a570f8a394f","name":"@appsensorlike/appsensorlike_reporting_engines_websocket","dist-tags":{"latest":"0.30.1"},"versions":{"0.21.1":{"name":"@appsensorlike/appsensorlike_reporting_engines_websocket","version":"0.21.1","keywords":["js","AppSensor","reporting-engines"],"author":"","license":"MIT","_id":"@appsensorlike/appsensorlike_reporting_engines_websocket@0.21.1","maintainers":[{"name":"si076","email":"spas_iliev@hotmail.com"}],"homepage":"https://github.com/si076/-appsensorlike#readme","bugs":{"url":"https://github.com/si076/-appsensorlike/issues"},"dist":{"shasum":"befb8fca967f460323c6540144ecad44accb3e97","tarball":"https://registry.npmjs.org/@appsensorlike/appsensorlike_reporting_engines_websocket/-/appsensorlike_reporting_engines_websocket-0.21.1.tgz","fileCount":6,"integrity":"sha512-wdWe49H6DeUPPuyHV/Gv6tbeGINgpLygDT2MakGK5ylD1b4eo5oFsZHqGH0UlbJ0Fyl82g05OHvD51Y0dx7Hug==","signatures":[{"sig":"MEUCIDcgMiRDqjjnq02VOOxf3cZGpOJ83wIAJDbQEoNJ1ebMAiEAl8e9b68flk7UMlUJkmgDEp0lsc5cjs2WprGWQue27Qs=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":44800},"type":"module","exports":{"./client":"./dist/reporting-engines/appsensor-reporting-websocket/client/appsensor-reporting-websocket-client.js","./server":"./dist/reporting-engines/appsensor-reporting-websocket/server/appsensor-reporting-websocket-server.js"},"gitHead":"9c052b3f2af364843c814dbacba879afabcddde6","scripts":{"test":"echo \"Error: no test specified\" && exit 1","run_reporting_tests_client_only":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runClientSeparately","run_reporting_tests_server_only":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runServerSeparately","run_reporting_tests_client_only_report_events":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runClientSeparatelyReportEvents"},"_npmUser":{"name":"si076","email":"spas_iliev@hotmail.com"},"repository":{"url":"git+https://github.com/si076/-appsensorlike.git","type":"git"},"_npmVersion":"8.19.4","description":"AppSensorLike reporting engines websocket","directories":{},"_nodeVersion":"14.15.0","dependencies":{"@appsensorlike/appsensorlike_websocket":"^0.20.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/appsensorlike_reporting_engines_websocket_0.21.1_1688911010464_0.1479111468805261","host":"s3://npm-registry-packages"}},"0.21.2":{"name":"@appsensorlike/appsensorlike_reporting_engines_websocket","version":"0.21.2","keywords":["js","AppSensor","reporting-engines"],"author":"","license":"MIT","_id":"@appsensorlike/appsensorlike_reporting_engines_websocket@0.21.2","maintainers":[{"name":"si076","email":"spas_iliev@hotmail.com"}],"homepage":"https://github.com/si076/-appsensorlike#readme","bugs":{"url":"https://github.com/si076/-appsensorlike/issues"},"dist":{"shasum":"9369b51c16a73abfdd94a57e4ab3a4e9838b7e32","tarball":"https://registry.npmjs.org/@appsensorlike/appsensorlike_reporting_engines_websocket/-/appsensorlike_reporting_engines_websocket-0.21.2.tgz","fileCount":10,"integrity":"sha512-sMclzjs11uHrrT2GRx2bdBvGUr1lIm8QQpvp0HQ9jnoi0rJ1KVFj7+FRpvf5lB4Exk3h7ZEnS4EVqGp86jbwxw==","signatures":[{"sig":"MEUCIFT+XB9u10jXR5TImY9zREgqWgsqaWx1nFxTMs6dnagSAiEA0JtjnLkaUdwZRhKgTd730ACjKpmwe5iqCKwsFI5IUu0=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":468792},"type":"module","exports":{"./client":"./dist/reporting-engines/appsensor-reporting-websocket/client/appsensor-reporting-websocket-client.js","./server":"./dist/reporting-engines/appsensor-reporting-websocket/server/appsensor-reporting-websocket-server.js"},"gitHead":"9c052b3f2af364843c814dbacba879afabcddde6","scripts":{"test":"echo \"Error: no test specified\" && exit 1","run_reporting_tests_client_only":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runClientSeparately","run_reporting_tests_server_only":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runServerSeparately","run_reporting_tests_client_only_report_events":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runClientSeparatelyReportEvents"},"_npmUser":{"name":"si076","email":"spas_iliev@hotmail.com"},"repository":{"url":"git+https://github.com/si076/-appsensorlike.git","type":"git"},"_npmVersion":"8.19.4","description":"AppSensorLike reporting engines websocket","directories":{},"_nodeVersion":"14.15.0","dependencies":{"@appsensorlike/appsensorlike_websocket":"^0.20.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/appsensorlike_reporting_engines_websocket_0.21.2_1688911555439_0.5120781413960505","host":"s3://npm-registry-packages"}},"0.21.3":{"name":"@appsensorlike/appsensorlike_reporting_engines_websocket","version":"0.21.3","keywords":["js","AppSensor","reporting-engines"],"author":"","license":"MIT","_id":"@appsensorlike/appsensorlike_reporting_engines_websocket@0.21.3","maintainers":[{"name":"si076","email":"spas_iliev@hotmail.com"}],"homepage":"https://github.com/si076/-appsensorlike#readme","bugs":{"url":"https://github.com/si076/-appsensorlike/issues"},"dist":{"shasum":"2643623f4cd6d93ffa6c599503783b7f6234fee3","tarball":"https://registry.npmjs.org/@appsensorlike/appsensorlike_reporting_engines_websocket/-/appsensorlike_reporting_engines_websocket-0.21.3.tgz","fileCount":10,"integrity":"sha512-eirBrOvb45G3ZPD9evp9OTmEHnJjNaBsm0R+m9wzvA3cjSiKbrgqoqkqG9QBl5Q+UzkUwxKNKf14LORyTn8N/g==","signatures":[{"sig":"MEUCIFPOauKqMygU43dq5EYLRDBa735JO7soJpnivJRomXARAiEAlVPsTW79de6cBY8e3B7KxDNqTRrDjoJ85F/OSisjgg8=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":468792},"type":"module","exports":{"./client":"./dist/reporting-engines/appsensor-reporting-websocket/client/appsensor-reporting-websocket-client.js","./server":"./dist/reporting-engines/appsensor-reporting-websocket/server/appsensor-reporting-websocket-server.js"},"gitHead":"f6a20953116cb0a70276dd42cfed6e9dd372efe5","scripts":{"test":"echo \"Error: no test specified\" && exit 1","run_reporting_tests_client_only":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runClientSeparately","run_reporting_tests_server_only":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runServerSeparately","run_reporting_tests_client_only_report_events":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runClientSeparatelyReportEvents"},"_npmUser":{"name":"si076","email":"spas_iliev@hotmail.com"},"repository":{"url":"git+https://github.com/si076/-appsensorlike.git","type":"git"},"_npmVersion":"8.19.4","description":"AppSensorLike reporting engines websocket","directories":{},"_nodeVersion":"14.15.0","dependencies":{"@appsensorlike/appsensorlike_websocket":"^0.20.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/appsensorlike_reporting_engines_websocket_0.21.3_1688969110697_0.8528223290544485","host":"s3://npm-registry-packages"}},"0.21.4":{"name":"@appsensorlike/appsensorlike_reporting_engines_websocket","version":"0.21.4","keywords":["js","AppSensor","reporting-engines"],"author":"","license":"MIT","_id":"@appsensorlike/appsensorlike_reporting_engines_websocket@0.21.4","maintainers":[{"name":"si076","email":"spas_iliev@hotmail.com"}],"homepage":"https://github.com/si076/-appsensorlike#readme","bugs":{"url":"https://github.com/si076/-appsensorlike/issues"},"dist":{"shasum":"fd0b2abeaa20daa2b17dc4a87e8ae0de7c1c7a3f","tarball":"https://registry.npmjs.org/@appsensorlike/appsensorlike_reporting_engines_websocket/-/appsensorlike_reporting_engines_websocket-0.21.4.tgz","fileCount":10,"integrity":"sha512-fdcr+cDUSaQrqjM5MCZOE2DvjuDjJZYloQpZtqGotuOstFDSW7qn5ZMivw+na97G2yWW6Ov69UfkY9p2oIm9qg==","signatures":[{"sig":"MEUCIDKZ1XzeilOrz+jk2OXVWmTGuSBzPT6s9HOKbKffCntIAiEA8JQjArIedc4kHGhTiKJGtjLe9CgiAiih1PHzL25j+aI=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":469602},"type":"module","engines":{"node":">=14.15.0"},"exports":{"./client":"./dist/reporting-engines/appsensor-reporting-websocket/client/appsensor-reporting-websocket-client.js","./server":"./dist/reporting-engines/appsensor-reporting-websocket/server/appsensor-reporting-websocket-server.js"},"gitHead":"154abbfb88fc2e743971de2e6d5785eb0dbcdcbe","scripts":{"test":"echo \"Error: no test specified\" && exit 1","run_reporting_tests_client_only":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runClientSeparately","run_reporting_tests_server_only":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runServerSeparately","run_reporting_tests_client_only_report_events":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runClientSeparatelyReportEvents"},"_npmUser":{"name":"si076","email":"spas_iliev@hotmail.com"},"repository":{"url":"git+https://github.com/si076/-appsensorlike.git","type":"git"},"_npmVersion":"8.19.4","description":"AppSensorLike reporting engines websocket","directories":{},"_nodeVersion":"14.15.0","dependencies":{"@appsensorlike/appsensorlike_websocket":"^0.20.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/appsensorlike_reporting_engines_websocket_0.21.4_1695715838054_0.48628776327305956","host":"s3://npm-registry-packages"}},"0.21.6":{"name":"@appsensorlike/appsensorlike_reporting_engines_websocket","version":"0.21.6","keywords":["js","AppSensor","reporting-engines"],"author":"","license":"MIT","_id":"@appsensorlike/appsensorlike_reporting_engines_websocket@0.21.6","maintainers":[{"name":"si076","email":"spas_iliev@hotmail.com"}],"homepage":"https://github.com/si076/-appsensorlike#readme","bugs":{"url":"https://github.com/si076/-appsensorlike/issues"},"dist":{"shasum":"029f5b09c6d4c427205f08d9da5771e31731ca44","tarball":"https://registry.npmjs.org/@appsensorlike/appsensorlike_reporting_engines_websocket/-/appsensorlike_reporting_engines_websocket-0.21.6.tgz","fileCount":10,"integrity":"sha512-kBIxPFIZwBpHxD3sINJEEzxRKrm5glCPZLwWI72sDbC/tFkJXAMXICgEl0XaLX2S7bq/cC0MVGaEf1Xqqnb2vA==","signatures":[{"sig":"MEYCIQCXCSXxHgse8PHIfFolHBrfGvtSa1vthnXsuoKr9LtqhQIhAPXJwRpqE0D8g6476MqtwnzCg+KOQxvpodRtTaX+eYSP","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":489931},"type":"module","engines":{"node":">=14.15.0"},"exports":{"./client":"./dist/reporting-engines/appsensor-reporting-websocket/client/appsensor-reporting-websocket-client.js","./server":"./dist/reporting-engines/appsensor-reporting-websocket/server/appsensor-reporting-websocket-server.js"},"gitHead":"efebaf1985d872765123943d196237d5aee56abf","scripts":{"test":"echo \"Error: no test specified\" && exit 1","run_reporting_tests_client_only":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runClientSeparately","run_reporting_tests_server_only":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runServerSeparately","run_reporting_tests_client_only_report_events":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runClientSeparatelyReportEvents"},"_npmUser":{"name":"si076","email":"spas_iliev@hotmail.com"},"repository":{"url":"git+https://github.com/si076/-appsensorlike.git","type":"git"},"_npmVersion":"8.19.4","description":"AppSensorLike reporting engines websocket","directories":{},"_nodeVersion":"14.15.0","dependencies":{"@appsensorlike/appsensorlike":"^0.20.6","@appsensorlike/appsensorlike_websocket":"^0.20.6"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/appsensorlike_reporting_engines_websocket_0.21.6_1706951309636_0.7191963682141174","host":"s3://npm-registry-packages"}},"0.30.0":{"name":"@appsensorlike/appsensorlike_reporting_engines_websocket","version":"0.30.0","keywords":["js","AppSensor","reporting-engines"],"author":"","license":"MIT","_id":"@appsensorlike/appsensorlike_reporting_engines_websocket@0.30.0","maintainers":[{"name":"si076","email":"spas_iliev@hotmail.com"}],"homepage":"https://github.com/si076/-appsensorlike#readme","bugs":{"url":"https://github.com/si076/-appsensorlike/issues"},"dist":{"shasum":"5a053ee8ff4695ec335367e5b076c08ceb5a1d49","tarball":"https://registry.npmjs.org/@appsensorlike/appsensorlike_reporting_engines_websocket/-/appsensorlike_reporting_engines_websocket-0.30.0.tgz","fileCount":10,"integrity":"sha512-NxHy3XK3Itj3RYdfOlctZpXYWpVCcupyuFqh3zO6Z4GUStTTsAKj70qphHbTqrfKXhZfISrmNrtcdrAgRzP0GA==","signatures":[{"sig":"MEUCIQDA/Xe1kxHGXeockxoYuOzX3zla6x8HkxBnSOLMdolRawIgafUvb5rPbghQZxF5/zgfKx7O0ddlMPVHIVT/gniZIDQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":489673},"type":"module","engines":{"node":">=14.15.0"},"exports":{"./client":"./dist/reporting-engines/appsensor-reporting-websocket/client/appsensor-reporting-websocket-client.js","./server":"./dist/reporting-engines/appsensor-reporting-websocket/server/appsensor-reporting-websocket-server.js"},"gitHead":"c2f66feaa887caa50dc3b7ec9a02c678246b97c0","scripts":{"test":"echo \"Error: no test specified\" && exit 1","run_reporting_tests_client_only":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runClientSeparately","run_reporting_tests_server_only":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runServerSeparately","run_reporting_tests_client_only_report_events":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runClientSeparatelyReportEvents"},"_npmUser":{"name":"si076","email":"spas_iliev@hotmail.com"},"repository":{"url":"git+https://github.com/si076/-appsensorlike.git","type":"git"},"_npmVersion":"10.8.2","description":"AppSensorLike reporting engines websocket","directories":{},"_nodeVersion":"20.18.0","dependencies":{"@appsensorlike/appsensorlike":"^0.30.0","@appsensorlike/appsensorlike_websocket":"^0.30.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/appsensorlike_reporting_engines_websocket_0.30.0_1743847838627_0.12287576139003242","host":"s3://npm-registry-packages-npm-production"}},"0.30.1":{"name":"@appsensorlike/appsensorlike_reporting_engines_websocket","version":"0.30.1","description":"AppSensorLike reporting engines websocket","type":"module","scripts":{"test":"echo \"Error: no test specified\" && exit 1","run_reporting_tests_server_only":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runServerSeparately","run_reporting_tests_client_only":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runClientSeparately","run_reporting_tests_client_only_report_events":"npx run-func ./tests/appsensor-reporting-websocket-tests.js runClientSeparatelyReportEvents"},"repository":{"type":"git","url":"git+https://github.com/si076/-appsensorlike.git"},"keywords":["js","AppSensor","reporting-engines"],"author":"","license":"MIT","bugs":{"url":"https://github.com/si076/-appsensorlike/issues"},"homepage":"https://github.com/si076/-appsensorlike#readme","engines":{"node":">=14.15.0"},"exports":{"./server":"./dist/reporting-engines/appsensor-reporting-websocket/server/appsensor-reporting-websocket-server.js","./client":"./dist/reporting-engines/appsensor-reporting-websocket/client/appsensor-reporting-websocket-client.js"},"dependencies":{"@appsensorlike/appsensorlike":"^0.30.0","@appsensorlike/appsensorlike_websocket":"^0.30.0"},"_id":"@appsensorlike/appsensorlike_reporting_engines_websocket@0.30.1","gitHead":"eb67218ede71b428dce058f0c36aa13552aa4608","_nodeVersion":"20.18.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-R/g7qCQvZG2BDy2s+OST/mI9VySphAA/gE5PZIQ1Q1ex7TxvgNh4vWXPDCF2rkovtUmrJFwmPbfQlR9mj/2tfw==","shasum":"c712e3f9f123f38b23a83f4453d5172e1f3dd5bc","tarball":"https://registry.npmjs.org/@appsensorlike/appsensorlike_reporting_engines_websocket/-/appsensorlike_reporting_engines_websocket-0.30.1.tgz","fileCount":10,"unpackedSize":490768,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC6+UVvcJNd3b47v0G9Y8NMiReVsHbnaKGsVVcZg+VApgIhAOMjW4KIoRqJ/QjtXFD+ocL7ZZinQIT8nauZlsAL4D7/"}]},"_npmUser":{"name":"si076","email":"spas_iliev@hotmail.com"},"directories":{},"maintainers":[{"name":"si076","email":"spas_iliev@hotmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/appsensorlike_reporting_engines_websocket_0.30.1_1743959146190_0.3019783200069417"},"_hasShrinkwrap":false}},"time":{"created":"2023-07-09T13:56:50.363Z","modified":"2025-04-06T17:05:46.590Z","0.20.0":"2023-07-09T09:51:14.950Z","0.21.1":"2023-07-09T13:56:50.631Z","0.21.2":"2023-07-09T14:05:55.681Z","0.21.3":"2023-07-10T06:05:10.893Z","0.21.4":"2023-09-26T08:10:38.207Z","0.21.6":"2024-02-03T09:08:29.838Z","0.30.0":"2025-04-05T10:10:38.875Z","0.30.1":"2025-04-06T17:05:46.404Z"},"bugs":{"url":"https://github.com/si076/-appsensorlike/issues"},"license":"MIT","homepage":"https://github.com/si076/-appsensorlike#readme","keywords":["js","AppSensor","reporting-engines"],"repository":{"type":"git","url":"git+https://github.com/si076/-appsensorlike.git"},"description":"AppSensorLike reporting engines websocket","maintainers":[{"name":"si076","email":"spas_iliev@hotmail.com"}],"readme":"[@appsensorlike/appsensorlike](https://www.npmjs.com/package/@appsensorlike/appsensorlike) reporting engine over websocket implementation.\n\n\nInstallation\n---\n`````\nnpm i @appsensorlike/appsensorlike_reporting_engines_websocket\n`````\n\n\nReporting engine\n---\nThe reporting engine allows you to obtain some statistical data from AppSensorLike server. It could also monitor the server for new AppSensorEvents, Attacks, Responses. Whith this websocket implementation, the client part of the engine, get notified when a new AppSensorEvent, Attack, Response is generated on the server. \n\nMost notably, the *dashboard and console* take advantage of this module. \n\n\nUsage\n---\n`````javascript\nimport { AppSensorLocal } from '@appsensorlike/appsensorlike/execution-modes/appsensor-local/appsensor_local.js';\nimport { AppSensorEvent, Attack, Response, Category, DetectionPoint, DetectionSystem, User } from \"@appsensorlike/appsensorlike/core/core.js\";\nimport { AppSensorReportingWebSocketClient } from \"@appsensorlike/appsensorlike_reporting_engines_websocket/client\";\nimport { AppSensorReportingWebSocketServer } from \"@appsensorlike/appsensorlike_reporting_engines_websocket/server\";\n\nconst earliest = new Date().toISOString();\n\nconst appSensorLocal = new AppSensorLocal();\nconst eventManager = appSensorLocal.getAppSensorClient().getEventManager();\n\n//following lines are added just for purpose of demonstration\n//\nconst user1 = new User(\"user1\");\nconst detectionPoint = new DetectionPoint(Category.REQUEST, \"RE7\");\nconst detectionSystem = new DetectionSystem(\"localhostme\");\n\nif (eventManager) {\n    await eventManager.addEvent(new AppSensorEvent(user1, detectionPoint, detectionSystem)); \n    await eventManager.addEvent(new AppSensorEvent(user1, detectionPoint, detectionSystem)); //new instance every time to set timestamp\n}\n\n//create and start the reporting engine server\nconst wsServer = new AppSensorReportingWebSocketServer(appSensorLocal.getAppSensorServer());\nawait wsServer.startServer();\n\n//after this point the reporting engine client can connect to the reporting engine server\nconst wsClient = new AppSensorReportingWebSocketClient();\n//add a listener for \"bubbling\" AppSensorEvents, Attacks, Responses\nwsClient.addOnAddListener((obj) => {//: AppSensorEvent | Attack | Response) => {\n    console.log(obj);\n});\n//connect to the reporting server via web socket\nawait wsClient.connect();\n\nconst userName = user1.getUsername();\nconst eventCount = await wsClient.countEventsByUser(earliest, userName);\nconst attackCount = await wsClient.countAttacksByUser(earliest, userName);\nconst responseCount = await wsClient.countResponsesByUser(earliest, userName);\nconsole.log(`Stats for user: ${userName} since: ${earliest}`);\nconsole.log(`Event count: ${eventCount}`);\nconsole.log(`Attack count: ${attackCount}`);\nconsole.log(`Response count: ${responseCount}`);\n\nconst eventCountByCategoryLabel = await wsClient.countEventsByCategoryLabel(earliest, Category.REQUEST, \"RE7\");\nconsole.log(`Events of \"RE7\"(${Category.REQUEST}): ${eventCountByCategoryLabel}`);\n\n//add some new events to see \"bubbling\"\nif (eventManager) {\n    await eventManager.addEvent(new AppSensorEvent(user1, detectionPoint, detectionSystem)); \n    await eventManager.addEvent(new AppSensorEvent(user1, detectionPoint, detectionSystem)); //new instance every time to set timestamp\n}\n\nawait wsClient.closeSocket();\n\nawait wsServer.closeServer();\nawait wsServer.stopServer();\n`````\n\nThe upper example is just for a demonstration. You can run reporting engine server along with AppSensorLike server on a separate node instance from the reporting engine client.\n\n\nAuthentication and authorization of clients\n---\n**Authentication** of the reporting engine client by the reporting engine server is based on custom header field and its value, sent with the websocket request. The field name is specified with clientApplicationIdentificationHeaderName of appsensor-server-config.json configuration file. The value of the field has to match one of ClientApplication.name enumerated under clientApplications of appsensor-server-config.json config file. If in the matched ClientApplication is present ipAddresses, this narrows down further the clients. These are allowed IPs only. The IPs can be specified in IPv4 or IPv6 format. For 127.0.0.1 in particular you can write \"localhost\" instead.\n\n**Authorization** - after the reporting engine client has successfully been authenticated, its authorizations are checked against the roles found in the matched ClientApplication during the authentication phase. Role EXECUTE_REPORT is required.\n\nFor example in appsensor-server-config.json:\n`````json\n    ...\n    \"clientApplicationIdentificationHeaderName\": \"X-Appsensor-Client-Application-Name\",\n    ...\n    \"clientApplications\": [\n        {\n            \"name\": \"myclientapp\",\n            \"roles\": [\n                \"ADD_EVENT\",\n                \"ADD_ATTACK\",\n                \"GET_RESPONSES\",\n                \"GET_EVENTS\",\n                \"GET_ATTACKS\",\n                \"EXECUTE_REPORT\"\n            ],\n            \"ipAddresses\": [{\n                \"address\": \"localhost\",\n                \"geoLocation\": null\n            }]\n        }]\n    ...\n`````\nFor example in your reporting config file appsensor-reporting-websocket-client.json\n`````json\n{\n    \"address\": \"ws://localhost:3000\",\n    \"reconnectOnConnectionLost\": true,\n    \"options\":{\n        \"headers\": {\n            \"X-Appsensor-Client-Application-Name\": \"myclientapp\"\n        }\n    }\n}\n`````\n\nConfiguration\n---\nThe reporting engine server can be configured via *appsensor-reporting-websocket-server-config.json* file in your working directory. You can copy the default configuration from the module's dist/reporting-engines/appsensor-reporting-websocket/server. Corresponding schema file *appsensor-websocket-server-config_schema.json* is in the same directory. For more information on the configuration fields check class WebSocketServerConfig of @appsensorlike/appsensorlike_websocket/dist/websocket/server/appsensor-websocket-server.d.ts. This implementation utilizes Node's http/s server so you could refer to Node's documentation about the options (e.g. https://nodejs.org/dist/v14.15.0/docs/api/http.html#http_http_createserver_options_requestlistener). By default the server listens on port 3000. The implementation also takes advantage of WS websocket module so you could check for websocket server options under https://github.com/websockets/ws/blob/HEAD/doc/ws.md#new-websocketserveroptions-callback , especially the fields exposed via this configuration.\n\nThe reporting engine client can be configured thru *appsensor-reporting-websocket-client-config.json* file in your working directory. You can copy the default configuration from the module's dist/reporting-engines/appsensor-reporting-websocket/client. Corresponding schema file *appsensor-websocket-client-config_schema.json* is in the same directory. For more information on the configuration fields check class WebSocketClientConfig of @appsensorlike/appsensorlike_websocket/dist/websocket/client/appsensor-websocket-client.d.ts. The default url is ws://localhost:3000 . The implementation takes advantage of WS websocket module so you could check for websocket options here  https://github.com/websockets/ws/blob/HEAD/doc/ws.md#new-websocketaddress-protocols-options .\n\n\nTypeScript support\n---\nYou need TypeScript version >= 4.7 in order the paths exported by the module to be resolved.\n","readmeFilename":"Readme.md"}