Skip to content

Commit 9dd2599

Browse files
committed
Address review comments
1 parent 9c25cab commit 9dd2599

1 file changed

Lines changed: 24 additions & 12 deletions

File tree

security/policy.rst

Lines changed: 24 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,17 +2,20 @@
22
Security policy
33
===============
44

5-
:ref:`Python Security Response Team <psrt>` (PSRT) members balance this work against
6-
many other responsibilities. Please be thoughtful about the time and attention
7-
your report requires. Repeated failure to respect the security policy will
8-
result in future reports being rejected, or the reporter being banned from the
9-
``python`` GitHub organization, regardless of technical merit.
5+
.. important::
6+
7+
:ref:`Python Security Response Team <psrt>` (PSRT) members balance this work
8+
against many other responsibilities. Please be thoughtful about the time and
9+
attention your report requires. Repeated failure to respect the security policy
10+
will result in future reports being rejected, or the reporter being banned
11+
from the ``python`` GitHub organization, regardless of technical merit.
1012

1113
What types of bugs are vulnerabilities?
1214
---------------------------------------
1315

14-
Not all bugs are vulnerabilities. To avoid causing
15-
duplicate work for PSRT members, all potential reports
16+
**Not all bugs are vulnerabilities.**
17+
18+
To avoid causing duplicate work for PSRT members, **all potential** reports
1619
must be evaluated against the relevant threat models
1720
prior to being submitted to the PSRT.
1821
Where possible, cite the relevant threat model to show that
@@ -21,9 +24,9 @@ to report a bug as a vulnerability.
2124

2225
Vulnerabilities must be exploitable from code, configurations,
2326
pre-conditions, or deployments that may exist in the real world.
24-
For example, a vulnerability only affecting code
25-
that does not make sense in a production program
26-
will not be accepted as a vulnerability.
27+
A vulnerability that only affecting code
28+
unlikely to be used in a production program
29+
will not be accepted.
2730

2831
Documented functionality is not considered a vulnerability.
2932
For example, :mod:`pickle`, :mod:`marshal`, :mod:`shelve`, :func:`eval`,
@@ -71,7 +74,16 @@ Instead, open a public GitHub issue.
7174
If a vulnerability is platform-dependent, check if the platform is
7275
supported per :pep:`11`.
7376
Vulnerabilities that exclusively affect unsupported platforms
74-
may not be accepted.
77+
are not treated as vulnerabilities in Python.
78+
79+
As per the :pep:`Unsupported Platforms section of PEP 11 <11#unsupported-platforms>`,
80+
porting Python to an unsupported platform is treated as a third-party project.
81+
If you choose to report such a vulnerability to Python, please follow the
82+
requirements of this guide. Note that these reports may be shared with
83+
parties who expressed interested in the relevant platforms and will
84+
generally be handled according to the relevant maintainers' security
85+
policies. These reports may closed if the maintainers are unknown or
86+
unresponsive.
7587

7688
What to include and how to structure a vulnerability report?
7789
------------------------------------------------------------
@@ -82,7 +94,7 @@ be formatted correctly:
8294

8395
* For the initial report and follow-up communications, avoid
8496
overly long, verbose, or excessive structure (such as headers or tables).
85-
Ideally reports should be a few sentences describing the vulnerability and
97+
Reports should be a few sentences describing the vulnerability. Ideally include
8698
a proof-of-concept script that reproduces the issue and provides a clear
8799
indication of whether the vulnerability is still present (such as exiting with
88100
``1`` if vulnerable and ``0`` if not vulnerable).

0 commit comments

Comments
 (0)