Mercurial > libervia-backend
view doc/libervia-cli/account.rst @ 4044:3900626bc100
plugin XEP-0166: refactoring, and various improvments:
- add models for transport and applications handlers and linked data
- split models into separate file
- some type hints
- some documentation comments
- add actions to prepare confirmation, useful to do initial parsing of all contents
- application arg/kwargs and some transport data can be initialised during Jingle
`initiate` call, this is notably useful when a call is made with transport data (this is
the call for A/V calls where codecs and ICE candidate can be specified when starting a
call)
- session data can be specified during Jingle `initiate` call
- new `store_in_session` argument in `_parse_elements`, which can be used to avoid
race-condition when a context element (<decription> or <transport>) is being parsed for
an action while an other action happens (like `transport-info`)
- don't sed `sid` in `transport_elt` during a `transport-info` action anymore in
`build_action`: this is specific to Jingle File Transfer and has been moved there
rel 419
author | Goffi <goffi@goffi.org> |
---|---|
date | Mon, 15 May 2023 16:23:11 +0200 |
parents | 267e4987b58b |
children |
line wrap: on
line source
================================ account: XMPP account management ================================ ``account`` command help you to create or manage the XMPP account of a server, using In-Band Registration (`XEP-0077`_). .. _XEP-0077: https://xmpp.org/extensions/xep-0077.html create ====== Create a XMPP account. You have to specify your jid and password as positional arguments. By default the registration is done on ``localhost`` with default XMPP Client 2 Server port (i.e. 5222), but you can specify other host/port using ``-H HOST, --host HOST`` and ``-P PORT, --port PORT``. You may also specify an e-mail address using ``-e EMAIL, --email EMAIL`` (use of this data depend of the server implementation). By default, no Libervia profile is created and associated to this new XMPP account, but you can use ``-p PROFILE, --profile PROFILE`` if you are willing to have one. example ------- Create account for the new user Nestor at ``nestor@example.org`` and associate it with the Libervia profile ``nestor``:: $ li account create nestor@example.org some_password -p nestor modify ====== Modify an existing XMPP account password. This will modify the XMPP account linked to the given profile. .. note:: Only the XMPP password on the server is changed, not the one registered in the parameter of Libervia. You may have to update the parameter of your profile if the new password doesn't correspond to your parameters one (you can do that with li param set or with most Libervia frontends in parameters). example ------- Change the XMPP password of the XMPP account of the default profile:: $ li account modify new_password delete ====== Delete the XMPP account linked to the given profile from the XMPP server. Before using this command, please be sure to understand well that **THIS WILL REMOVE THE WHOLE XMPP ACCOUNT AND DATA FROM THE XMPP SERVER**. By default a confirmation is requested, you can do this without confirmation by using ``-f, --force``, however this is **NOT RECOMMENDED**, be sure to understand what you're doing if you use this option (and be sure to spell correctly the profile, if you forget the ``-p PROFILE, --profile`` argument for instance, this would delete entirely the default profile). .. note:: Be extra careful with this command, as it will remove the whole account from the server, and the associated data. example ------- Delete the XMPP account of Pierre, which is not on the local server anymore:: $ li account delete -p pierre