view doc/libervia-cli/account.rst @ 3942:a92eef737703

plugin XEP-0373: download public keys if they are not found in local storage: public keys were only obtained from PEP notifications, however this wasn't working if the entity was not in our roster. Now if no public key is retrieved from local storage, the public key node is requested, and an error is raised if nothing is found. This allows the use of OX with entities which are not in roster. rel 380
author Goffi <goffi@goffi.org>
date Sat, 15 Oct 2022 20:38:33 +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