NoLog.cz/gancio-upstream
6
0
Fork 0
mirror of https://framagit.org/les/gancio.git synced 2025-01-31 08:32:23 +01:00
Code Issues Projects Releases Packages Wiki Activity

docs: federation

Browse source
This commit is contained in:
lesion 2023-12-27 16:09:04 +01:00
parent c1575f5ea1
commit e78b1ecb67
No known key found for this signature in database
GPG key ID: 352918250B012177
2 changed files with 71 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

54
FEDERATION.md Normal file
View file

@ -0,0 +1,54 @@
## Federation / ActivityPub
Gancio largely follows ActivityPub's server-to-server specification.
## Supported federation protocols and standards
- [ActivityPub](https://www.w3.org/TR/activitypub/) (Server-to-Server)
- [WebFinger](https://webfinger.net/)
- [HTTP Signatures](https://datatracker.ietf.org/doc/html/draft-cavage-http-signatures)
- [NodeInfo](https://nodeinfo.diaspora.software/)
## Supported FEPs
- [FEP-f1d5: NodeInfo in Fediverse Software](https://codeberg.org/fediverse/fep/src/branch/main/fep/f1d5/fep-f1d5.md)
- [FEP-67ff: FEDERATION.md](https://codeberg.org/fediverse/fep/src/branch/main/fep/67ff/fep-67ff.md)
- [FEP-fb2a: Actor metadata](https://codeberg.org/fediverse/fep/src/branch/main/fep/fb2a/fep-fb2a.md)
- [FEP-2677: Identifying the Application Actor](https://codeberg.org/fediverse/fep/src/branch/main/fep/2677/fep-2677.md)
## ActivityPub
Each instance has only one [AP Actor](https://www.w3.org/TR/activitypub/#actors) of type `Application` named `relay@instance.tld` by default, which publishes each event as [Event](https://www.w3.org/TR/activitystreams-vocabulary/#dfn-event) type.
Each AP enabled software could decide how to interact with coming events, e.g. on Mastodon and forks you can see it with minimal information, with Friendica events are added into your own calendar, GoToSocial does not support [Event](https://www.w3.org/TR/activitystreams-vocabulary/#dfn-event) type.
We are considering the introduction of other `Actor` but they will not be linked to users, rather to places, tags or collections.
There are no personal timeline of people you follow, everyone has a sort of local timeline of the instance, it’s an anti filter-bubble feature.
Since v1.9.0 each instance could follow other instances or actors (`Admin > Federation > Add trusted node`) and use the events coming from the federation to fill choosen collections (`Admin > Collections`).
Note that events coming from the federation will be removed after the end.
All federation's related operations uses `/federation` as endpoint. You can disable it via a specific setting (`Admin > Federation > Disable federation`).
### Supported operations
| **Operation** | **Since** | **Note** |
| Follow Gancio from Fediverse | <span class='label label-yellow'>0.15.0</span> | |
| Send an Event | <span class='label label-yellow'>0.15.0</span> | Sent as [Event](https://www.w3.org/TR/activitystreams-vocabulary/#dfn-event) type.|
| Receive a Note | <span class='label label-yellow'>0.21.0</span> | Adds images, audio and notes to an event with a simple reply |
| Delete a Note | <span class='label label-yellow'>0.21.0</span> |
| Update a Note | <span class='label label-yellow'>0.21.0</span> |
| Follow an Actor | <span class='label label-yellow'>1.9.0</span> | |
| Receive an Event | <span class='label label-yellow'>1.9.0</span> |
| Update an Event | <span class='label label-yellow'>1.9.0</span> |
| Delete an Event | <span class='label label-yellow'>1.9.0</span> |
### Moderation
- Hide or remove a remote event
- Block a remote user
- Block a remote instance

24
docs/federation.md
View file

@ -26,25 +26,35 @@ Gancio largely follows ActivityPub's server-to-server specification.
## ActivityPub
Each instance has only one [AP Actor](https://www.w3.org/TR/activitypub/#actors) of type `Application` named `relay@instance.tld` by default, which publishes each event as [Event](https://www.w3.org/TR/activitystreams-vocabulary/#dfn-event) type.
Each instance has only one [AP Actor](https://www.w3.org/TR/activitypub/#actors) of type `Application` named `relay@instance.tld` by default, which publishes each event as [Event](https://www.w3.org/TR/activitystreams-vocabulary/#dfn-event) type.
Each AP enabled software could decide how to interact with coming events, e.g. on Mastodon and forks you can see it with minimal information, with Friendica events are added into your own calendar, GoToSocial does not support [Event](https://www.w3.org/TR/activitystreams-vocabulary/#dfn-event) type.
We are considering the introduction of other `Actor` but they will not be linked to users, rather to places, tags or collections.
There are no personal timeline of people you follow, everyone has a sort of local timeline of the instance, it’s an anti filter-bubble feature.
Since v2.0 each instance could follow other instances or actors (`Admin > Federation > Add trusted node`) and use the events coming from the federation to fill choosen collections (`Admin > Collections`).
Since v1.9.0 each instance could follow other instances or actors (`Admin > Federation > Add trusted node`) and use the events coming from the federation to fill choosen collections (`Admin > Collections`).
Note that events coming from the federation will be removed after the end.
#### Supported operations
All federation's related operations uses `/federation` as endpoint. You can disable it via a specific setting (`Admin > Federation > Disable federation`).
#### Getting followed
### Supported operations
#### Received a reply
| **Operation** | **Since** | **Note** |
| Follow Gancio from Fediverse | <span class='label label-yellow'>0.15.0</span> | |
| Send an Event | <span class='label label-yellow'>0.15.0</span> | Sent as [Event](https://www.w3.org/TR/activitystreams-vocabulary/#dfn-event) type.|
| Receive a Note | <span class='label label-yellow'>0.21.0</span> | Adds images, audio and notes to an event with a simple reply |
| Delete a Note | <span class='label label-yellow'>0.21.0</span> |
| Update a Note | <span class='label label-yellow'>0.21.0</span> |
| Follow an Actor | <span class='label label-yellow'>1.9.0</span> | |
| Receive an Event | <span class='label label-yellow'>1.9.0</span> |
| Update an Event | <span class='label label-yellow'>1.9.0</span> |
| Delete an Event | <span class='label label-yellow'>1.9.0</span> |
#### Follow someone
#### Receive an event
### Moderation
- Hide or remove a remote event
- Block a remote user
- Block a remote instance