Application Services

[matrixbot]

This issue was originally created by @turt2live at matrix-org/dendrite#358.

Currently this is under phase 4 for dendrite, however I'd certainly like to see it in an earlier phase. This includes:

• Loading application service configurations
• The application service API
• Supporting application services on the various client endpoints

An incredibly nice to have feature of this would also be documentation on how this API works.

[matrixbot]

This comment was originally posted by @anoadragon453 at matrix-org/dendrite#358 (comment).

To break the tasks down a bit further:

• Allow application services to register users in their namepsaces defined in the config files.
• Look at each event and figure out if it should be sent to the AS, if so do that (with ability to batch requests up while doing so).
• Make the APIs support the way that AS's interact with the API, which is use their master access_token and specify a user_id= param.

Application Services API docs

[matrixbot]

This comment was originally posted by @anoadragon453 at matrix-org/dendrite#358 (comment).

In terms of users, Application Services specifically:

• Register for a namespace which is a regex pattern which their user's usernames matches. They can say whether they have exclusive rights to their namespace or not.
• They can register a password-less user as long as the username lies within their namespace.
• They can then call any API endpoint masquerading as that user with /path?access_token=$token&user_id=$userid.

[matrixbot]

This comment was originally posted by @turt2live at matrix-org/dendrite#358 (comment).

Just for tracking purposes, here's the PR progress so far:

• Load Application Service Configuration Files matrix-org/dendrite#377 - Parse and load the config files
• Application Service Registration matrix-org/dendrite#390 - Appservice users can be registered
• Prevent AS user check if no AS registered matrix-org/dendrite#392 - Fix a bug related to registrations on homeservers with no appservices

If I'm not mistaken, what's left to do is:

• Support the ?user_id query parameter for appservice access tokens
• Support changing the origin_server_ts value of events through the ?ts query parameter
• Sending events to the appservice (/transactions route)
• Sending room alias query requests to the appservice (PR Implement GET /rooms/{roomAlias} #494)
• Sending user query requests to the appservice (PR Make use of /users/{userID} in relevant APIs #522)
• 3pid support (although for the purposes of the bounty, I'm okay with ignoring this part) (PR Third Party Lookup Support #561)
• Testing the whole thing to see if it works :)

Thanks for your amazing progress so far on this @anoadragon453! It's looking pretty good, and I'm really excited to see it implemented.

Edit: Update with current progress - @anoadragon453

[matrixbot]

This comment was originally posted by @anoadragon453 at matrix-org/dendrite#358 (comment).

@turt2live Thanks for summing it all up! I plan to add AS support to endpoints next (hopefully in some transparent fashion that future endpoints can use without hassle), then work on communicating directly the AS's.

And tests, need to start writing those :)

[matrixbot]

This comment was originally posted by @turt2live at matrix-org/dendrite#358 (comment).

More for tracking purposes:

• Milestone: https://github.com/matrix-org/dendrite/milestone/3
• Send events: AppServices: PUT /transactions/{txnId} matrix-org/dendrite#450 (PR: Send Application Service Events matrix-org/dendrite#477)
• AppServices: GET /rooms/{roomAlias} matrix-org/dendrite#452 - GET /rooms/alias
• AppServices: GET /users/{userId} matrix-org/dendrite#453 - GET /users/userId
• AppServices: Add ability to perform Timestamp Massaging matrix-org/dendrite#456 - Timestamp massaging
• AppServices: GET /_matrix/app/r0/user?uri={url_encoded_uri} matrix-org/dendrite#457 - GET /app/r0/user?uri=encoded (I think this is 3pid related?)
• AppServices: GET /_matrix/app/r0/alias?uri={url_encoded_uri} matrix-org/dendrite#460 - GET /app/r0/alias?uri=encoded (I think this is 3pid related?)
• AppServices: Ensure users cannot create a room alias that an Application Service manages matrix-org/dendrite#451 - Validation on exclusive rooms (PR: Prevent alias registration in AS exclusive namespace  matrix-org/dendrite#480)
• FInd more efficient way to check room memberships for appservices matrix-org/dendrite#468 - Validation to ensure the appservice is actually in the room
• AppServices: Identity Assertion aka ?user_id={user_id} matrix-org/dendrite#469 - Identity masquerading
• AppServices: Implement Synapse-supported registration config options matrix-org/dendrite#471 - Misc additional registration options

[matrixbot]

This comment was originally posted by @anoadragon453 at matrix-org/dendrite#358 (comment).

I'm also tracking progress in the spreadsheet fwiw.

[matrixbot]

This comment was originally posted by @Half-Shot at matrix-org/dendrite#358 (comment).

Modulo #468 being verified as fixed, I don't know if this issue is very useful going forwards. All the basic AS features have landed and we can track the thirdparty endpoints / misc things as issues.

Any votes for keeping this open?

[matrixbot]

This comment was originally posted by @anoadragon453 at matrix-org/dendrite#358 (comment).

Ah memories...

I'm fine with closing it now that basic support is there. @turt2live?

[matrixbot]

This comment was originally posted by @turt2live at matrix-org/dendrite#358 (comment).

yea, I think this is done enough. Is there someone who is able to accept the bounty or should I get it moved to another issue? (not sure how many people are involved, and whether it would count as conflict of interest/non-compete)

[matrixbot]

This comment was originally posted by @Half-Shot at matrix-org/dendrite#358 (comment).

I think the PRs have come over several years, some of which have since been broken and unbroken. Suggest you move the bounty, unless I am forgetting someone (please ping loudly).