Ga naar inhoud

Gegevens & beveiliging

Hoe OpenProject Sync je gegevens behandelt en beschermt. Het legt uit waarvoor de app dient, welke gegevens ze gebruikt en hoe die gegevens worden gebruikt en beschermd.

Doel

OpenProject Sync boekt de in OpenProject geregistreerde tijd als uren in Exact Online, één conceptregel per persoon, werkpakket en dag, maakt van OpenProject-werkpakketten (en versies) Exact-WBS-activiteiten (en deliverables), en meldt de uurstatus terug aan OpenProject als opmerking op het werkpakket.

Gegevens die we benaderen

Van Gegevens Gebruik
OpenProject (cloud of je self-hosted instantie) tijdregistraties, werkpakketten, versies, projectmetadata en de naam en het e-mailadres van gebruikers om de concept-urenregels en WBS-regels aan te maken, personen te koppelen en statusopmerkingen te plaatsen
Exact Online projecten, WBS-deliverables/-activiteiten, urenregels (project/TimeTransactions) en medewerkers het synchronisatiedoel, één conceptregel per persoon/werkpakket/dag

OpenProject Sync leest nooit bijlagen, documenten of wikipagina's, enkel de hierboven vermelde tijdregistraties, werkpakketten, versies en projectmetadata.

Exact Online

OpenProject Sync bevraagt alleen de Exact Online-endpoints die nodig zijn om tijd en werkpakketten te synchroniseren. De Exact-refreshtokens blijven in het portaal; de app krijgt per aanroep een kortlevend toegangstoken.

Exact Online-resource Gegevens Gebruik
project/Projects bestaande projecten (code, omschrijving, klant) een bestaand Exact-project koppelen, of er een aanmaken vanuit OpenProject
project/WBSActivities WBS-activiteiten, inclusief start-/einddatum en begrote uren OpenProject-werkpakketten worden WBS-activiteiten; de app leest ze en maakt of wijzigt ze, inclusief de planvelden
project/WBSDeliverables WBS-deliverables OpenProject-versies worden deliverables; de app leest ze en maakt of wijzigt ze
project/TimeTransactions urenregels en hun status één concept-urenregel per persoon, werkpakket en dag aanmaken en bijwerken; de status (ingediend, goedgekeurd, geweigerd) lezen; goedgekeurde uren worden nooit overschreven
payroll/Employees medewerkers (naam, zakelijk e-mailadres) OpenProject-gebruikers aan Exact-medewerkers koppelen; alleen lezen
crm/Accounts klanten de klantenkiezer wanneer je een project vanuit OpenProject aanmaakt; alleen lezen
logistics/Items items die als tijdseenheid zijn gemarkeerd het uurtype kiezen; alleen lezen

We gebruiken geen andere Exact Online-gegevens (verkoop, inkoop, productie, financiën, ...). De app bewaart geen kopie van deze gegevens: alleen de identificatiecodes en hashes die een volgende synchronisatie nodig heeft, zoals hieronder beschreven.

Hoe de gegevens stromen

  1. Een beheerder koppelt een OpenProject-project aan een Exact-project (de koppeling vereist een organisatie-beheerder met tweestapsverificatie).
  2. Volgens schema of bij "Nu synchroniseren" leest OpenProject Sync tijdregistraties en werkpakketten uit OpenProject, en de huidige project-/WBS-/uurstatus uit Exact.
  3. Het schrijft in Exact enkel concept-urenregels en WBS-regels (urenregels worden enkel gewijzigd zolang ze nog concept of afgekeurd zijn), en plaatst een statusopmerking op het werkpakket in OpenProject.
  4. Elke schrijfactie wordt met een hash vastgelegd zodat een run idempotent is: hij schrijft nooit dezelfde regel twee keer.

Wat we bewaren, en waarom

Gegevens Waar Bescherming
Het OpenProject API-token van elke koppeling de database van de app AES-256-GCM-versleuteld, gebonden aan zijn eigen record (AAD). Enkel de laatste vier tekens worden ooit getoond; het token zelf wordt nooit teruggegeven of gelogd
Gekoppelde projecten en synchronisatiestatus (cursors, laatste run, hashes van de geschreven regels) de database van de app, per organisatie om de synchronisatie idempotent en hervatbaar te houden
Logins en e-mailadressen van mensen die tijd registreerden, en hun koppeling aan een Exact-medewerker de database van de app, per organisatie zodat een tijdregistratie bij de juiste medewerker terechtkomt
Account-, organisatie- en factureringsgegevens in het portaal zie het data- en beveiligingsdocument van het portaal

Wat we niet bewaren

  • Projectinhoud wordt doorgegeven, niet bewaard. De synchronisatie leest een tijdregistratie, schrijft de urenregel en gooit de rest weg. We bewaren geen kopie van de onderwerpen, beschrijvingen of opmerkingen van je werkpakketten, je Exact-projecten, -medewerkers, -facturen of andere Exact-gegevens, enkel de identificatoren en hashes die een correcte volgende run nodig heeft.
  • Geen bijlagen, documenten of wikipagina's.
  • Geen Exact-refresh-tokens. De tokenbroker van het portaal geeft OpenProject Sync per aanroep een kortlevend toegangstoken (10 minuten, enkel in het geheugen); het refresh-token verlaat het portaal nooit.
  • Geen cache. OpenProject Sync cachet geen Exact- of OpenProject-gegevens in welke vorm dan ook.
  • Geen telemetrie of tracking. Geen analytics, geen licentiecontrole, geen reclame.

Hoe de gegevens beschermd worden

In transit

  • TLS overal: browser ↔ OpenProject Sync, OpenProject Sync ↔ OpenProject, OpenProject Sync ↔ Exact Online, OpenProject Sync ↔ portaal.
  • Tussen het portaal en de app wisselt de edge de sessie om voor een kortlevende, met EdDSA ondertekende assertion (60 s, gebonden aan deze app); de app en het portaal authenticeren elkaar op een intern netwerk met een servicetoken per app.

In rust

  • OpenProject API-tokens zijn AES-256-GCM-versleuteld met een geversioneerde sleutelring en een AAD gebonden aan de koppeling, zodat een token dat uit de ene rij wordt gekopieerd in een andere niet ontsleutelt.

Veilige uitgaande verbindingen (SSRF)

  • OpenProject-URL's van klanten worden enkel bereikt via een veilige fetch die vastgepind is op de host die de tenant voor die instantie instelde, zodat het token niets anders kan bereiken.
  • Het DNS-antwoord wordt bij het verbinden gecontroleerd (bestand tegen rebinding), private/loopback/link-local bereiken worden geweigerd, redirects worden geweigerd, en enkel de OpenProject-paden onder /api/v3 worden gebruikt.
  • Exact-toegang is beperkt tot de ingeschakelde administraties van de organisatie (via de broker), en de schrijfacties zijn door de resourceschema's beperkt tot project-/WBS-/tijdresources.

Toegangsbeheer

  • Wijzigingen (tokens, koppelingen, personen) vereisen een organisatie-beheerder met tweestapsverificatie; "Nu synchroniseren" is beschikbaar voor leden.
  • Exact-gebeurtenissen zijn enkel triggers: de payload wordt genegeerd en de synchronisatie leest Exact en OpenProject opnieuw, zodat een nagebootste gebeurtenis geen gegevens kan injecteren.
  • Het auditlogboek in het portaal legt vast wie wat wijzigde.

Hosting en beheer

  • Gehost in de EU. Containers draaien als niet-root-gebruiker op een alleen-lezen rootbestandssysteem met alle capabilities weggenomen.
  • Afhankelijkheden en containerimages worden dagelijks gescand op kwetsbaarheden (Trivy, HIGH/CRITICAL falen).
  • Foutrapporten (GlitchTip) zijn opt-in en gefilterd: geen headers, cookies, bodies, querystrings of gebruikersinformatie worden verzameld.

Bewaring en verwijdering

  • Het verwijderen van de organisatie in het portaal verwijdert onmiddellijk alles wat OpenProject Sync ervoor bewaart: koppelingen (en hun versleutelde tokens), projecten, personen en synchronisatiestatus.
  • Een token vervangen via OpenProject-koppelingen roteert het zonder de gekoppelde projecten aan te raken.
  • Het auditlogboek leeft in het portaal en wordt bewaard zolang de organisatie bestaat; het wordt samen met de organisatie verwijderd.
  • Versleutelde databaseback-ups worden maximaal 1 jaar bewaard. Verwijderde gegevens (ook van een verwijderde organisatie) verdwijnen dus uiterlijk binnen 1 jaar uit de back-ups; back-ups dienen enkel om de dienst te herstellen.

Wie de gegevens ontvangt

Naar Wat Waarom
je OpenProject-instantie de aanroepen van het token (tijdregistraties, werkpakketten) en de teruggeschreven statusopmerkingen het doel van de dienst
Exact Online (start.exactonline.*) concept-urenregels, WBS-regels, en de project-/WBS-/uurlezingen, voor de ingeschakelde administraties het doel van de dienst
Mollie de betaling voor het abonnement, in het portaal facturering