vbatts/ntfy
1
0
Fork 0
Code Pull requests Activity

Refine UP docs

Browse source
This commit is contained in:
Philipp Heckel 2022-11-14 15:21:02 -05:00
parent e7b575badc
commit fd7f83378d
2 changed files with 10 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

13
docs/config.md
View file

@ -309,9 +309,14 @@ with the given username/password. Be sure to use HTTPS to avoid eavesdropping an
]));
```
### UnifiedPush compatibility
### Example: UnifiedPush
[UnifiedPush](https://unifiedpush.org) requires that the [application server](https://unifiedpush.org/spec/definitions/#application-server) (e.g. Synapse, Fediverse Server, …)
has anonymous write access to the [topic](https://unifiedpush.org/spec/definitions/#endpoint) used for push messages.
The topic names used by UnifiedPush all start with the `up*` prefix. Please refer to the
**[UnifiedPush documentation](https://unifiedpush.org/users/distributors/ntfy/#limit-access-to-some-users)** for more details.
UnifiedPush requires that the [application server](https://unifiedpush.org/spec/definitions/#application-server) (e.g. Synapse, Fediverse Server, …) has anonymous write access to the [topic](https://unifiedpush.org/spec/definitions/#endpoint) used for push messages. The topic names used by UnifiedPush all start with the `up` prefix. You should either allow anonymous write access for the entire prefix or explicitly per topic:
To enable support for UnifiedPush for private servers (i.e. `auth-default-access: "deny-all"`), you should either
allow anonymous write access for the entire prefix or explicitly per topic:
=== "Prefix"
```
@ -320,11 +325,9 @@ UnifiedPush requires that the [application server](https://unifiedpush.org/spec/
=== "Explicitly"
```
$ ntfy access '*' 'upYzMtZGZiYTY5' write-only
$ ntfy access '*' upYzMtZGZiYTY5 write-only
```
see https://unifiedpush.org/users/distributors/ntfy/#limit-access-to-some-users
## E-mail notifications
To allow forwarding messages via e-mail, you can configure an **SMTP server for outgoing messages**. Once configured,
you can set the `X-Email` header to [send messages via e-mail](publish.md#e-mail-notifications) (e.g.