Document support for .ovpn

This commit is contained in:
Davide De Rosa 2018-11-10 10:24:05 +01:00
parent 0302803d3e
commit ac9ce0dba2
1 changed files with 25 additions and 1 deletions

View File

@ -11,7 +11,7 @@ This library provides a simplified Swift/Obj-C implementation of the OpenVPN® p
## Getting started ## Getting started
The client is known to work with [OpenVPN®][openvpn] 2.3+ servers. Key renegotiation and replay protection are also included, but full-fledged configuration files (.ovpn) are not currently supported. The client is known to work with [OpenVPN®][openvpn] 2.3+ servers.
- [x] Handshake and tunneling over UDP or TCP - [x] Handshake and tunneling over UDP or TCP
- [x] Ciphers - [x] Ciphers
@ -32,10 +32,34 @@ The client is known to work with [OpenVPN®][openvpn] 2.3+ servers. Key renegoti
- Disabled - Disabled
- Compress (2.4) - Compress (2.4)
- LZO (deprecated in 2.4) - LZO (deprecated in 2.4)
- [x] Key renegotiation
- [x] Replay protection (hardcoded window) - [x] Replay protection (hardcoded window)
The library therefore supports compression framing, just not compression. Remember to match server-side compression framing in order to avoid a confusing loss of data packets. E.g. if server has `comp-lzo no`, client must use `compressionFraming = .compLZO`. The library therefore supports compression framing, just not compression. Remember to match server-side compression framing in order to avoid a confusing loss of data packets. E.g. if server has `comp-lzo no`, client must use `compressionFraming = .compLZO`.
### Support for .ovpn configuration
TunnelKit can parse .ovpn configuration files. Below are a few limitations worth mentioning.
Unsupported:
- UDP fragmentation, i.e. `--fragment`
- Compression
- `--comp-lzo` other than `no`
- `--compress` other than empty
- Proxy
- External file references (inline `<block>` only)
- Encrypted client certificate keys
Ignored:
- MTU overrides
- `--*-mtu` and variants
- `--mssfix`
- Multiple `--remote` with different `host` values (first wins)
Many other flags are ignored too but it's normally not an issue.
## Installation ## Installation
### Requirements ### Requirements