Skip to content
  • Categories
  • Recent
  • Tags
  • Popular
  • World
  • Users
  • Groups
Skins
  • Light
  • Brite
  • Cerulean
  • Cosmo
  • Flatly
  • Journal
  • Litera
  • Lumen
  • Lux
  • Materia
  • Minty
  • Morph
  • Pulse
  • Sandstone
  • Simplex
  • Sketchy
  • Spacelab
  • United
  • Yeti
  • Zephyr
  • Dark
  • Cyborg
  • Darkly
  • Quartz
  • Slate
  • Solar
  • Superhero
  • Vapor

  • Default (Darkly)
  • No Skin
Collapse
Brand Logo
  1. Home
  2. Uncategorized
  3. I think the #ActivityPub client-to-server API is extremely important and underrated.

I think the #ActivityPub client-to-server API is extremely important and underrated.

Scheduled Pinned Locked Moved Uncategorized
activitypubfediverse
110 Posts 11 Posters 0 Views
  • Oldest to Newest
  • Newest to Oldest
  • Most Votes
Reply
  • Reply as topic
Log in to reply
This topic has been deleted. Only users with topic management privileges can see it.
  • mariusM marius

    @steve yes, but something dumb that only fetches a URL and converts the resulting ActivityPub into a valid other type of representation is a valid client in my opinion. That's what I mean, was that unclear?

    @smallcircles @evan

    Steve BateS This user is from outside of this forum
    Steve BateS This user is from outside of this forum
    Steve Bate
    wrote last edited by
    #71

    @mariusor @smallcircles @evan I *think* it’s
    clear. I agree it’s a kind of β€œclient”, just not necessarily a C2S client.

    mariusM 1 Reply Last reply
    0
    • Ben Pate 🀘🏻B Ben Pate 🀘🏻

      @thisismissem @steve @mariusor @smallcircles @evan

      Just checking my memory.. this concept exists already, yes?

      https://www.w3.org/wiki/ActivityPub/Primer/proxyUrl_endpoint

      Are you just saying that the new API spec should include this? Or am I missing something?

      Evan ProdromouE This user is from outside of this forum
      Evan ProdromouE This user is from outside of this forum
      Evan Prodromou
      wrote last edited by
      #72

      @benpate @thisismissem @steve @mariusor @smallcircles

      Yes, proxyUrl already exists. There's a use case here:

      https://github.com/swicg/activitypub-api/issues/10

      The only other way I've seen this use case discussed is with client-side HTTP Signature keys. There's some kind of negotiation between the server and the client, and then the client can make requests to remote servers using HTTP Signature and a key it controls.

      Emelia πŸ‘ΈπŸ»T 1 Reply Last reply
      2
      0
      • Steve BateS Steve Bate

        @mariusor @smallcircles @evan I *think* it’s
        clear. I agree it’s a kind of β€œclient”, just not necessarily a C2S client.

        mariusM This user is from outside of this forum
        mariusM This user is from outside of this forum
        marius
        wrote last edited by
        #73

        @steve OK, but why?

        I feel like I explained my position relatively clearly, I would like to understand yours, even though I feel some animosity has started to crop up.

        @smallcircles @evan

        Steve BateS 1 Reply Last reply
        0
        • 🫧 socialcoding..S 🫧 socialcoding..

          @evan @steve

          Well, but a part of the specs can certainly be considered a message bus with channels conceptually.

          Channel is the name that AsyncAPI uses, which maps to domain aggregates and actor streams.

          But considering things purely event-based is stretching it, and may be better to discern between commands and events.

          Evan ProdromouE This user is from outside of this forum
          Evan ProdromouE This user is from outside of this forum
          Evan Prodromou
          wrote last edited by
          #74

          @smallcircles @steve maybe? I guess you could consider the `sharedInbox` to be like that.

          I think that activities sent to the API by a client are kind of like commands, but they can also be events that happened on a different system.

          If I got an achievement in a game, and that was sent as an activity to the API, it's more like an event notification than a command.

          🫧 socialcoding..S 1 Reply Last reply
          0
          • mariusM marius

            @steve OK, but why?

            I feel like I explained my position relatively clearly, I would like to understand yours, even though I feel some animosity has started to crop up.

            @smallcircles @evan

            Steve BateS This user is from outside of this forum
            Steve BateS This user is from outside of this forum
            Steve Bate
            wrote last edited by
            #75

            @mariusor @smallcircles @evan No animosity here. However, I’m not sure how to explain it more clearly. I’m referring to C2S as described in chapter 6 of the ActivityPub specification (and the conformance profiles in Section 2.1). It sounded to me like you’re using a more general definition of β€œclient”, which is fine, just different in significant ways (if it only dereferences and renders AP data).

            🫧 socialcoding..S 1 Reply Last reply
            0
            • Evan ProdromouE Evan Prodromou

              @smallcircles @steve maybe? I guess you could consider the `sharedInbox` to be like that.

              I think that activities sent to the API by a client are kind of like commands, but they can also be events that happened on a different system.

              If I got an achievement in a game, and that was sent as an activity to the API, it's more like an event notification than a command.

              🫧 socialcoding..S This user is from outside of this forum
              🫧 socialcoding..S This user is from outside of this forum
              🫧 socialcoding..
              wrote last edited by
              #76

              @evan @steve

              Rather than sharedInbox I was more thinking that by implementing the HTTP API and msg exchanges in a well-prescribed manner, these would effectively model an event bus conceptually. After which you can talk about it as a higher abstraction that exists, and not get lost in the reeds of the impl details anymore.

              Evan ProdromouE 1 Reply Last reply
              0
              • Steve BateS Steve Bate

                @mariusor @smallcircles @evan No animosity here. However, I’m not sure how to explain it more clearly. I’m referring to C2S as described in chapter 6 of the ActivityPub specification (and the conformance profiles in Section 2.1). It sounded to me like you’re using a more general definition of β€œclient”, which is fine, just different in significant ways (if it only dereferences and renders AP data).

                🫧 socialcoding..S This user is from outside of this forum
                🫧 socialcoding..S This user is from outside of this forum
                🫧 socialcoding..
                wrote last edited by
                #77

                @steve @mariusor @evan

                He he, language is hard. A case of terminology overload and clashing terms. Domain driven design has the clearly defined bounded context here which is the scope within which terms are valid. Forming a consistency boundary. These context lines are blurred in fediverse talk. πŸ˜…

                Evan ProdromouE 1 Reply Last reply
                0
                • mariusM marius

                  @thisismissem I have just implemented that for the GoActivityPub servers and it's easier than it sounds.

                  The only important step required is to convert the client authorization token (presumably an OAuth2 bearer token) to a valid actor and then further to a valid Private Key with which to sign the remote request. After that the only thing remaining is to pipe verbatim the received response to the client...

                  @steve @smallcircles @evan

                  Emelia πŸ‘ΈπŸ»T This user is from outside of this forum
                  Emelia πŸ‘ΈπŸ»T This user is from outside of this forum
                  Emelia πŸ‘ΈπŸ»
                  wrote last edited by
                  #78

                  @mariusor @steve @smallcircles @evan well, your server *knows* it's access token to user mapping, so then you're just doing authorised fetch as that actor from server side

                  mariusM 1 Reply Last reply
                  2
                  0
                  • Ben Pate 🀘🏻B Ben Pate 🀘🏻

                    @thisismissem @steve @mariusor @smallcircles @evan

                    Just checking my memory.. this concept exists already, yes?

                    https://www.w3.org/wiki/ActivityPub/Primer/proxyUrl_endpoint

                    Are you just saying that the new API spec should include this? Or am I missing something?

                    Emelia πŸ‘ΈπŸ»T This user is from outside of this forum
                    Emelia πŸ‘ΈπŸ»T This user is from outside of this forum
                    Emelia πŸ‘ΈπŸ»
                    wrote last edited by
                    #79

                    @benpate @steve @mariusor @smallcircles @evan i'm not sure proxyUrl does what I'm thinking of here

                    1 Reply Last reply
                    1
                    0
                    • Evan ProdromouE Evan Prodromou

                      @benpate @thisismissem @steve @mariusor @smallcircles

                      Yes, proxyUrl already exists. There's a use case here:

                      https://github.com/swicg/activitypub-api/issues/10

                      The only other way I've seen this use case discussed is with client-side HTTP Signature keys. There's some kind of negotiation between the server and the client, and then the client can make requests to remote servers using HTTP Signature and a key it controls.

                      Emelia πŸ‘ΈπŸ»T This user is from outside of this forum
                      Emelia πŸ‘ΈπŸ»T This user is from outside of this forum
                      Emelia πŸ‘ΈπŸ»
                      wrote last edited by
                      #80

                      @evan @benpate @steve @mariusor @smallcircles my understanding of proxyUrl is that it's just fetching a remote object, but without forwarding authorization

                      For many cases you want to forward the request as the authenticated user to the remote server, not doing the request anonymously

                      mariusM 1 Reply Last reply
                      0
                      • Emelia πŸ‘ΈπŸ»T Emelia πŸ‘ΈπŸ»

                        @mariusor @steve @smallcircles @evan well, your server *knows* it's access token to user mapping, so then you're just doing authorised fetch as that actor from server side

                        mariusM This user is from outside of this forum
                        mariusM This user is from outside of this forum
                        marius
                        wrote last edited by
                        #81

                        @thisismissem which is what proxyUrl is supposed to do, right?

                        Did you mean it in a different way?

                        @steve @smallcircles @evan

                        1 Reply Last reply
                        1
                        0
                        • Emelia πŸ‘ΈπŸ»T Emelia πŸ‘ΈπŸ»

                          @evan @benpate @steve @mariusor @smallcircles my understanding of proxyUrl is that it's just fetching a remote object, but without forwarding authorization

                          For many cases you want to forward the request as the authenticated user to the remote server, not doing the request anonymously

                          mariusM This user is from outside of this forum
                          mariusM This user is from outside of this forum
                          marius
                          wrote last edited by
                          #82

                          @thisismissem it's not explicitly saying to forward authorization, but to me that's implied from "require authentication":

                          proxyUrl: Endpoint URI so this actor's clients may access remote ActivityStreams objects which require authentication to access

                          https://w3c.github.io/activitypub/#proxyUrl

                          @evan @benpate @steve @smallcircles

                          Evan ProdromouE 1 Reply Last reply
                          2
                          0
                          • 🫧 socialcoding..S 🫧 socialcoding..

                            @evan @steve

                            Rather than sharedInbox I was more thinking that by implementing the HTTP API and msg exchanges in a well-prescribed manner, these would effectively model an event bus conceptually. After which you can talk about it as a higher abstraction that exists, and not get lost in the reeds of the impl details anymore.

                            Evan ProdromouE This user is from outside of this forum
                            Evan ProdromouE This user is from outside of this forum
                            Evan Prodromou
                            wrote last edited by
                            #83

                            @smallcircles @steve sure. I am not a fan of the idea that AP is a message-passing system; it's a read-write API.

                            🫧 socialcoding..S 1 Reply Last reply
                            2
                            0
                            • Evan ProdromouE Evan Prodromou

                              @smallcircles @steve sure. I am not a fan of the idea that AP is a message-passing system; it's a read-write API.

                              🫧 socialcoding..S This user is from outside of this forum
                              🫧 socialcoding..S This user is from outside of this forum
                              🫧 socialcoding..
                              wrote last edited by
                              #84

                              @evan @steve

                              It is both, like in that diagram draft.. or at least could be considered such (the notes apply to Protosocial musings).

                              https://social.coop/@smallcircles/116099511464629495

                              🫧 socialcoding..S 1 Reply Last reply
                              0
                              • mariusM marius

                                @thisismissem it's not explicitly saying to forward authorization, but to me that's implied from "require authentication":

                                proxyUrl: Endpoint URI so this actor's clients may access remote ActivityStreams objects which require authentication to access

                                https://w3c.github.io/activitypub/#proxyUrl

                                @evan @benpate @steve @smallcircles

                                Evan ProdromouE This user is from outside of this forum
                                Evan ProdromouE This user is from outside of this forum
                                Evan Prodromou
                                wrote last edited by
                                #85

                                @mariusor I have implemented it requiring OAuth on one side and using HTTP Signature on the other. I think you need to use the user's authorization for private content or to respect personal blocks. It sucks for caching but Β―\_(ツ)_/Β―

                                @thisismissem @benpate @steve @smallcircles

                                mariusM Ben Pate 🀘🏻B Emelia πŸ‘ΈπŸ»T 3 Replies Last reply
                                2
                                0
                                • Evan ProdromouE Evan Prodromou

                                  @mariusor I have implemented it requiring OAuth on one side and using HTTP Signature on the other. I think you need to use the user's authorization for private content or to respect personal blocks. It sucks for caching but Β―\_(ツ)_/Β―

                                  @thisismissem @benpate @steve @smallcircles

                                  mariusM This user is from outside of this forum
                                  mariusM This user is from outside of this forum
                                  marius
                                  wrote last edited by
                                  #86

                                  @evan yes, that's how I did it too, only in my case the private key of the actor that is authorized by OAuth2 token is used to generate the signature for the proxy fetch. This makes it that servers that implement object ACLs based on the recipients list (which GoActivityPub servers are) are not serving 403s for fetches.

                                  1 Reply Last reply
                                  2
                                  0
                                  • Evan ProdromouE Evan Prodromou

                                    @mariusor I have implemented it requiring OAuth on one side and using HTTP Signature on the other. I think you need to use the user's authorization for private content or to respect personal blocks. It sucks for caching but Β―\_(ツ)_/Β―

                                    @thisismissem @benpate @steve @smallcircles

                                    Ben Pate 🀘🏻B This user is from outside of this forum
                                    Ben Pate 🀘🏻B This user is from outside of this forum
                                    Ben Pate 🀘🏻
                                    wrote last edited by
                                    #87

                                    Yeah, this is how I'd expect it to work (with the possible addition of *also* allowing cookie auth on the client side)

                                    But yeah. Locally authenticated user from my client -> my server, then HTTP signature from my server -> your server

                                    @evan @mariusor @thisismissem @steve @smallcircles

                                    Evan ProdromouE 1 Reply Last reply
                                    2
                                    0
                                    • Sean TilleyD Sean Tilley

                                      @evan@cosocial.ca Yeah, I mostly agree with this. It's just that the buy-in is a little bit of a chicken and egg problem. You need servers to adopt it, but you need a compelling first mover. Bonfire, maybe?

                                      The spec definitely needs love, too. I think one of the harder things is building a timeline out of inbox activities. I feel like maybe a future version of the API could specify timelines somehow, whether it's an endpoint or some kind of basic query? Maybe there's even a way to implement alternative timelines at that level?

                                      These are all just guesses on my part, but I feel like this could be a gateway to universal custom feeds.

                                      Evan ProdromouE This user is from outside of this forum
                                      Evan ProdromouE This user is from outside of this forum
                                      Evan Prodromou
                                      wrote last edited by
                                      #88

                                      @deadsuperhero so, it's a two-sided market -- clients and servers. The traditional mechanism is a "ratchet" -- build up one side, then build up the other, and then build up the first.

                                      So, yes, servers first, then clients, then more servers, more clients, and so on back and forth.

                                      1 Reply Last reply
                                      1
                                      0
                                      • Ben Pate 🀘🏻B Ben Pate 🀘🏻

                                        Yeah, this is how I'd expect it to work (with the possible addition of *also* allowing cookie auth on the client side)

                                        But yeah. Locally authenticated user from my client -> my server, then HTTP signature from my server -> your server

                                        @evan @mariusor @thisismissem @steve @smallcircles

                                        Evan ProdromouE This user is from outside of this forum
                                        Evan ProdromouE This user is from outside of this forum
                                        Evan Prodromou
                                        wrote last edited by
                                        #89

                                        @benpate

                                        With all the standard warnings around proxies!

                                        @mariusor @thisismissem @steve @smallcircles

                                        1 Reply Last reply
                                        2
                                        0
                                        • 🫧 socialcoding..S 🫧 socialcoding..

                                          @steve @mariusor @evan

                                          He he, language is hard. A case of terminology overload and clashing terms. Domain driven design has the clearly defined bounded context here which is the scope within which terms are valid. Forming a consistency boundary. These context lines are blurred in fediverse talk. πŸ˜…

                                          Evan ProdromouE This user is from outside of this forum
                                          Evan ProdromouE This user is from outside of this forum
                                          Evan Prodromou
                                          wrote last edited by
                                          #90

                                          @smallcircles @steve @mariusor

                                          I think in particular the terms "publisher" and "consumer" from AS2 and "client" and "server" from AP don't always map cleanly, especially with HTTP POST requests.

                                          When a client delivers an activity to the actor's outbox, the client is the publisher of that activity, and the server is the consumer.

                                          Same when a sending server (publisher) delivers an activity to a receiving server (consumer).

                                          1 Reply Last reply
                                          2
                                          0
                                          Reply
                                          • Reply as topic
                                          Log in to reply
                                          • Oldest to Newest
                                          • Newest to Oldest
                                          • Most Votes


                                          • Login

                                          • Don't have an account? Register

                                          • Login or register to search.
                                          Powered by NodeBB Contributors
                                          • First post
                                            Last post
                                          0
                                          • Categories
                                          • Recent
                                          • Tags
                                          • Popular
                                          • World
                                          • Users
                                          • Groups