Skip to content

Commit 1b15cc9

Browse files
committed
Add user help on TLS 1.0/1.1 deprecation
Add context and instructions for users affected by the TLS 1.0/1.1 deprecation. Followup to #3411, #3293.
1 parent 12603b0 commit 1b15cc9

File tree

1 file changed

+11
-1
lines changed

1 file changed

+11
-1
lines changed

warehouse/templates/pages/help.html

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,12 +30,13 @@
3030
{% macro project_release_notifications() %}How do I get notified when a new version of a project is released?{% endmacro %}
3131
{% macro statistics() %}Where can I see statistics about PyPI, downloads, and project/package usage?{% endmacro %}
3232
{% macro login_problem() %}I forgot my PyPI password. Can you help me?{% endmacro %}
33+
{% macro tls_deprecation() %}Why am I getting "No matching distribution found" or "Could not fetch URL" errors during <tt>pip install</tt>?{% endmacro %}
3334
{% macro accessibility() %}I am having trouble using the PyPI website. Can you help me?{% endmacro %}
3435
{% macro uploading() %}Why can't I upload files to PyPI manually?{% endmacro %}
3536
{% macro private_indices() %}How can I publish my private packages to PyPI?{% endmacro %}
3637
{% macro admin_intervention() %}Why did my package or user registration get blocked?{% endmacro %}
3738
{% macro file_size_limit() %}How do I get a file size limit exemption or increase for my project?{% endmacro %}
38-
{% macro file_name_reuse() %}Why am I getting a "Filename or contents already exists" or "Filename has been previously used" errors?{% endmacro %}
39+
{% macro file_name_reuse() %}Why am I getting a "Filename or contents already exists" or "Filename has been previously used" error?{% endmacro %}
3940
{% macro project_name() %}Why isn't my desired project name available?{% endmacro %}
4041
{% macro project_name_claim() %}How do I claim an abandoned or previously registered project name?{% endmacro %}
4142
{% macro new_classifier() %}How do I request a new trove classifier?{% endmacro %}
@@ -77,6 +78,7 @@ <h2><a href="#integrating">Integrating</a></h2>
7778
<h2><a href="#problems">Problems</a></h2>
7879
<ul>
7980
<li><a href="#login-problem">{{ login_problem() }}</a></li>
81+
<li><a href="#tls-deprecation">{{ tls_deprecation() }}</a></li>
8082
<li><a href="#accessibility">{{ accessibility() }}</a></li>
8183
<li><a href="#uploading">{{ uploading() }}</a></li>
8284
<li><a href="#private-indices">{{ private_indices() }}</a></li>
@@ -183,6 +185,14 @@ <h3 id="login-problem">{{ login_problem() }}</h3>
183185
</p>
184186
{{ code_of_conduct() }}
185187

188+
<h3 id="tls-deprecation">{{ tls_deprecation() }}</h3>
189+
<p>
190+
Transport Layer Security, or TLS, is part of how we make sure connections between your computer and PyPI are private and secure. It's a cryptographic protocol that's had several versions over time. PyPI <a href="https://mail.python.org/pipermail/python-announce-list/2018-April/011885.html">turned off support for TLS versions 1.0 and 1.1</a> in April 2018 (<a href="https://pyfound.blogspot.com/2017/01/time-to-upgrade-your-python-tls-v12.html">reason</a>). If you are having trouble with <tt> pip install</tt> and get a <tt>No matching distribution found</tt> or <tt>Could not fetch URL</tt> error, try adding <tt>-v</tt> to the command to get more information:
191+
</p>
192+
<p><tt>pip install --upgrade -v pip</tt>
193+
</p>
194+
<p>If you see an error like <tt>There was a problem confirming the ssl certificate</tt> or <tt>tlsv1 alert protocol version</tt> or <tt>TLSV1_ALERT_PROTOCOL_VERSION</tt>, you will probably need to <a href="https://pip.pypa.io/en/latest/installing/">upgrade your version of <tt>pip</tt></a> to 9.0.3 or above, which will use a more recent version of TLS. For more details, see <a href="https://mail.python.org/pipermail/python-announce-list/2018-April/011885.html">the announcement post</a> and <a href="https://github.com/pypa/warehouse/issues/3293#issuecomment-378468534">this GitHub issue</a>.</p>
195+
186196
<h3 id="accessibility">{{ accessibility() }}</h3>
187197
<p>
188198
We take <a href="https://en.wikipedia.org/wiki/Web_accessibility" target="_blank" rel="noopener">accessibility</a> very seriously and want to make the website easy to use for everyone.

0 commit comments

Comments
 (0)