Skip to content

Commit

Permalink
Last minute updates for 24.07 documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
badlop committed Jul 18, 2024
1 parent 3b38ed6 commit 0084a77
Show file tree
Hide file tree
Showing 6 changed files with 35 additions and 4 deletions.
4 changes: 1 addition & 3 deletions content/admin/configuration/listen.md
Original file line number Diff line number Diff line change
Expand Up @@ -536,9 +536,7 @@ It's possible to use OAuth for authentication instead of plain password, see
[OAuth Support](../../developer/ejabberd-api/oauth.md).

In ejabberd [20.03](../../archive/20.03/index.md) and older,
it was possible to configure `ejabberd_xmlrpc` as a
listener, see the old document for reference and example configuration:
[Listening Module](../../archive/old.md#listening_module).
it was possible to configure `ejabberd_xmlrpc` as a listener.

Just for reference, there's also the old
[`ejabberd_xmlrpc documentation`](https://ejabberd.im/ejabberd_xmlrpc)
Expand Down
1 change: 1 addition & 0 deletions content/admin/upgrade/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,7 @@ of the new ejabberd version if you need to update those tables yourself manually
The corresponsing ugprade notes are available in the release notes of each release,
and also available in the [Archive](../../archive/index.md) section:

- [Upgrading from ejabberd 24.06 to 24.07](../../archive/24.07/upgrade.md)
- [Upgrading from ejabberd 24.02 to 24.06](../../archive/24.06/upgrade.md)
- [Upgrading from ejabberd 23.10 to 24.02](../../archive/24.02/upgrade.md)
- [Upgrading from ejabberd 23.04 to 23.10](../../archive/23.10/upgrade.md)
Expand Down
2 changes: 1 addition & 1 deletion content/archive/24.07/listen.md
Original file line number Diff line number Diff line change
Expand Up @@ -543,7 +543,7 @@ It's possible to use OAuth for authentication instead of plain password, see
In ejabberd [20.03](../../archive/20.03/index.md) and older,
it was possible to configure `ejabberd_xmlrpc` as a
listener, see the old document for reference and example configuration:
[Listening Module](../../archive/../../admin/configuration/old.md#listening_module).
[Listening Module](../../archive/old.md#listening_module).

Just for reference, there's also the old
[`ejabberd_xmlrpc documentation`](https://ejabberd.im/ejabberd_xmlrpc)
Expand Down
20 changes: 20 additions & 0 deletions content/archive/24.07/upgrade.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# Upgrade to ejabberd 24.07

If you upgrade ejabberd from a previous release to [24.07](../../archive/24.07/index.md),
please update the ejabberd configuration file:

## <a name="webadmin-config"></a>WebAdmin API permissions configuration

The ejabberd 24.06 release notes announced the [Improved WebAdmin with commands usage](https://www.process-one.net/blog/ejabberd-24-06/#webadmin-commands), and mentioned some [`api_permissions` configuration details](https://www.process-one.net/blog/ejabberd-24-06/#webadmin-config), but it was not explicit enough about this fact: with the default ejabberd configuration, an admin was allowed to login in WebAdmin from any machine, but only was allowed to execute commands from the loopback IP address! The WebAdmin showed the page sections, but all them were empty. Additionally, there was a bug that showed similar symptoms when entering the WebAdmin using a host and then logging in as an account in another host. Both problems and their solutions are described in [#4249](https://github.com/processone/ejabberd/issues/4249).

Please update your configuration accordingly, adding permission from web admin to execute all commands to accounts logged in with admin privilege:

```yaml
api_permissions:
"webadmin commands":
from: ejabberd_web_admin
who: admin
what: "*"
```
Of course you can customize that access as much as you want: only from specific IP addresses, only to certain accounts, only for specific commands...
3 changes: 3 additions & 0 deletions content/roadmap/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,9 @@ hide:

### 2024

- [24.07](https://www.process-one.net/blog/ejabberd-24-07/)
- Bugfixes and minor improvements

- [24.06](https://www.process-one.net/blog/ejabberd-24-06/)
- Reworked the [ejabberd Docs](https://docs.ejabberd.im/) and moved to MkDocs+Material
- [Automatic SQL schema](https://www.process-one.net/blog/automatic-schema-update-in-ejabberd/) is now enabled by default
Expand Down
9 changes: 9 additions & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -264,6 +264,15 @@ nav:
- Versioning: developer/ejabberd-api/api_versioning.md
- Archive:
- archive/index.md
- "24.07":
- archive/24.07/index.md
- archive/24.07/admin-api.md
- archive/24.07/admin-tags.md
- archive/24.07/listen.md
- archive/24.07/listen-options.md
- archive/24.07/modules.md
- archive/24.07/toplevel.md
- archive/24.07/upgrade.md
- "24.06":
- archive/24.06/index.md
- archive/24.06/admin-api.md
Expand Down

0 comments on commit 0084a77

Please sign in to comment.