Accounts

an mqtt account is the credential an external client uses to connect to the message broker in litmus unify only accounts that exist here can connect, and what an account is allowed to publish or subscribe to is set by the rules attached to it the accounts page lists every account, shows how many clients are connected under each one, and is where you create, disable, and remove them access accounts ui to access the accounts page navigate to mqtt > accounts account types type description general a standard account for any mqtt client you create it with add account and give it a name unify generates the password litmus an account for a litmus edge instance rather than a username and password for each device, litmus edge connects with an activation token that you generate with le activation token accounts list column description account name name of the account select it to open the account and manage its rules # of clients number of clients currently connected using this account one account can carry more than one client type general or litmus rules topic rules attached to the account an account with no rule can connect but cannot publish or subscribe enabled whether the account can connect a disabled account is rejected at connection time and keeps its rules and history action menu of the same operations available on the account details page account details select an account name to open mqtt account details the page shows which clients are connected with the account, which rules are attached to it, and the operations you can run against it account operations operation description reset password generates a new password copy it before you close the dialog, because it is not shown again any client using the old password stops connecting disable account blocks the account from connecting and keeps its rules select enable account to restore it delete account removes the account and its rules clients using it can no longer connect clients lists the clients connected with this account's credentials an account with nothing connected shows clients not found , which is the expected state for an account that is configured but not yet in use for the full connection list across all accounts, see clients docid\ n5cm8lbsdifvdelulw397 rules lists the topic rules attached to the account, with a topic and a permission for each select add rule to add one a new account shows rules not found you can add a new rule until a rule exists, the account can open a connection and nothing else rules and permissions a new account can connect to the broker and nothing more it has no publish or subscribe permission until you give it a rule a rule pairs a topic with a permission the topic can be a single path or a wildcard, so # grants the account every topic the permission is deny, publish, subscribe, or publish & subscribe an account can hold several rules, and you manage them from the account itself considerations passwords are shown once, when the account is created if it is lost, reset the password rather than recreating the account, because a new account starts with no rules related topics mqtt docid\ e9hyekwrmj2z17c27qn49 mqtt client docid\ x3mnmik1x4dhim8yxffkd