Skip to content
/ ep_guest Public

Etherpad plugin to grant limited access to users that are not logged in.

License

Notifications You must be signed in to change notification settings

ether/ep_guest

Repository files navigation

Publish Status Backend Tests Status

ep_guest

Screenshot

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 to true to enable this plugin.
  • ep_guest.username (optional, defaults to "guest"): The username used for the guest account. The corresponding object in the users setting (see below) contains settings for the guest account.
  • users[ep_guest.username] (optional, default is described below): Object in users that holds settings for the guest account. Relevant properties:

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.

About

Etherpad plugin to grant limited access to users that are not logged in.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published