forgejo-federation/docs/content/doc/advanced
techknowlogick babab0bf5e
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
2021-09-28 01:38:06 +02:00
..
adding-legal-pages.en-us.md Update documentation to reflect #15219 (#16442) 2021-07-15 20:49:12 +01:00
clone-filter.en-us.md [Docs] Clone filters (#14555) 2021-02-03 10:11:20 -05:00
cmd-embedded.en-us.md Reformat docs (#13897) 2020-12-09 07:47:06 +01:00
config-cheat-sheet.en-us.md Add nodeinfo endpoint for federation purposes (#16953) 2021-09-28 01:38:06 +02:00
config-cheat-sheet.zh-cn.md Paginate releases page & set default page size to 10 (#16857) 2021-08-29 18:25:16 +02:00
customizing-gitea.en-us.md Use light/dark theme based on system preference (#17051) 2021-09-27 15:47:44 +01:00
customizing-gitea.zh-cn.md Update documentation to reflect #15219 (#16442) 2021-07-15 20:49:12 +01:00
environment-variables.en-us.md Update docs and comments to remove macaron (#14491) 2021-01-29 16:35:30 +01:00
environment-variables.zh-cn.md Update docs and comments to remove macaron (#14491) 2021-01-29 16:35:30 +01:00
external-renderers.en-us.md Update documentation to reflect #15219 (#16442) 2021-07-15 20:49:12 +01:00
hacking-on-gitea.zh-cn.md ZH-CN translation of Advanced part (#5090) 2018-10-17 14:21:20 +03:00
logging-documentation.en-us.md Fix various documentation, user-facing, and source comment typos (#16367) 2021-07-08 13:38:13 +02:00
mail-templates-us.md Doc: Mail-Tempales: Fix AppUrl function name (#16939) 2021-09-03 12:49:42 +01:00
make.fr-fr.md docs: fix various typos and translate to french (#16477) 2021-07-18 12:21:32 -04:00
make.zh-cn.md Reformat docs (#13897) 2020-12-09 07:47:06 +01:00
protected-tags.en-us.md Fix various documentation, user-facing, and source comment typos (#16367) 2021-07-08 13:38:13 +02:00
repo-indexer.en-us.md Reformat docs (#13897) 2020-12-09 07:47:06 +01:00
repo-mirror.en-us.md Add push to remote mirror repository (#15157) 2021-06-14 19:20:43 +02:00
search-engines-indexation.en-us.md Reformat docs (#13897) 2020-12-09 07:47:06 +01:00
signing.en-us.md Specify relation between multiple signing options (#15496) 2021-04-15 18:06:32 +02:00
third-party-tools.zh-cn.md Reformat docs (#13897) 2020-12-09 07:47:06 +01:00