OpenVPN / OpenVPN/openvpn

FAQ entry for TLS error is incomplete and misleading

Open
#429 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

website
Dominant language
C
Stars
14.6k
Forks
3.4k
PR merge metrics
No merged PRs in 30d

Description

https://openvpn.net/faq/tls-error-tls-key-negotiation-failed-to-occur-within-60-seconds-check-your-network-connectivity/

tells me in 5 different ways that I'm having a connection issue when I get the error message "TLS Error: TLS key negotiation failed to occur within 60 seconds (check your network connectivity)"

Another option however could be a configuration issue on the client side, for example simply missing the auth directive. This happens easily e.g. due to exporting openvpn config from network manager.

I would thus suggest to extend the FAQ page and also point to possible configuration errors.

If this is the wrong bug tracker to report documentation issues, please point me to the correct reporting tool.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the linked OpenVPN FAQ page and the reported TLS negotiation error, then confirm where FAQ documentation changes should be reported. Review the existing explanation and the auth directive example; done means the entry also identifies relevant client-side configuration errors rather than only network connectivity.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.