diff --git a/documentation/extensions/tokenreconnection.md b/documentation/extensions/tokenreconnection.md new file mode 100644 index 0000000000..ccfa9c3617 --- /dev/null +++ b/documentation/extensions/tokenreconnection.md @@ -0,0 +1,50 @@ +Token-based reconnection +======================== + +Allows to manage communications blocking. + + * Login with token + * Get tokens + * Get last refresh token from "success" nonza + * Avoid reconnection using token + + +**XEP related:** [XEP-xxxx](http://www.xmpp.org/extensions/inbox/token-reconnection.html) + + +Login with token +---------------- + +``` +xmppConnection.login(token, resourcepart); +``` +*token* is a `String` + +*resourcepart* is a `Resourcepart` + + +Get tokens +---------- + +``` +TBRManager tbrManager = TBRManager.getInstanceFor(xmppConnection); +TBRTokens tbrTokens = tbrManager.getTokens(); +String accessToken = tbrTokens.getAccessToken(); +String refreshToken = tbrTokens.getRefreshToken(); +``` + + +Get last refresh token from "success" nonza +------------------------------------------- + +``` +String refreshToken = xmppConnection.getXOAUTHLastRefreshToken(); +``` + + +Avoid reconnection using token +------------------------------ + +``` +xmppConnection.avoidTokenReconnection(); +```