密码保护阅读thedocs.org 文档

Question

我在 readthedocs.org 上管理着一份文档。有没有办法进行密码保护或至少使我们的文档仅对部分客户可用？

Answer 1

不幸的是，阅读文档上托管的文档无法受密码保护。

（到目前为止）您能做的最好的事情就是将您的文档设置为“私有”，当用户从 www.readthedocs.org 网站导航到您的文档时，将向他们显示 404。然而，这种安全性极其薄弱，因为任何拥有实际 URL 的人仍然可以查看您的文档。

来自他们的文档：

通过 URL 查看实际文档，甚至私人文档也可以查看。这是因为我们的架构没有对文档显示做任何逻辑，以提高可用性。

但是，您可以自己托管 Sphinx 生成的文档，并且 您可以使用密码保护。我想说这绝对是你最好的选择！

阅读文档实际上只是一种便利的托管服务，您仍然可以在其他地方托管文档，然后轻松地对其进行密码保护，就像用密码保护其他任何内容一样。

更新

顺便说一句，最简单的方法就是生成静态 .html 文件 - 使用根文件夹中的

make html

。将这些 HTML 文件放在内部托管的 Web 服务器上就可以了:)

Answer 2

这实际上可以在 readthedocs 的商业版中找到。您可以在以下页面中阅读更多相关信息：

1. https://docs.readthedocs.io/en/stable/commercial/sharing.html
2. https://about.readthedocs.com/pricing/

从我链接的第一页逐字粘贴：

Go into your project’s Admin page and click on Sharing.

Click on New Share

Select access type (secret link, password, or HTTP header token), add an expiration date and a Description to help with managing access in the future.

Check Allow access to all versions? if you want to grant access to all versions, or uncheck that option and select the specific versions you want grant access to.

Click Save.

Get the info needed to share your documentation with other users:

    Secret link: copy the link that is generated

    Password: copy the link and password

    HTTP header token: Copy the token, and then pass the Authorization header in your HTTP request.

Give that information to the person who you want to give access.