Merge pull request #84 from snikket-im/docs/add-user-roles-page
docs: Add page about user roles
This commit is contained in:
commit
8c506217d5
|
@ -0,0 +1,53 @@
|
||||||
|
---
|
||||||
|
title: User roles
|
||||||
|
---
|
||||||
|
|
||||||
|
# User roles
|
||||||
|
|
||||||
|
Snikket allows you to select a role for users, each role granting different
|
||||||
|
permissions.
|
||||||
|
|
||||||
|
Each user may have one of three roles:
|
||||||
|
|
||||||
|
## Administrator
|
||||||
|
|
||||||
|
This is the default role of the first user (if you're reading this, that's
|
||||||
|
probably you!).
|
||||||
|
|
||||||
|
Administrators have full control over the server, settings, users and circles.
|
||||||
|
These features can be accessed primarily through the admin panel in the
|
||||||
|
Snikket web interface.
|
||||||
|
|
||||||
|
## Normal
|
||||||
|
|
||||||
|
This is the default role for most users. It gives access to all
|
||||||
|
non-administrative server functionality.
|
||||||
|
|
||||||
|
## Limited
|
||||||
|
|
||||||
|
Limited users have various restrictions. The purpose of this role is to
|
||||||
|
allow granting someone an account on the server, only for the purposes of
|
||||||
|
communicating with other people on that server. This can be useful to provide
|
||||||
|
a guest or child account, for example.
|
||||||
|
|
||||||
|
In particular, limited users are not allowed to:
|
||||||
|
|
||||||
|
- Communicate with users on other servers
|
||||||
|
- Join group chats on other servers
|
||||||
|
- Create public channels (including on the current server)
|
||||||
|
- Invite new users to the server (regardless of whether this is enabled for
|
||||||
|
normal users).
|
||||||
|
|
||||||
|
### Caveats
|
||||||
|
|
||||||
|
The current support for limited users has some known issues. It is designed to
|
||||||
|
prevent casual misuse of the server, but it is not intended to be a foolproof
|
||||||
|
security measure. For example, limited users are still able to *receive*
|
||||||
|
messages and contact requests from other servers, even though they cannot send
|
||||||
|
them to other servers. It is expected that we will restrict incoming traffic
|
||||||
|
for limited users in a future release, after further testing.
|
||||||
|
|
||||||
|
Also note that limited accounts may have issues using non-Snikket mobile apps
|
||||||
|
that use push notifications, depending on the design of the app. This is
|
||||||
|
because the restrictions may prevent the app communicating with its'
|
||||||
|
developer's push notification services over XMPP.
|
Loading…
Reference in New Issue