PLUGIN_HOWTO@fdb68b9b02b8
PLUGIN_HOWTO
Sat, 25 Nov 2017 21:42:28 +0800
- author
- Tom Li <tomli@tomli.me>
- date
- Sat, 25 Nov 2017 21:42:28 +0800
- branch
- release-2.x.y
- changeset 38792
- fdb68b9b02b8
- parent 28289
- ae4cf144214c
- child 33955
- 55aa58076485
- permissions
- -rw-r--r--
jabber.c: fix #17270, ignore STARTTLS when using BOSH.
Pidgin wants to establish a TLS connection with a STARTTLS request, but
it doesn't make any sense, since the XMPP stream is proxied by the BOSH
connection, which is already encrypted by HTTPS. It is impossible to
STARTTLS with BOSH.
According to XEP-0206: The client SHOULD ignore any Transport Layer Security
(TLS) feature since BOSH channel encryption SHOULD be negotiated at the HTTP
layer.
Failing to do it causes Pidgin fails to create any connection with BOSH to any
XMPP server with STARTTLS enabled.
https://developer.pidgin.im/ticket/17270
For information on writing a plugin for Purple, Pidgin or Finch, go http://developer.pidgin.im and click on API. From there, see the HOWTOs in the "Related Pages" section. You can also generate this documentation locally by installing doxygen and graphviz dot, then running "make docs" in the source tree. The documentation will be in the docs/html directory.
