Nodeschool Public Materials
    Severity: high

    Arbitrary File Creation/Overwrite via insufficient symlink protection due to directory cache poisoning using symbolic links




    Arbitrary File Creation, Arbitrary File Overwrite, Arbitrary Code Execution

    node-tar aims to guarantee that any file whose location would be modified by a symbolic link is not extracted. This is, in part, achieved by ensuring that extracted directories are not symlinks. Additionally, in order to prevent unnecessary stat calls to determine whether a given path is a directory, paths are cached when directories are created.

    This logic was insufficient when extracting tar files that contained two directories and a symlink with names containing unicode values that normalized to the same value. Additionally, on Windows systems, long path portions would resolve to the same file system entities as their 8.3 "short path" counterparts. A specially crafted tar archive could thus include directories with two forms of the path that resolve to the same file system entity, followed by a symbolic link with a name in the first form, lastly followed by a file using the second form. It led to bypassing node-tar symlink checks on directories, essentially allowing an untrusted tar file to symlink into an arbitrary location and subsequently extracting arbitrary files into that location, thus allowing arbitrary file creation and overwrite.

    The v3 branch of node-tar has been deprecated and did not receive patches for these issues. If you are still using a v3 release we recommend you update to a more recent version of node-tar. If this is not possible, a workaround is available below.


    6.1.9 || 5.0.10 || 4.4.18


    Users may work around this vulnerability without upgrading by creating a custom filter method which prevents the extraction of symbolic links.

    const tar = require('tar')
      file: 'archive.tgz',
      filter: (file, entry) => {
        if (entry.type === 'SymbolicLink') {
          return false
        } else {
          return true

    Users are encouraged to upgrade to the latest patched versions, rather than attempt to sanitize tar input themselves.


    The problem is addressed in the following ways, when comparing paths in the directory cache and path reservation systems:

    1. The String.normalize('NFKD') method is used to first normalize all unicode to its maximally compatible and multi-code-point form.
    2. All slashes are normalized to / on Windows systems (on posix systems, \ is a valid filename character, and thus left intact).
    3. When a symbolic link is encountered on Windows systems, the entire directory cache is cleared. Collisions related to use of 8.3 short names to replace directories with other (non-symlink) types of entries may make archives fail to extract properly, but will not result in arbitrary file writes.


    Upgrade to versions 4.4.18, 5.0.10, 6.1.9 or later


    Have content suggestions? Visit

    Advisory timeline

    1. published

      Advisory Published
      Aug 31st, 2021
    2. reported

      Reported by Anonymous
      Aug 31st, 2021