75 lines
2.5 KiB
ReStructuredText
75 lines
2.5 KiB
ReStructuredText
================================
|
|
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
|