Awesome
ep_guest
Etherpad plugin that grants limited access to users that are not logged in via another authentication plugin such as ep_openid_connect.
When a user first visits Etherpad, they will be "authenticated" as a guest user with permissions configured by the administrator. A "log in" button in the user drop-down list forces the user to authenticate via Etherpad's built-in HTTP basic authentication or via an authentication plugin (if one is installed). After logging in, the "log in" button becomes a "log out" button.
This is a fork of ep_readonly_guest that allows admins to relax that plugin's read-only restriction.
Configuration
Minimal Example
"requireAuthentication": true,
Full Example
The following is equivalent to the above minimal example:
"requireAuthentication": true,
"ep_guest": {
"username": "guest"
},
"users": {
"guest": {
"displayname": "Read-Only Guest",
"displaynameChangeable": false,
"readOnly": true
}
},
Details
requireAuthentication
: Must be explicitly set totrue
to enable this plugin.ep_guest.username
(optional, defaults to"guest"
): The username used for the guest account. The corresponding object in theusers
setting (see below) contains settings for the guest account.users[ep_guest.username]
(optional, default is described below): Object inusers
that holds settings for the guest account. Relevant properties:displayname
(optional): See the ep_user_displayname plugin.displaynameChangeable
(optional): See the ep_user_displayname plugin.readOnly
(optional): See Etherpad'ssettings.json
documentation.canCreate
(optional): See Etherpad'ssettings.json
documentation.
Default guest user settings
If settings.json
(or another plugin) does not define a user object for the
guest user, an object like the following is used:
{
"displayname": "Read-Only Guest",
"displaynameChangeable": false,
"readOnly": true
}
Copyright and License
Copyright © 2022 the ep_guest authors and contributors
Copyright © 2020–2022 the ep_reaonly_guest authors and contributors
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.