From: Łukasz Langa <lukasz@langa.pl>
Date: Fri, 1 Jul 2022 16:50:36 +0000 (+0200)
Subject: [3.7] gh-81054: Document that SimpleHTTPRequestHandler follows symbolic links (GH... 
X-Git-Tag: v3.7.14~11
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=239b2d9b4703ea5301dab698fe922de997973476;p=thirdparty%2FPython%2Fcpython.git

[3.7] gh-81054: Document that SimpleHTTPRequestHandler follows symbolic links (GH-94416) (GH-94496)

(cherry picked from commit 80aaeabb8bd1e6b49598a7e23e0f8d99b3fcecaf)

Co-authored-by: Sam Ezeh <sam.z.ezeh@gmail.com>
---

diff --git a/Doc/library/http.server.rst b/Doc/library/http.server.rst
index 7e317cd8bc2b..a93362d96f13 100644
--- a/Doc/library/http.server.rst
+++ b/Doc/library/http.server.rst
@@ -19,7 +19,7 @@ This module defines classes for implementing HTTP servers (Web servers).
 .. warning::
 
     :mod:`http.server` is not recommended for production. It only implements
-    basic security checks.
+    :ref:`basic security checks <http.server-security>`.
 
 One class, :class:`HTTPServer`, is a :class:`socketserver.TCPServer` subclass.
 It creates and listens at the HTTP socket, dispatching the requests to a
@@ -470,3 +470,14 @@ the following command uses a specific directory::
 the ``--cgi`` option::
 
         python -m http.server --cgi 8000
+
+.. _http.server-security:
+
+Security Considerations
+-----------------------
+
+.. index:: pair: http.server; security
+
+:class:`SimpleHTTPRequestHandler` will follow symbolic links when handling
+requests, this makes it possible for files outside of the specified directory
+to be served.