diff options
| author | techknowlogick <techknowlogick@gitea.io> | 2021-09-27 19:38:06 -0400 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-09-28 01:38:06 +0200 |
| commit | babab0bf5e1b6afc1bccf26e5ef0aec69972599e (patch) | |
| tree | bc1ca1c5f8487d61df43efc4ffd0843f5848363e /docs | |
| parent | f48dce3176649916c262ab080d5f38a0433f38c0 (diff) | |
| download | gitea-babab0bf5e1b6afc1bccf26e5ef0aec69972599e.tar.gz gitea-babab0bf5e1b6afc1bccf26e5ef0aec69972599e.zip | |
Add nodeinfo endpoint for federation purposes (#16953)
Nodeinfo is a way to expose certain metadata about a server for use of discovery regarding functionality of its federation capabilities.
Two endpoints are required:
1. `/.well-known/nodeinfo` which informs client where it can find the location of the location of its metadata (including which version of the schema is used)
2. the endpoint which exposes the metadata in json format according to schema.
Notes:
* `openRegistrations` is a required field, but I propose to set to false as default in case someone writes a crawler to discover "open" gitea instances
* to limit data leakage I also propose to not include the `usage` field (note it is required so it should be included, but left as empty).
More info:
https://github.com/jhass/nodeinfo
https://github.com/jhass/nodeinfo/tree/main/schemas/2.1
http://nodeinfo.diaspora.software/protocol.html
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/content/doc/advanced/config-cheat-sheet.en-us.md | 4 |
1 files changed, 4 insertions, 0 deletions
diff --git a/docs/content/doc/advanced/config-cheat-sheet.en-us.md b/docs/content/doc/advanced/config-cheat-sheet.en-us.md index de9b794db2..d80f96b3de 100644 --- a/docs/content/doc/advanced/config-cheat-sheet.en-us.md +++ b/docs/content/doc/advanced/config-cheat-sheet.en-us.md @@ -953,6 +953,10 @@ Task queue configuration has been moved to `queue.task`. However, the below conf - `ALLOW_LOCALNETWORKS`: **false**: Allow private addresses defined by RFC 1918, RFC 1122, RFC 4632 and RFC 4291 - `SKIP_TLS_VERIFY`: **false**: Allow skip tls verify +## Federation (`federation`) + +- `ENABLED`: **true**: Enable/Disable federation capabilities + ## Mirror (`mirror`) - `ENABLED`: **true**: Enables the mirror functionality. Set to **false** to disable all mirrors. |