POE::Component::Jabber::XMPP.3pm

Langue: en

Autres versions - même langue

Version: 2008-11-14 (ubuntu - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

POE::Component::Jabber::XMPP - connect using the XMPP Jabber protocol

SYNOPSIS

This is a Protocol implementation for the specifics in the XMPP protocol during connection initialization.

DESCRIPTION

PCJ::XMPP provides all the mechanisms to negotiate TLS, SASL, resource binding, and session negotiation that PCJ needs to successfully establish an XMPP connection. In essence, it implements XMPP Core and a smidgeon of XMPP IM.

METHODS

Please see PCJ::Protocol for what methods this class supports.

EVENTS

Listed are the exported events that make their way into the PCJ session:
set_auth
This handles the initial SASL authentication portion of the XMPP connection.
init_input_handler
This is our entry point. This is what PCJ uses to deliver events to us.
build_tls_wheel
If TLS is required by the server, this is where that negotiation process happens.
challenge_response
This handles the subsequent SASL authentication steps.
binding
This handles the resource binding
session_establish
This handles session binding.

NOTES AND BUGS

Currently, only DIGEST-MD5 and PLAIN SASL mechanisms are supported. Server implementations are free to include more strigent mechanisms, but these are the bare minimum required. (And PLAIN isn't /really/ allowed by the spec, but it is included because it was a requested feature)

Also, XEP-77 (in-band registration) is NOT supported, but is planned for the next release. Until then, authentication failures are treated as fatal and PCJ will shutdown.

AUTHOR

Copyright (c) 2003-2007 Nicholas Perez. Distributed under the GPL.