From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Thu, 6 Jan 2022 23:18:18 +0000 (-0800)
Subject: [3.9] bpo-46251: Add 'Security Considerations' section to logging configura… (GH... 
X-Git-Tag: v3.9.10~15
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=188fbdee0d6721a948eabb81cdcacac371614793;p=thirdparty%2FPython%2Fcpython.git

[3.9] bpo-46251: Add 'Security Considerations' section to logging configura… (GH-30411) (GH-30448)
---

diff --git a/Doc/library/logging.config.rst b/Doc/library/logging.config.rst
index d4dc585351ba..afc32e64bc79 100644
--- a/Doc/library/logging.config.rst
+++ b/Doc/library/logging.config.rst
@@ -186,6 +186,20 @@ in :mod:`logging` itself) and defining handlers which are declared either in
    :func:`listen`.
 
 
+Security considerations
+^^^^^^^^^^^^^^^^^^^^^^^
+
+The logging configuration functionality tries to offer convenience, and in part this
+is done by offering the ability to convert text in configuration files into Python
+objects used in logging configuration - for example, as described in
+:ref:`logging-config-dict-userdef`. However, these same mechanisms (importing
+callables from user-defined modules and calling them with parameters from the
+configuration) could be used to invoke any code you like, and for this reason you
+should treat configuration files from untrusted sources with *extreme caution* and
+satisfy yourself that nothing bad can happen if you load them, before actually loading
+them.
+
+
 .. _logging-config-dictschema:
 
 Configuration dictionary schema