存取權驗證

為確保只有出於正當使用案例的企業可以存取其他企業的商業資料,一些 API 端點會在以下情況執行驗證檢查:有由企業建立或認領的應用程式呼叫 API 端點時,或有未與企業連結的商業應用程式呼叫 API 端點時。如果建立、認領或連結有關應用程式的企業已獲驗證為技術供應商,這些端點便會如常處理呼叫要求。然而,如果相關企業未獲驗證為技術供應商,這些端點便會拒絕有關呼叫並傳回錯誤。

我們透過存取權驗證這一流程來確定企業是否以技術供應商的形式營運。

哪些企業需要進行存取權驗證?

任何企業只要建立或認領了應用程式,而此應用程式將為其他企業所用且需要獲取下列任何權限,此類企業則必須獲驗證為技術供應商,其他企業才能使用其應用程式。

請注意,存取權驗證與應用程式審查和權限的存取權限級別無關。

驗證檢查

如果獲企業認領的應用程式所呼叫的端點以要求取得上述任何權限,該端點便會先檢查授予有關權限的用戶是否在應用程式中具備角色。如果該用戶在應用程式中具備角色,端點便會接受有關呼叫並繼續處理要求。

然而,如果該用戶在應用程式並未具備角色,端點便會檢查認領此應用程式的企業是否已獲驗證為技術供應商。如果企業已獲驗證為技術供應商,端點便會如常處理要求;否則,端點將拒絕有關呼叫並傳回以下錯誤:

  • 錯誤代碼:100
  • 說明:Unsupported get request. Object with ID<OBJECT_ID>does not exist, cannot be loaded due to missing permissions, or does not support this operation.

請參閱推廣 API 錯誤代碼文件,進一步了解各個錯誤代碼。

請注意,雖然系統會向認領應用程式的企業執行驗證檢查,但是只有當該企業認領的應用程式所呼叫的端點設有驗證檢查時,才會觸發此流程。換言之,企業一旦獲驗證為技術供應商,其認領的所有應用程式都會通過驗證檢查。

如何完成存取權驗證

未獲驗證為技術供應商的企業在認領新的應用程式後,如果有應用程式管理員要求取得上述任何權限的進階存取權限,該企業的商業帳戶管理員將收到有關存取權驗證要求的電郵通知。

電郵中將包含驗證表格連結,您也可以透過以下路徑在應用程式管理中心存取此表格:前往基本 > 驗證 > 存取權驗證面板。

為完成驗證,企業必須根據其如何使用其他企業的資料來為這些企業提供服務,再由企業中任何具有管理員權限的用戶來選擇這種使用情況的類別並加以說明。

商業帳戶管理員完成此程序後,我們將在大約 5 天內完作出判決。

如果企業獲驗證為技術供應商,商業帳戶管理員將收到確認電郵,而應用程式管理員將透過開發人員通知收到確認訊息。已驗證的企業無須再進行驗證,但是在某些情況下,企業可能會暫時失去已驗證狀態

如果企業未通過技術供應商驗證,商業帳戶管理員將收到電郵表示未通過驗證,而應用程式管理員將透過開發人員提醒收到驗證被拒的訊息;此外,如果應用程式用戶在發出呼叫的應用程式中不具備任何角色,則所有為取得上述權限而向端點發出的呼叫均會失敗。

如果未通過驗證的企業的資料使用情況有所變動,商業帳戶管理員可以重新完成此程序,以便我們再作審查。

必要條件

商業帳戶管理員必須具備以下條件,才能開始存取權驗證程序:

現有企業

如果企業已認領的應用程式為其他企業所用且需要取得上述任何權限,系統便會自動向該企業的商業帳戶管理員傳送有關存取權驗證要求的電郵。同時,應用程式管理員將透過開發人員提醒收到此要求。

商業帳戶管理員需於系統發出電郵後的 60 天內完成驗證程序。如果未能在 60 天內完成此程序,系統將逐漸要求所有為取得上述任何權限而向端點發出的呼叫進行驗證檢查

失去已驗證狀態

已獲驗證為技術供應商的企業在以下情況會被視為未經驗證:

  • 企業的驗證狀態更改為未驗證
  • 建立或認領應用程式的企業與有關應用程式之間的連結解除
  • 商業帳戶受到限制

以上情況不再出現後,系統便會自動將企業重新視為已驗證的技術供應商。

另請參閱