|
| 1 | +"""Security models for the Python standard library (architecture §16).""" |
| 2 | + |
| 3 | +from __future__ import annotations |
| 4 | + |
| 5 | +from typing import ClassVar |
| 6 | + |
| 7 | +from coretrace_python.plugins import ModelPlugin |
| 8 | +from coretrace_python.semantic.symbols import SymbolId |
| 9 | +from coretrace_python.taint import Model, Sanitizer, Sink, Source, TaintKind |
| 10 | + |
| 11 | + |
| 12 | +def _sym(path: str) -> SymbolId: |
| 13 | + return SymbolId(f"python.{path}") |
| 14 | + |
| 15 | + |
| 16 | +class PythonStdlibModels(ModelPlugin): |
| 17 | + name: ClassVar[str] = "python-stdlib-models" |
| 18 | + models: ClassVar[tuple[Model, ...]] = ( |
| 19 | + Source(_sym("builtins.input"), "stdin"), |
| 20 | + Source(_sym("sys.stdin"), "stdin"), |
| 21 | + Source(_sym("sys.argv"), "argv"), |
| 22 | + Source(_sym("os.environ"), "environment"), |
| 23 | + Sink(_sym("os.system"), TaintKind.COMMAND), |
| 24 | + Sink(_sym("os.popen"), TaintKind.COMMAND), |
| 25 | + Sink(_sym("subprocess.run"), TaintKind.COMMAND), |
| 26 | + Sink(_sym("subprocess.call"), TaintKind.COMMAND), |
| 27 | + Sink(_sym("subprocess.check_call"), TaintKind.COMMAND), |
| 28 | + Sink(_sym("subprocess.check_output"), TaintKind.COMMAND), |
| 29 | + Sink(_sym("subprocess.Popen"), TaintKind.COMMAND), |
| 30 | + Sink(_sym("builtins.eval"), TaintKind.CODE), |
| 31 | + Sink(_sym("builtins.exec"), TaintKind.CODE), |
| 32 | + Sink(_sym("builtins.open"), TaintKind.PATH), |
| 33 | + Sink(_sym("os.remove"), TaintKind.PATH), |
| 34 | + Sink(_sym("os.unlink"), TaintKind.PATH), |
| 35 | + Sink(_sym("os.rmdir"), TaintKind.PATH), |
| 36 | + Sink(_sym("shutil.rmtree"), TaintKind.PATH), |
| 37 | + Sink(_sym("urllib.request.urlopen"), TaintKind.SSRF), |
| 38 | + Sanitizer(_sym("shlex.quote"), TaintKind.COMMAND), |
| 39 | + Sanitizer(_sym("html.escape"), TaintKind.HTML), |
| 40 | + Sanitizer(_sym("os.path.basename"), TaintKind.PATH), |
| 41 | + ) |
0 commit comments