\r\n\r\n \r\n\r\nIn a normal positioning system the developer is meant to store the position to a database. This database allows persisting a users location for tracking purposes or aiding the positioning system with historical information. With such a set-up the user is not aware how they are being tracked and what information is stored.\r\n\r\n
\r\n \r\n
\r\n\r\nSolid is a specification that lets people store their data securely in decentralized data stores called Pods. Pods are like secure personal web servers for your data. OpenHPS leverages Solid to store ```DataObject```s and ```DataFrame``s that contain private position information and other sensor data. Any data objects belonging to a certain person will be stored in the decentralized Pod owned by that user.\r\n\r\n
\r\n \r\n
\r\n\r\nOn top of this, Solid supports linked data to offer a semantic storage of the data. OpenHPS can output data that can not only be used by OpenHPS - but also other positioning systems who know the vocabulary.\r\n\r\n
\r\n \r\n
\r\n\r\nThese two features combined not only offer more awareness for users on how they are being tracked, but it also enables hybrid positioning between multiple (different) positioning systems. Users will be able to deauthenticate themselves from a positioning system through their Pod's access settings. This will revoke any access that the positioning system has over tracking that particular user.\r\n\r\n
\r\n \r\n
\r\n\r\n## Getting Started\r\nIf you have [npm installed](https://www.npmjs.com/get-npm), start using @openhps/solid with the following command.\r\n```bash\r\nnpm install @openhps/solid --save\r\n```\r\n\r\n## Usage\r\n\r\n### WebID\r\n@openhps/solid adds a new typed parameter to ```DataObject```s and ```DataFrame```s for the [WebID](https://solidproject.org/faqs#what-is-a-webid) of a user.\r\n\r\n**```DataObject```**\r\n```typescript\r\nimport { DataObject } from '@openhps/core';\r\n\r\nconst phone = new DataObject(\"myphone\");\r\nphone.webId = \"https://maximvdw.solidweb.org/profile/card#me\";\r\n```\r\n\r\nThe WebID identifies that this object or data frame is owned by a particular user or organization and should be stored in their Pod.\r\n\r\n**```Dataframe```**\r\n```typescript\r\nimport { DataFrame } from '@openhps/core';\r\n\r\nconst frame = new DataFrame();\r\nframe.webId = \"https://maximvdw.solidweb.org/profile/card#me\";\r\n```\r\n\r\n### Authentication\r\nRegardless if you are implementing the positioning system on a client or server, the system will be a client for whatever Pod server a user is using. Before information can be modified or created, the user needs to be authenticated.\r\n\r\n- **Browser to Browser Authentication**: The user authenticates through the front-end application. After log in the redirect is handled by the front-end application through the ```window.location.href``` URL. The session remains stored on the browser and no server is involved.\r\n- **Browser to Server Authentication**: The user authenticates through the front-end application but the response is captured by a server instead of the front-end application. This allows the server to store multiple sessions.\r\n- **Server Authentication**: The user authenticates by going to a specific path on the server. They will be prompted to log in after which the server continues the authentication and captures the response from the Pod Issuer.\r\n\r\n#### Node.js\r\n```typescript\r\nModelBuilder.create()\r\n .addService(new SolidClientService({\r\n loginPath: \"/login\",\r\n redirectPath: \"/redirect\",\r\n redirectUrl: \"http://localhost:3030/redirect\",\r\n authServer: {\r\n port: 3030\r\n },\r\n loginSuccessCallback: (req: express.Request, res: express.Response, sessionInfo: any) => {\r\n res.send(\"OK \" + JSON.stringify(sessionInfo));\r\n },\r\n loginErrorCallback: (req: express.Request, res: express.Response, sessionInfo: any, reason: any) => {\r\n res.send(\"error: \" + reason);\r\n }\r\n }))\r\n .from()\r\n .to()\r\n .build();\r\n```\r\n\r\n### Storage\r\nData objects and data frames of generic or specific types can be stored using the ```SolidDataDriver```. This driver uses the\r\n```SolidDataClient```.\r\n\r\n```typescript\r\nModelBuilder.create()\r\n .addService(new SolidClientService({\r\n /* ... */\r\n }))\r\n .addService(new DataObjectService(new SolidDataDriver(DataObject)))\r\n .addService(new DataFrameService(new SolidDataDriver(DataFrame)))\r\n .from()\r\n .to()\r\n .build();\r\n```\r\n\r\n## Contributors\r\nThe framework is open source and is mainly developed by PhD Student Maxim Van de Wynckel as part of his research towards *Interoperable and Discoverable Indoor Positioning Systems* under the supervision of Prof. Dr. Beat Signer.\r\n\r\n## Contributing\r\nUse of OpenHPS, contributions and feedback is highly appreciated. Please read our [contributing guidelines](CONTRIBUTING.md) for more information.\r\n\r\n## License\r\nCopyright (C) 2019-2024 Maxim Van de Wynckel & Vrije Universiteit Brussel\r\n\r\nLicensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License. You may obtain a copy of the License at\r\n\r\nhttps://www.apache.org/licenses/LICENSE-2.0\r\n\r\nUnless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.","readmeFilename":"README.md"}
![\"OpenHPS\"](\"https://openhps.org/images/logo_text-512.png\"){kind=logo}
![\"Build](\"https://github.com/OpenHPS/openhps-solid/actions/workflows/main.yml/badge.svg\"){kind=icon}
\r\n \r\n \r\n ![](\"https://codecov.io/gh/OpenHPS/openhps-solid/branch/master/graph/badge.svg\"/){kind=icon}
\r\n \r\n \r\n ![\"Maintainability\"](\"https://img.shields.io/codeclimate/maintainability/OpenHPS/openhps-solid\")
![\"npm](\"https://badge.fury.io/js/@openhps%2Fsolid.svg\"){kind=icon}
\r\n \r\n![\"Conventional](\"./docs/media/images/centralized.svg\")
\r\n![\"Decentralized](\"./docs/media/images/decentralized1.svg\")
\r\n![\"Decentralized](\"./docs/media/images/decentralized2.svg\")
\r\n![\"Decentralized](\"./docs/media/images/decentralized3.svg\")
\r\n