mirror of
https://github.com/superseriousbusiness/gotosocial
synced 2024-12-08 14:36:32 +01:00
153 lines
6.4 KiB
Go
153 lines
6.4 KiB
Go
/*
|
|
GoToSocial
|
|
Copyright (C) 2021-2023 GoToSocial Authors admin@gotosocial.org
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU Affero General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU Affero General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Affero General Public License
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
package federation
|
|
|
|
import (
|
|
"context"
|
|
"net/http"
|
|
"net/url"
|
|
|
|
"github.com/superseriousbusiness/activity/pub"
|
|
"github.com/superseriousbusiness/activity/streams/vocab"
|
|
"github.com/superseriousbusiness/gotosocial/internal/log"
|
|
)
|
|
|
|
// federatingActor implements the go-fed federating protocol interface
|
|
type federatingActor struct {
|
|
actor pub.FederatingActor
|
|
}
|
|
|
|
// newFederatingProtocol returns the gotosocial implementation of the GTSFederatingProtocol interface
|
|
func newFederatingActor(c pub.CommonBehavior, s2s pub.FederatingProtocol, db pub.Database, clock pub.Clock) pub.FederatingActor {
|
|
actor := pub.NewFederatingActor(c, s2s, db, clock)
|
|
|
|
return &federatingActor{
|
|
actor: actor,
|
|
}
|
|
}
|
|
|
|
// Send a federated activity.
|
|
//
|
|
// The provided url must be the outbox of the sender. All processing of
|
|
// the activity occurs similarly to the C2S flow:
|
|
// - If t is not an Activity, it is wrapped in a Create activity.
|
|
// - A new ID is generated for the activity.
|
|
// - The activity is added to the specified outbox.
|
|
// - The activity is prepared and delivered to recipients.
|
|
//
|
|
// Note that this function will only behave as expected if the
|
|
// implementation has been constructed to support federation. This
|
|
// method will guaranteed work for non-custom Actors. For custom actors,
|
|
// care should be used to not call this method if only C2S is supported.
|
|
func (f *federatingActor) Send(c context.Context, outbox *url.URL, t vocab.Type) (pub.Activity, error) {
|
|
log.Infof("federating actor: send activity %s via outbox %s", t.GetTypeName(), outbox)
|
|
return f.actor.Send(c, outbox, t)
|
|
}
|
|
|
|
// PostInbox returns true if the request was handled as an ActivityPub
|
|
// POST to an actor's inbox. If false, the request was not an
|
|
// ActivityPub request and may still be handled by the caller in
|
|
// another way, such as serving a web page.
|
|
//
|
|
// If the error is nil, then the ResponseWriter's headers and response
|
|
// has already been written. If a non-nil error is returned, then no
|
|
// response has been written.
|
|
//
|
|
// If the Actor was constructed with the Federated Protocol enabled,
|
|
// side effects will occur.
|
|
//
|
|
// If the Federated Protocol is not enabled, writes the
|
|
// http.StatusMethodNotAllowed status code in the response. No side
|
|
// effects occur.
|
|
func (f *federatingActor) PostInbox(c context.Context, w http.ResponseWriter, r *http.Request) (bool, error) {
|
|
return f.actor.PostInbox(c, w, r)
|
|
}
|
|
|
|
// PostInboxScheme is similar to PostInbox, except clients are able to
|
|
// specify which protocol scheme to handle the incoming request and the
|
|
// data stored within the application (HTTP, HTTPS, etc).
|
|
func (f *federatingActor) PostInboxScheme(c context.Context, w http.ResponseWriter, r *http.Request, scheme string) (bool, error) {
|
|
return f.actor.PostInboxScheme(c, w, r, scheme)
|
|
}
|
|
|
|
// GetInbox returns true if the request was handled as an ActivityPub
|
|
// GET to an actor's inbox. If false, the request was not an ActivityPub
|
|
// request and may still be handled by the caller in another way, such
|
|
// as serving a web page.
|
|
//
|
|
// If the error is nil, then the ResponseWriter's headers and response
|
|
// has already been written. If a non-nil error is returned, then no
|
|
// response has been written.
|
|
//
|
|
// If the request is an ActivityPub request, the Actor will defer to the
|
|
// application to determine the correct authorization of the request and
|
|
// the resulting OrderedCollection to respond with. The Actor handles
|
|
// serializing this OrderedCollection and responding with the correct
|
|
// headers and http.StatusOK.
|
|
func (f *federatingActor) GetInbox(c context.Context, w http.ResponseWriter, r *http.Request) (bool, error) {
|
|
return f.actor.GetInbox(c, w, r)
|
|
}
|
|
|
|
// PostOutbox returns true if the request was handled as an ActivityPub
|
|
// POST to an actor's outbox. If false, the request was not an
|
|
// ActivityPub request and may still be handled by the caller in another
|
|
// way, such as serving a web page.
|
|
//
|
|
// If the error is nil, then the ResponseWriter's headers and response
|
|
// has already been written. If a non-nil error is returned, then no
|
|
// response has been written.
|
|
//
|
|
// If the Actor was constructed with the Social Protocol enabled, side
|
|
// effects will occur.
|
|
//
|
|
// If the Social Protocol is not enabled, writes the
|
|
// http.StatusMethodNotAllowed status code in the response. No side
|
|
// effects occur.
|
|
//
|
|
// If the Social and Federated Protocol are both enabled, it will handle
|
|
// the side effects of receiving an ActivityStream Activity, and then
|
|
// federate the Activity to peers.
|
|
func (f *federatingActor) PostOutbox(c context.Context, w http.ResponseWriter, r *http.Request) (bool, error) {
|
|
return f.actor.PostOutbox(c, w, r)
|
|
}
|
|
|
|
// PostOutboxScheme is similar to PostOutbox, except clients are able to
|
|
// specify which protocol scheme to handle the incoming request and the
|
|
// data stored within the application (HTTP, HTTPS, etc).
|
|
func (f *federatingActor) PostOutboxScheme(c context.Context, w http.ResponseWriter, r *http.Request, scheme string) (bool, error) {
|
|
return f.actor.PostOutboxScheme(c, w, r, scheme)
|
|
}
|
|
|
|
// GetOutbox returns true if the request was handled as an ActivityPub
|
|
// GET to an actor's outbox. If false, the request was not an
|
|
// ActivityPub request.
|
|
//
|
|
// If the error is nil, then the ResponseWriter's headers and response
|
|
// has already been written. If a non-nil error is returned, then no
|
|
// response has been written.
|
|
//
|
|
// If the request is an ActivityPub request, the Actor will defer to the
|
|
// application to determine the correct authorization of the request and
|
|
// the resulting OrderedCollection to respond with. The Actor handles
|
|
// serializing this OrderedCollection and responding with the correct
|
|
// headers and http.StatusOK.
|
|
func (f *federatingActor) GetOutbox(c context.Context, w http.ResponseWriter, r *http.Request) (bool, error) {
|
|
return f.actor.GetOutbox(c, w, r)
|
|
}
|