openedx / edx-rest-api-client

Facilitates interaction with edX REST APIs
Apache License 2.0
20 stars 15 forks source link

Write an ADR for use of a user's JWT now that EdxApiRestClient has been removed #277

Open robrap opened 1 year ago

robrap commented 1 year ago

During the DEPR of EdxApiRestClient, some cases were replaced with plain requests object code, rather than using the updated OAuth client, using the user's JWT for service-to-service calls.

TODO: Find an example link of this change from the DEPR work.

The original intention of the new client was intentionally not to add this functionality to the new client, because it was thought that the client credentials token should be used instead of the user's JWT.

robrap commented 1 year ago

Other thoughts to consider: How might different solutions affect traceability and rate limiting.

Note: If we enhance the client with additional features around retries, backoffs, circuit breakers, etc., we'll have even more reasons for people to use our client over requests directly.

robrap commented 1 year ago

Note that once this ADR exists, there should be a follow-up ticket for getting the platform aligned with the decision.

robrap commented 9 months ago

Additional notes:

robrap commented 9 months ago

If we are unable to make a decision, we could at a minimum document the de facto decision that was made for all the legacy code in a how-to and/or ADR.

robrap commented 9 months ago

Note that in general we should be avoided doing synchronous calls to other services within a user's request. This is one reason why we may want to avoid reuse of the user's existing JWT in general. However, it may be ok to do so for the exceptional cases where a synchronous call is required. Note that there may be legacy calls which could be refactored, and these should possibly be documented as such.