Security policy
Report a gridcn vulnerability privately, see which versions get fixes, and check what counts as in scope.
Report a vulnerability privately. A confirmed vulnerability gets a fix before the advisory goes public. The report, support, and scope rules match SECURITY.md in the repository.
| Topic | Rule |
|---|---|
| Report | GitHub Security Advisory |
| First reply | Best effort within 7 days |
| Supported | Version 2.x, and 1.x for 90 days after the 2.0.0 tag |
Report a vulnerability
Open a GitHub Security Advisory. Do not open a public issue or pull request for a vulnerability.
Include these details:
- The affected registry item, for example
data-grid-io. - The tag or commit you installed from. For an install from the hosted
@gridcnregistry, give the install date. - Steps to reproduce.
The first reply comes within 7 days, on a best-effort basis.
Supported versions
| Version | Receives security fixes |
|---|---|
| 2.x | Yes |
| 1.x | Security fixes until 90 days after the 2.0.0 tag |
| 0.x | No |
Scope
In scope:
- The registry source under
registry/and the payloads inpublic/r/. - The documentation site and its demos.
- Handling of untrusted input.
Out of scope:
- Code you edited after installing it.
- Vulnerabilities in your own app, in your data source, or in dependencies that gridcn does not pin.
- Denial of service through data volume you chose to load, beyond the import limits.
gridcn pins hucre to an exact version. The other packages install from a version range.
Untrusted input means imported CSV, XLSX, and XLS files, clipboard content, and URL state. It also means saved-view files, stored view documents, cell values shown as text or links, and CSV export. The request bodies that parseServerSpec reads are untrusted too. Check the spec on your server bounds them.
How gridcn handles untrusted input
- The grid renders a cell value as text, never as HTML. gridcn reads pasted HTML with the browser's DOMParser, which runs no script.
- If a cell link uses a protocol other than
http:,https:, ormailto:, such asjavascript:, the cell renders plain text. A relative link and a link over 2,048 characters also render plain text. - A cell value that throws on conversion to text, such as an object without a prototype, shows as empty text.
- A paste applies at most 200,000 cells. Clipboard lists the caps.
- A paste ignores clipboard HTML above 16,000,000 characters and reads the plain text. Above 51,200,000 characters of plain text, it writes nothing.
- URL state reads a bounded number of filters and groups. URL state lists the bounds.
- CSV export prefixes a formula-like cell with a single quote. Set
sanitizeFormulas: falseonexportGridto turn this off. - XLSX export writes
number,date, andcheckboxcolumns as typed cells. It writes every other cell as a text cell, so no string runs as a formula.formatCelloverrides both. - Copy and cut prefix formula-like text with a single quote. Set the grid prop
sanitizeClipboardFormulastofalseto copy raw text. Clipboard has the details. - An import rejects a file that exceeds any bound: file size, rows, columns, cells, or decompressed size. It never truncates the file.
What leaves the page
The grid makes no network request of its own. It has no telemetry and loads no remote script or font. Data leaves the page only in these ways:
| Path | What leaves | Trigger |
|---|---|---|
| Your server functions | What you send in a function you pass, such as fetchRows, onSave, fetchFilterValues, fetchOptions, fetchAggregates, an export source, or a presence channel | Your code. See Save edits and Load server rows. |
| Clipboard | The copied cells as text/plain and text/html | A copy or cut by the user. See Clipboard. |
| Export file | A CSV or XLSX file that the browser downloads | An export by the user or your code. See Export. |
| URL state | The sort by default. The filter values and the search text when spec lists them. The page, the page size, and the column layout | useDataGridUrlState and useDataGridUrlPagination. See URL state. |
| Saved views | Named sorts, filters, search text, and layouts | DataGridViews writes them to localStorage of the origin by default. See Saved views. |
| Cell links | The link of a url cell, opened in a new tab without a referrer | A click on the link. |
A URL keeps its query in the browser history, in server logs, and in the Referer header of the next request. The default spec keeps filters and search text out of the URL. Add "filter" and "search" only when they cannot hold personal data.