docs

    ↑↓ to move ↵ to open esc to close

    Security and data

    Business Central Connector sits between Clockify, a product of CAKE.com, and Microsoft Dynamics 365 Business Central, a product of Microsoft. Spainlink built it, and neither company did. Its add-on service reads from Clockify, writes to your Business Central through the Clockify Connector extension, and stores very little.

    This describes the add-on as it runs in our test workspace: see the Overview for availability.

    How the page knows who you are

    The page in Clockify has no sign-in of its own. Clockify’s signed token identifies each person, and every route that serves your data refuses a call without one. Your Clockify role then decides what you see, as Roles and access sets out.

    The webhook

    The webhook that announces an approval is the add-on’s own. Clockify signs it, and the add-on service checks it on every delivery. A delivery that fails the check starts nothing. How it works follows one that passes.

    Access to Clockify

    The add-on has nine read-only scopes and no write scope. It writes nothing back to Clockify. For now the sync reads with a Clockify API key, which these scopes do not limit: it acts with the rights of the person who created it. The add-on service only reads with that key.

    Where your data lives

    Your time data lives in Clockify and in your Business Central. The add-on service keeps no database of it. Apart from its logs, it stores the mapping, with its earlier versions, and one installation record per workspace, which holds identifiers and no tokens. It is hosted on Microsoft Azure, in East US.

    Where credentials live

    No Clockify or Microsoft credentials are ever stored inside your Business Central. The add-on service holds these:

    • Installation tokens, which Clockify issues when the add-on is installed, sit in Azure Key Vault, not in the installation record.
    • A Clockify API key, for now. The sync still reads Clockify with it, and it is kept in the add-on service’s settings. Getting connected has the step that hands it over.
    • A client secret, for the connector’s Microsoft Entra application. The add-on service signs in to Business Central with it, and it is kept in the add-on service’s settings. It is Spainlink’s, so you never create it or hand it over.

    No token reached the logs across 3 installs, 2 uninstalls, 4 approvals and 26 page loads in our test workspace. Uninstalling the add-on disables the tokens, and never deletes them.

    How the add-on service signs in to Business Central

    The add-on service signs in to your Business Central as a registered Microsoft Entra application. What it can do there is set by the two permission sets assigned to that application: SLK CLOCKIFY, the least-privilege set that ships with the extension, and D365 BASIC, Microsoft’s baseline set. Registering the application is one of the steps on Getting connected.

    The audit log

    The extension keeps an append-only sync log inside your Business Central. It records every write, every post, every review flag and every staging deletion, with timestamps. The log’s page and API refuse any edit or deletion of a row, and the permission set that ships with the extension lets the add-on service read and add rows only. The log is built for finance review and compliance, and In Business Central shows where to read it.

    Telemetry

    Telemetry and operational logs are redacted. For each entry a sync sends to Business Central, the add-on service logs its Clockify entry id, posting date, project number and hours, and leaves the description out. It scrubs and shortens any error text it records.

    The Clockify Connector extension also sends telemetry to Spainlink’s Application Insights in East US: its own events, which carry the first 12 characters of a Clockify entry id, and Business Central’s standard signals about the extension and the calls to its APIs, which name your tenant, environment and company. Filter values in those signals are masked, and they carry no entry descriptions, names or amounts.

    What the page in Clockify loads

    The page in Clockify loads everything it shows, its font included, from the add-on service. Its Content Security Policy keeps the browser to the add-on service, so the page itself sends no request to any other host.