HubSpot 正在刪除 API 密鑰——這對您意味著什麼?

已發表: 2022-11-22

快訊:HubSpot 將逐步淘汰 API 密鑰!

API 密鑰是 HubSpot API 支持的三種身份驗證方法之一。 然而,作為 HubSpot 不斷努力提高網絡安全和保護客戶數據的一部分,HubSpot 正在逐步淘汰 API 密鑰。

2022 年 11 月 30 日起,人們將無法使用 HubSpot API 密鑰作為身份驗證方法。 他們將需要使用私有應用程序訪問令牌或 OAuth 來驗證 API 調用。

與傳統 API 密鑰相比,私有應用程序提供了高度的安全性,並允許對您的集成和帳戶數據進行更精細的控制。 因此,由於此更改,您需要遷移到私有應用程序。

在這篇博文中,我們將討論所有這些變化意味著什麼、這會影響到誰,以及組織如何適應這種變化。

什麼是 HubSpot API 密鑰?

使用 HubSpot API 密鑰,您的開發人員可以使用 HubSpot 的 API 創建自定義應用程序。 每個密鑰都特定於一個 HubSpot 帳戶,而不是單個用戶,並且一次只允許使用一個密鑰。 HubSpot API 密鑰通過識別和授權項目和應用程序並將 API 訪問限制為具有 API 密鑰的人員來提高帳戶安全性。 您可以將 API 密鑰用於:

  • 創建自定義功能,如自定義對象
  • 創建自定義集成並進行 Webhook 調用
  • 通過 API 調用建立關聯或更新對象

這種變化如何影響您的業務?

如果您現有的集成使用 webhook 或自定義時間線事件,那麼您將需要轉移到公共應用程序以便將來更新這些功能。 由於只有一種或兩種方法可以驗證 HubSpot 應用程序和自定義集成,因此 API 密鑰是最常用的方法。

API 密鑰是設置可用方法的最簡單、最快捷的方式。 因此,您應該檢查它的構建方式並進行適當的調整。

API 密鑰正在逐步淘汰,以便為 HubSpot 的 CRM V3 API 讓路。 因此,HubSpot 正藉此機會於 2022 年 12 月 1 日停用電子商務橋 API 和會計擴展 API。需要遷移電子商務橋 API 以使用 HubSpot 最新的 CRM V3 API。

此更改會通過以下方式影響您的業務:

  • 您將不再對仍然使用 API 密鑰的自定義集成或應用進行身份驗證。
  • 您現有的第三方集成將無法再與 API 通信。 因此,將來您需要通過公共應用程序進行 API 調用。

此外,您需要將 API 密鑰遷移到用於自定義集成目的的公共應用程序。 然而,好消息是“本機應用程序”,即您通過 HubSpot 應用程序市場集成的應用程序或您已經通過應用程序市場集成的應用程序,不受影響。

私人和公共 HubSpot 應用程序如何為企業提供更安全的服務

如果您構建了一個使用 HubSpot API 密鑰的內部集成,您的 API 密鑰將具有讀寫和訪問所有 HubSpot CRM 數據的權限。 如果您的 API 密鑰被洩露,這可能會帶來安全風險。 通過遷移到私有應用程序,您可以授權集成所需的特定範圍。 它生成一個訪問令牌,限制您的集成可以在您的帳戶中請求或更改的數據。 此外,雖然 API 密鑰需要刷新令牌,但私有應用程序訪問令牌不需要。 此外,私人和公共應用程序對企業來說更安全,因為:

  • 它們使您能夠為每個部分設置單獨且不同的訪問令牌。
  • 它們可以更好地控制讀寫屬性,尤其是當合規性成為眾多企業的首要任務時。

此外,私人應用程序是一次性腳本或單個 API 調用的不錯選擇。 例如,如果您使用的是腳本,則可以使用私有應用創建新的自定義對像或從 CSV 文件導入 CRM 記錄。 私人應用程序也可以用於 CMS 無服務器功能或聊天機器人中的代碼片段。 在 HubSpot Private App 中使用時,密鑰可以安全地存儲為秘密,並用於通過引用該秘密來發出 API 請求。

您可以查看 Private Apps 的文檔,了解有關創建和使用 Private Apps 的更多詳細信息。

哪些集成會受到影響?

以下是一些需要更新的集成。

“圖片”/
  • 使用 API 密鑰訪問 HubSpot 的任何集成:

    在您的 HubSpot 門戶中更新的 API 密鑰將在 2022 年 11 月 30 日之前有效。

  • Zapier 集成使用帶有 API 密鑰身份驗證的 Webhooks:

    標準 Zapier 集成是使用 OAuth 構建的,不受此更新的影響。 那些使用 webhook 的將需要更新。

  • Integromat/Make 集成使用帶有 API 密鑰身份驗證的 Webhooks:

    “Make”(以前稱為 Integromat)標準集成不受此更新的影響。 那些使用 webhook 的將需要更新。

Grazitti 如何提供幫助?

為了防止您的 HubSpot 集成中斷,您需要創建一個私有應用程序,分配適當的範圍,然後部署該應用程序的令牌。 這項工作應由專業的 API 開發人員進行。

而這正是 Grazitti 可以提供幫助的地方。 我們的 HubSpot 專家擁有合適的經驗和專業知識來為您完成遷移。 作為 HubSpot 的合作夥伴,我們已經意識到這一即將發生的變化已有一段時間了。 因此,我們設計了一個流程,每次都能提供完美的結果,避免停機,並確保在將 API 密鑰遷移到私有應用程序期間不會丟失任何數據。

結論

在 HubSpot API 密鑰與私有應用程序一起失效後,您仍然可以創建/更新自定義對象及其關聯。 此外,本機集成不會受到 API 密鑰逐步淘汰的影響。 但是,如果您不遷移您的自定義集成,您的集成將在 2022 年 11 月 30 日之後不再有效,並將返回 404 錯誤。 因此,請及時遷移受影響的集成,以確保您的業務安全且平穩運行。

需要額外的人手來遷移到 HubSpot 私人應用程序嗎? 讓我們談談吧!

我們的 HubSpot 王牌將很樂意參與其中,將您的 HubSpot 運營提升到一個新的水平。 只需給我們寫信至 [email protected],我們將從那裡接手!