CommonDeviceCodeRequest type

Oauth2 裝置程式碼流程的參數。

  • 範圍(scopes)-應用程式請求存取權限的範圍陣列。
  • 權限:- 權限機構的網址,即 MSAL 取得憑證的安全憑證服務(STS)。 如果 authority 是設定在用戶端應用程式物件上,這會覆蓋該值。 覆寫該數值每次都會進行權威驗證。 如果所有請求都使用相同的權限,請設定在應用程式物件上,而非請求本身。
  • correlationId - 每個請求唯一的 GUID 設定,用於遠端追蹤請求以進行遙測。
  • deviceCodeCallback - 包含裝置代碼回應的回調。 訊息應該會顯示給最終使用者。 最終使用者接著可以導航到verification_uri,輸入user_code並輸入憑證。
  • cancel - 布林值以取消裝置程式碼端點的輪詢。 當使用者在另一台裝置上進行認證時,MSAL 會輪詢安全令牌服務的憑證端點,時間間隔為裝置代碼回應中指定的間隔(通常為 15 分鐘)。 若要停止輪詢並取消請求,請設定 cancel=true。
  • resourceRequestMethod - 用於從資源請求資料的 HTTP 請求類型(例如「GET」、「POST」等)。 用於持有權證明流程。
  • resourceRequestUri - 該標記將用於的 URI。 用於持有權證明流程。
  • 逾時 - 使用者明確設定用於輪詢裝置碼端點的秒數逾時時間。 在此期間結束時;假設裝置代碼尚未過期;裝置代碼輪詢會被停止,請求也被取消。 裝置代碼過期視窗在此期間內始終優先。
  • extraQueryParameters - 新增自訂查詢參數的字串到字串映射
type CommonDeviceCodeRequest = Omit<
  BaseAuthRequest,
  "tokenQueryParameters" | "tokenBodyParameters"
> & {
  cancel?: boolean
  deviceCodeCallback: (response: DeviceCodeResponse) => void
  extraQueryParameters?: StringDict
  timeout?: number
}