新聞

微軟宣布2027年4月1日起，SharePoint Online與OneDrive將開始淘汰部分Microsoft Graph檔案API使用的預先驗證網址（Pre-authenticated URL）。相關API將不再回傳含有預先驗證權杖的網址，應用程式要是仍須存取回傳網址，就必須在請求時附上適用的Microsoft Entra ID存取權杖，否則既有的檔案下載、上傳及預覽功能可能無法正常運作。

預先驗證網址是SharePoint將短期有效，且僅能存取特定檔案的權杖放入網址，通常以tempauth參數顯示，應用程式取得網址後，不必再提供身分驗證資訊，就能存取對應檔案。微軟指出，網址可能被記錄在系統日誌、快取或轉寄訊息中，因此決定移除網址內的授權資訊，改由HTTP請求的Authorization標頭傳送存取權杖，降低權杖意外外流的風險。

此次調整涵蓋六類Microsoft Graph檔案API，包括檔案下載、建立檔案上傳工作階段、複製作業與進度監控、檔案預覽、縮圖取得及格式轉換。企業若透過這些API串接SharePoint或OneDrive，並將回傳網址當成可直接使用的存取憑證，就需要修改程式。

受影響API有兩種調整方式，部分請求過去會先回傳HTTP 302重新導向，讓程式透過含有權杖的暫時網址取得檔案，之後則改為直接回傳內容。其他API仍會在回應中提供SharePoint網址，但存取時須另外取得適用於SharePoint Online的Entra ID權杖，不能直接續用Microsoft Graph權杖。原本依賴重新導向網址，或取得網址後未附加驗證資訊就發送請求的程式，都可能受到影響。

微軟建議開發者盤點相關API的使用情形，檢查程式是否讀取、儲存或轉送暫時網址，並調整身分驗證及HTTP重新導向的處理方式。管理員應先在測試租戶確認應用程式相容性，再修改正式環境設定。若組織未使用受影響的API，或已透過Microsoft Graph標準驗證方式直接存取檔案內容，則不需要因此次調整修改程式。