Merge pull request #8 from curityio/feature/IS-9286-send-custom-header

Feature/is 9286 send custom header

Author: slunker

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Token Handler Assistant Changelog
 
+## [1.1.0-rc.3] - 2024-07-03
+
+- Send `token-handler-version` header in all requests
+
 ## [1.1.0-rc.2] - 2024-06-24
 
 - Add forgotten `RefreshResponse` to exports.

README.md

@@ -91,4 +91,12 @@ on every load of the SPA. This function makes a decision based the query string
      );
    }
    ```
-   Note: This is just a simplified example. The timeout has to be cleared properly (before every refresh, or before logout).
+   Note: This is just a simplified example. The timeout has to be cleared properly (before every refresh, or before logout).
+
+## Cookie Security
+
+- `SameSite=Strict` cookies are sent to APIs, which cannot be sent from malicious sites
+- to ensure that only precise whitelisted origins can send cookies to APIs, a `token-handler-version: 1` header is
+  sent by this library on every request to the OAuth Agent. In cross-origin deployments this ensures that a CORS pre-flight
+  request authorizes access. SPA developers may be required to send this header to token handler proxies as well (refer 
+  to the token handler proxy documentation for details). 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@curity/token-handler-js-assistant",
-  "version": "1.1.0-rc.2",
+  "version": "1.1.0-rc.3",
   "description": "Curity Token Handler JavaScript helper library",
   "main": "lib/token-handler-assistant-lib.js",
   "types": "lib/index.d.ts",

package.json

@@ -171,7 +171,8 @@ export class OAuthAgentClient {
 
   private async fetch(method: string, path: string, content?: URLSearchParams): Promise<any> {
     const headers= {
-      accept: 'application/json'
+      accept: 'application/json',
+      'token-handler-version': '1'
     } as Record<string, string>
 
     if (path == 'login/start' || path == 'login/end') {