Skip to content

Commit

Permalink
Add user help on TLS 1.0/1.1 deprecation
Browse files Browse the repository at this point in the history
Add context and instructions for users affected by the
TLS 1.0/1.1 deprecation.

Followup to #3411, #3293.
  • Loading branch information
brainwane committed Apr 17, 2018
1 parent 3b4ffd8 commit 56e945d
Showing 1 changed file with 13 additions and 1 deletion.
14 changes: 13 additions & 1 deletion warehouse/templates/pages/help.html
Original file line number Diff line number Diff line change
Expand Up @@ -30,12 +30,13 @@
{% macro project_release_notifications() %}How do I get notified when a new version of a project is released?{% endmacro %}
{% macro statistics() %}Where can I see statistics about PyPI, downloads, and project/package usage?{% endmacro %}
{% macro login_problem() %}I forgot my PyPI password. Can you help me?{% endmacro %}
{% macro tls_deprecation() %}Why am I getting "No matching distribution found" or "Could not fetch URL" errors during <tt>pip install</tt>?{% endmacro %}
{% macro accessibility() %}I am having trouble using the PyPI website. Can you help me?{% endmacro %}
{% macro uploading() %}Why can't I upload files to PyPI manually?{% endmacro %}
{% macro private_indices() %}How can I publish my private packages to PyPI?{% endmacro %}
{% macro admin_intervention() %}Why did my package or user registration get blocked?{% endmacro %}
{% macro file_size_limit() %}How do I get a file size limit exemption or increase for my project?{% endmacro %}
{% macro file_name_reuse() %}Why am I getting a "Filename or contents already exists" or "Filename has been previously used" errors?{% endmacro %}
{% macro file_name_reuse() %}Why am I getting a "Filename or contents already exists" or "Filename has been previously used" error?{% endmacro %}
{% macro project_name() %}Why isn't my desired project name available?{% endmacro %}
{% macro project_name_claim() %}How do I claim an abandoned or previously registered project name?{% endmacro %}
{% macro new_classifier() %}How do I request a new trove classifier?{% endmacro %}
Expand Down Expand Up @@ -77,6 +78,7 @@ <h2><a href="#integrating">Integrating</a></h2>
<h2><a href="#problems">Problems</a></h2>
<ul>
<li><a href="#login-problem">{{ login_problem() }}</a></li>
<li><a href="#tls-deprecation">{{ tls_deprecation() }}</a></li>
<li><a href="#accessibility">{{ accessibility() }}</a></li>
<li><a href="#uploading">{{ uploading() }}</a></li>
<li><a href="#private-indices">{{ private_indices() }}</a></li>
Expand Down Expand Up @@ -183,6 +185,16 @@ <h3 id="login-problem">{{ login_problem() }}</h3>
</p>
{{ code_of_conduct() }}

<h3 id="tls-deprecation">{{ tls_deprecation() }}</h3>
<p>
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" target="_blank" rel="noopener">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" target="_blank" rel="noopener">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:
</p>
<p><tt>pip install --upgrade -v pip</tt>
</p>
<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 need to be connecting to PyPI with a newer TLS support library. The specific steps you need to take will depend on your operating system version, where your installation of Python originated (python.org, your OS vendor, or an intermediate distributor), and the installed versions of Python and <tt>pip</tt>. For help, please go to <a href="https://webchat.freenode.net/?channels=%23pypa" target="_blank" rel="noopener">the <tt>#pypa</tt> IRC channel on Freenode</a>, file an issue at <a href="https://github.com/pypa/packaging-problems/issues" target="_blank" rel="noopener">pypa/packaging-problems/issues</a>, or <a href="https://www.python.org/community/lists/" target="_blank" rel="noopener">post to the python-help mailing list</a>, including your OS and installation details and the output of <tt>pip install -vvv upgrade pip</tt>.
</p>
{{ code_of_conduct() }}

<h3 id="accessibility">{{ accessibility() }}</h3>
<p>
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.
Expand Down

0 comments on commit 56e945d

Please sign in to comment.