將請求對應至多租用戶解決方案中的租用戶

Azure

每當有請求進入你的應用程式時,你需要確定租戶的環境,也就是提出請求的租戶。 當你有租戶專屬的基礎設施,可能架設在不同地理區域時,你需要將收到的請求與租戶匹配。 接著,您必須將請求轉發給承載該租戶資源的實體基礎設施,如下圖所示:

此圖顯示將租用戶的要求對應至部署。

許多多租戶應用程式也有以使用者為基礎的權限。 租戶對應是一項獨立作業。 您必須知道提出要求的使用者,以及他們在其中工作的租用戶。

本文為技術決策者提供指引,說明您可以考慮將請求對應至適當租用戶的方法,以及這些方法所涉及的取捨。

Note

此頁面主要討論 HTTP 型應用程式,例如網站和 API。 不過,許多相同的基本原則適用於使用其他通訊協定的多租用戶應用程式。

識別租戶的方法

您可以透過多種方式來識別傳入要求的租戶。 每個方法都需要檢查傳入請求的某些層面。

網域名稱

如果您使用租用戶特定的網域或子網域名稱,要求很可能可藉由使用 Host 標頭、X-Forwarded-Host 標頭或其他包含每個要求原始主機名稱的 HTTP 標頭,輕鬆對應到租用戶。

不過,請考慮下列問題:

  • 使用者如何知道要用來存取服務的網域名稱?
  • 您是否有集中進入點,例如到達網頁或登入頁面,供所有租戶使用? 如果您這麼做,使用者會如何選取他們正在操作的租用戶?
  • 您使用哪些其他資訊來驗證租用戶資源的存取權,例如授權令牌? 授權令牌是否包含租戶特定的功能變數名稱?

HTTP 請求屬性

如果您未使用租戶特定網域名稱,您仍然可以使用 HTTP 要求的某些資訊來識別特定要求所屬的租戶。 例如,請考慮一個將租用戶名稱指定為 tailwindtraders 的 HTTP 請求。 這可能使用下列其中一種方法傳達:

  • URL 路徑結構,例如 https://app.contoso.com/tailwindtraders/。
  • URL 中的查詢字串,例如 https://contoso.com/app?tenant=tailwindtraders。
  • 自訂 HTTP 要求標頭,例如 Tenant-Id: tailwindtraders。

Important

自定義 HTTP 要求標頭不適用於從網頁瀏覽器發出 HTTP GET 要求的情況,或由某些 Web Proxy 類型處理要求的情況。 當您建置 API 時,應該只針對 GET 作業使用自訂 HTTP 標頭,或者在您控制發出要求的用戶端,且要求處理鏈中沒有包含可能會修改或移除標頭的 Web Proxy 時,才這麼做。

使用這種方法時,你應該考慮以下幾個問題:

  • 使用者會知道如何存取服務嗎? 例如,如果您使用查詢字串來識別租用戶,集中登陸頁面是否需要藉由新增查詢字串,將使用者導向正確的租用戶頁面?
  • 您是否有集中進入點,例如著陸頁面或登入頁面,供所有租戶使用? 如果您這麼做,使用者將如何選取他們需要存取的租用戶?
  • 您的應用程式是否提供 API? 例如,您的 Web 應用程式是單頁應用程式(SPA)還是具有 API 後端的行動應用程式? 如果是的話,你或許可以使用 API 閘道 或 反向代理 來執行租戶映射。

象徵性主張

許多應用程式都使用宣告型驗證和授權通訊協定,例如 OAuth 2.0 或 SAML。 這些通訊協定會將授權令牌提供給用戶端。 一個令牌包含一組主張,這些 主張是關於客戶端應用程式或使用者的資訊片段。 聲明可用來傳達資訊,例如使用者的電子郵件位址。 您的系統接著可以附上使用者的電子郵件位址、查詢使用者與租用戶之間的對應關係,然後將要求轉送至適當的部署。 或者,您甚至可以在身分識別系統中包含租用戶對應,並將租用戶識別碼宣告新增至權杖。

如果您使用宣告將請求對應至租用戶,您應該考慮下列問題:

  • 您是否會使用宣告來識別租用戶? 您將使用哪個宣告項目?
  • 使用者是否可以成為多個租用戶的成員? 如果可行,則使用者將如何選取想要針對特定要求使用的租戶?
  • 是否有適用於所有租戶的集中式驗證與授權系統? 如果沒有,您如何確定所有權杖授權單位都會發出一致的權杖和宣告?

API 金鑰

許多應用程式都會公開 API。 這些可能是供組織內部使用,或供外部合作夥伴或客戶使用。 API 的一種常見認證方法是使用 API 金鑰。 API 金鑰會隨每個要求一起提供。 如果您記錄該金鑰是發給哪個租用戶識別碼,則您可以在金鑰被使用時查詢該租用戶識別碼。

Note

API 金鑰無法提供高度安全性,因為它們需要手動建立和管理,存續時間長且經常重複使用,而且不包含宣告。 更現代化且安全的方法是使用宣告型授權機制搭配短期令牌,例如 OAuth 2.0 或 OpenID Connect。

API 金鑰可以透過數種方式產生。 以下是兩種常見的方法:

  • 產生密碼學隨機值,並將它與租戶 ID 一起儲存在查找表中。 收到要求時,您的系統會在查找表中尋找 API 金鑰,然後將其與租戶 ID 進行比對。
  • 建立有意義的字串,其中包含租用戶 ID。 使用像 HMAC 這類方式對鑰匙進行數位簽署。 當您處理每個要求時,您會確認簽章,然後擷取租用戶標識碼。

請考慮下列問題:

  • 您如何產生併發出 API 金鑰?
  • 您的 API 用戶端如何安全地接收和儲存 API 金鑰?
  • 您需要 API 金鑰在一段時間後到期嗎? 如何輪替客戶的 API 金鑰,而不會造成停機時間?
  • 客戶產生的 API 金鑰是否為您的 API 提供適當的安全性層級?

Note

API 金鑰與密碼不同。 API 金鑰必須由系統產生,而且它們在所有租戶中都必須是唯一的,因此每個 API 金鑰都可以唯一對應至單一租戶。 API 閘道,例如 Azure API 管理,可以產生和管理 API 金鑰、驗證傳入要求的金鑰,以及將金鑰對應至個別 API 訂閱者。

用戶端憑證

用戶端憑證驗證,有時稱為相互 TLS (mTLS),通常用於服務對服務通訊,以及未驗證使用者所使用的自動裝置或 kiosk。 用戶端憑證提供驗證用戶端的安全方式。 與憑證與聲明類似,客戶端憑證提供可用來判定租戶的 屬性 。 例如,憑證的 主題 可能包含使用者的電子郵件地址,可用來查詢租戶。

在計劃使用用戶端憑證進行租戶映射時,請考慮以下因素:

  • 如何安全地發行並續訂受您的服務信任的客戶端憑證? 客戶端憑證使用起來可能很複雜,因為其需要特殊的基礎結構來管理及發行憑證。 若處理不當,這些複雜性反而會 降低 安全性,而非提升安全性。
  • 客戶端憑證只會用於初始登入要求,或附加至您服務的所有要求嗎?
  • 當您有大量客戶時,發行和管理憑證的程式是否會變成無法管理?
  • 如何實作客戶端憑證與租用戶之間的對應?

反向代理

反向 Proxy 也稱為應用程式 Proxy,可用來路由 HTTP 要求。 反向 Proxy 接受來自入口端點的要求,而且可以將要求轉送至其中一個後端端點。 反向 Proxy 對於多租戶應用程式很有用,因為它們可以執行某項要求資訊與租戶之間的對應,將此任務從應用程式基礎架構中卸載出去。

許多反向 Proxy 可以使用請求的屬性來決定租戶路由。 他們可以檢查目的地功能變數名稱、URL 路徑、查詢字串、HTTP 標頭,甚至是權杖中的宣告,或請求主體部分中的宣告。

Azure 中會使用下列常見的反向 Proxy:

  • Azure Front Door 是全域負載平衡器和 Web 應用程式防火牆。 它會使用Microsoft全域邊緣網路來建立快速、安全且高度可調整的 Web 應用程式。 你可以用 規則集 擷取租戶識別碼,並放入請求的另一個部分。
  • Azure 應用程式閘道 是受控 Web 流量負載平衡器,您部署至與後端服務相同的實體區域。
  • Azure API 管理 已針對 API 流量進行優化。 Azure API 管理 提供完整的 政策引擎 ,提供極大的彈性,方便從請求中擷取租戶資訊。
  • 商業和開放原始碼技術(您自行託管)包括 nginx、Traefik 和 HAProxy。

請求驗證

您的應用程式必須驗證它所接收的任何要求都已針對該租用戶獲得授權。 例如,如果您的應用程式使用自定義域名將要求對應至租用戶,則您的應用程式仍必須檢查應用程式收到的每個要求是否獲得該租用戶的授權。 即使要求包含功能變數名稱或其他租使用者標識碼,但這並不表示您應該自動授與存取權。 使用 OAuth 2.0 時,你透過檢查 受眾 與 範圍 聲明來進行驗證。

Note

這是 Microsoft Azure Well-Architected 框架中假設入侵安全設計原則的一部分。

在實作請求驗證時,請考慮以下因素:

  • 您要如何授權對您應用程式提出的所有請求? 不論您用來將請求對應至實體基礎結構的方法為何,您都需要授權請求。
  • 使用受信任、廣泛使用且維護良好的驗證和授權架構和中間件,而不是自行實作所有驗證邏輯。 例如,請勿建置令牌簽章驗證邏輯或客戶端憑證加密連結庫。 請改用您的應用程式平台中已經過驗證與測試的功能(或已知受信任的套件)。

Performance

租戶對應邏輯可能會對您的應用程式的每個請求執行。 請考慮隨著您的解決方案成長,租用戶對應程序將如何擴展。 例如,如果您查詢資料庫資料表作為租戶對應的一部分,資料庫是否支援大量的負載? 如果您的租用戶對應需要解密令牌,計算需求是否會隨著時間而變得太高? 如果您的流量相當低,則這並不會影響您的整體效能。 不過,當您有大規模的應用程式時,此對應所涉及的額外負荷可能會變得相當顯著。

會話 Cookie

降低租戶映射邏輯效能開銷的一種方法是使用 session cookies。 與其在每個要求上執行對應,不如只計算每個工作階段之第一個要求的資訊。 您的應用程式接著會提供會話 Cookie 給用戶端。 用戶端會將工作階段 Cookie 隨著該工作階段內所有後續的用戶端要求一併傳回您的服務。

Note

Azure 中的許多網路和應用程式服務都可能會發出會話 Cookie。

請考慮下列問題:

  • 您可以使用會話 Cookie 來減少將要求對應至租戶的額外負荷嗎?
  • 您使用哪些服務將請求路由傳送至每個租用戶的實體部署? 這些服務是否支援以 Cookie 為基礎的工作階段?

租戶遷移

租戶在租 戶生命週期中經常需要遷移到新的基礎設施。 當租用戶移至新的部署時,他們存取的 HTTP 端點可能會變更。 發生這種情況時,請考慮您的租用戶對應程序需要變更。 你可能需要考慮以下因素:

  • 如果您的應用程式使用功能變數名稱進行對應要求,則在移轉時可能也需要 DNS 變更。 DNS 變更可能需要一些時間來傳播至客戶端,視 DNS 服務中的 DNS 記錄存留時間(TTL)而定。
  • 如果您的移轉在移轉過程中變更任何端點的位址,請考慮暫時將租用戶的要求重新導向至自動重新整理的維護頁面。

Contributors

本文由 Microsoft 維護。 它最初是由下列參與者所撰寫。

主要作者:

其他貢獻者:

若要查看非公開的 LinkedIn 個人檔案,請登入 LinkedIn。

後續步驟

了解多租戶應用程式中的身份。