doc/certificate-signals.dox@fdb68b9b02b8
doc/certificate-signals.dox
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 20897
- 2608e9e07913
- 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
/** @page certificate-signals Certificate Signals @signals @signal certificate-stored @signal certificate-deleted @endsignals @see certificate.h <hr> @signaldef certificate-stored @signalproto void (*certificate_stored)(PurpleCertificatePool *pool, const gchar *id, gpointer data); @endsignalproto @signaldesc Emitted when a pool stores a certificate. Connect to the pool instance. @param pool Pool the certificate has been stored into @param id Key the certificate was stored under @endsignaldef @signaldef certificate-deleted @signalproto void (*certificate_deleted)(PurpleCertificatePool *pool, const gchar *id, gpointer data); @endsignalproto @signaldesc Emitted when a pool deletes a certificate. Connect to the pool instance. @param pool Pool the certificate was deleted from @param id Key that was deleted @endsignaldef */ // vim: syntax=c.doxygen tw=75 et
