%SYS.OAuth2.AccessToken - Retrieval

To have a Business Service (BS) that retrieves and saves an authorization token for use by a Business Operation (BO), here are the steps:

1. Create your BS to retrieve the token and store it securely, such as in a global or a data structure. For example:

   • Use ##class(%SYS.OAuth2.Authorization).GetAccessTokenClient to retrieve the token.
   • Save the retrieved token in a globally accessible location (e.g., a global or a persistent data structure).

2. In the BO, make use of the token when firing off requests. You can use the AddAccessToken method of %SYS.OAuth2.AccessToken to attach the token directly to HTTP requests made by the BO [1][2].

3. For implementation:

   • In the BS, schedule a process to fetch a new token periodically and refresh it if expired.
   • In the BO, retrieve the stored token from your chosen location and include it in outgoing HTTP requests.

Here’s a simple BO implementation snippet for using the stored token:

Method MakeRequest() As %Status {
    Set httpRequest = ##class(%Net.HttpRequest).%New()
    set token = <retrieve the stored token>
    $$$THROWONERROR(httpRequest.SetHeader("Authorization", "Bearer "_token))
    $$$THROWONERROR(httpRequest.Post(<Your API Endpoint>, .response))
    Quit $$$OK
}

Ensure that your logic for saving and retrieving the token handles expiration and regeneration correctly for continuity.

References: [1][2]

Sources: