員工身分聯盟可讓您授予 Microsoft Entra 群組中的使用者存取權,讓他們在 Power BI Desktop 或 Power BI Web 中存取 BigQuery 資料。使用 Microsoft Entra 做為識別資訊提供者 (IdP),將 Microsoft Entra 的群組宣告對應至 Google Cloud ,並授予群組 Identity and Access Management (IAM) 權限,以便存取 BigQuery 資料。
事前準備
- 確認您已設定 Google Cloud 組織。
-
安裝 Google Cloud CLI。 安裝完成後, 請執行下列指令,初始化 Google Cloud CLI:
gcloud init若您採用的是外部識別資訊提供者 (IdP),請先使用聯合身分登入 gcloud CLI。
- 您必須具備 Microsoft Entra 和 Microsoft Graph 的存取權。
- 您必須設定 Power BI。
費用
員工身分聯盟是免付費功能。不過,員工身分聯盟的詳細稽核記錄會使用 Cloud Logging。如要瞭解 Logging 定價,請參閱「Google Cloud Observability 定價」。
必要的角色
本節說明管理員和資源所需的角色。
管理員角色
如要取得設定員工身分聯盟所需的權限,請要求管理員授予您組織的 IAM 工作團隊集區管理員 (roles/iam.workforcePoolAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
或者,IAM 擁有者 (roles/owner) 基本角色也包含設定身分聯盟的權限。請勿在正式環境中授予基本角色,但可以在開發或測試環境中授予。
聯合身分的角色
Power BI 會在權杖交換期間傳送 userProject 參數。因此,您必須請管理員將帳單專案中聯合身分的角色,授予服務使用情形消費者 (roles/serviceusage.serviceUsageConsumer)。
如要將角色授予一組聯合身分,請執行下列指令:
gcloud projects add-iam-policy-binding PROJECT_ID \
--role="roles/serviceusage.serviceUsageConsumer" \
--member="principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/group/GROUP_ID"
更改下列內容:
PROJECT_ID:計費專案 ID。WORKFORCE_POOL_ID:員工身分集區 ID。GROUP_ID:群組 ID,例如admin-group@altostrat.com。如要查看常見主體 ID 清單,請參閱「主體 ID」。
建立員工身分集區
本節說明如何建立員工身分集區。您會在稍後的步驟中建立工作團隊身分集區提供者。
gcloud
如要建立員工身分集區,請執行下列指令:
gcloud iam workforce-pools create WORKFORCE_POOL_ID \
--organization=ORGANIZATION_ID \
--display-name="DISPLAY_NAME" \
--description="DESCRIPTION" \
--session-duration=SESSION_DURATION \
--location=global
更改下列內容:
WORKFORCE_POOL_ID:您選擇用來代表 Google Cloud 員工集區的 ID。集區 ID 在 Google Cloud的所有員工身分集區中不得重複。如要瞭解如何設定 ID 格式,請參閱 API 說明文件的「查詢參數」一節。ORGANIZATION_ID:員工身分集區所屬 Google Cloud 組織的數值組織 ID。員工身分集區適用於組織中的所有專案和資料夾。DISPLAY_NAME:選用。員工身分集區的顯示名稱。DESCRIPTION:選用。員工身分集區說明。SESSION_DURATION:選用。工作階段持續時間,以數字加上s表示,例如3600s。工作階段持續時間決定了 Google Cloud 存取權杖、控制台 (聯合) 登入工作階段,以及這個員工集區的 gcloud CLI 登入工作階段的有效時間。工作階段持續時間預設為一小時 (3600 秒)。工作階段持續時間值必須介於 15 分鐘 (900 秒) 至 12 小時 (43200 秒) 之間。
控制台
如要建立工作團隊身分集區,請按照下列步驟操作:
前往 Google Cloud 控制台的「Workforce Identity Pools」(員工身分集區) 頁面:
選取員工身分集區所屬的組織。員工身分集區適用於組織中的所有專案和資料夾。
按一下「Create pool」(建立集區),然後執行下列操作:
在「Name」(名稱) 欄位中,輸入集區的顯示名稱。系統會根據您輸入的名稱自動產生集區 ID,並顯示在「Name」(名稱) 欄位下方。如要更新集區 ID,請按一下集區 ID 旁的「Edit」(編輯)。
選用:在「Description」(說明) 中輸入集區說明。
如要建立員工身分集區,請按「Next」(下一步)。
員工身分集區的工作階段持續時間預設為一小時 (3600 秒)。工作階段持續時間決定了這個工作團隊集區的 Google Cloud 存取權杖、控制台 (聯合) 和 gcloud CLI 登入工作階段的有效時間。建立集區後,您可以更新集區,設定自訂工作階段持續時間。工作階段持續時間必須介於 15 分鐘 (900 秒) 至 12 小時 (43,200 秒) 之間。
註冊新的 Microsoft Entra 應用程式
本節說明如何使用 Microsoft Azure 入口網站建立 Microsoft Entra 應用程式。
在您註冊的 Microsoft Entra 應用程式中,建立新的用戶端密鑰。記下用戶端密鑰。
將 API 權限授予 Microsoft Entra 應用程式,以便從 Active Directory 存取使用者和群組資訊。如要授予 Microsoft Graph API 權限,請按照下列步驟操作:
- 在應用程式中選取「API Permissions」。
- 在「已設定的權限」中,按一下「新增權限」。
- 在「Request API permissions」對話方塊中,選取「Microsoft Graph」。
- 選取「應用程式權限」。
- 在「Select Permissions」(選取權限) 對話方塊中,執行下列操作:
- 在搜尋欄位中輸入
User.ReadBasic.All。 - 按一下「User.ReadBasic.All」User.ReadBasic.All。
- 按一下「Add permissions」。
- 在搜尋欄位中輸入
- 在「Request API permissions」對話方塊中,選取「Microsoft Graph」。
- 選取「應用程式權限」。
- 在「Select Permissions」(選取權限) 對話方塊中,執行下列操作:
- 在搜尋欄位中輸入
GroupMember.Read.All。 - 按一下「GroupMember.Read.All」GroupMember.Read.All。
- 按一下「Add permissions」。
- 在搜尋欄位中輸入
- 在「Configured permissions」中,按一下「Grant admin consent for <網域名稱>」。
- 系統要求確認時,請點選「是」。
如要取得設定工作團隊集區提供者所需的值,請按照下列步驟操作:
- 前往 Microsoft Entra 應用程式的「Overview」頁面。
- 按一下 [端點]。
請記下下列值:
- 用戶端 ID:您在本指南稍早註冊的 Microsoft Entra 應用程式 ID。
- 用戶端密鑰:您先前在本指南中產生的用戶端密鑰。
- 租戶 ID:您先前在本指南中註冊的 Microsoft Entra 應用程式租戶 ID。
- 核發者 URI:OpenID Connect 中繼資料文件的 URI,不含
/.well-known/openid-configuration。舉例來說,如果 OpenID Connect 中繼資料文件網址為https://login.microsoftonline.com/d41ad248-019e-49e5-b3de-4bdfe1fapple/v2.0/.well-known/openid-configuration,則核發者 URI 為https://login.microsoftonline.com/d41ad248-019e-49e5-b3de-4bdfe1fapple/v2.0/。
建立工作團隊身分集區提供者
執行下列指令來建立提供者:
gcloud iam workforce-pools providers create-oidc WORKFORCE_PROVIDER_ID \
--workforce-pool=WORKFORCE_POOL_ID \
--location=global \
--display-name=DISPLAY_NAME \
--issuer-uri=ISSUER_URI \
--client-id=https://analysis.windows.net/powerbi/connector/GoogleBigQuery \
--attribute-mapping=ATTRIBUTE_MAPPING \
--web-sso-response-type=id-token \
--web-sso-assertion-claims-behavior=only-id-token-claims \
--extra-attributes-issuer-uri=APP_ISSUER_URI \
--extra-attributes-client-id=APP_CLIENT_ID \
--extra-attributes-client-secret-value=APP_CLIENT_SECRET \
--extra-attributes-type=EXTRA_GROUPS_TYPE \
--extra-attributes-filter=EXTRA_FILTER \
--detailed-audit-logging
更改下列內容:
WORKFORCE_PROVIDER_ID:專屬供應商 ID。前置字元gcp-是保留字,不得用於供應商 ID。WORKFORCE_POOL_ID:要連結 IdP 的員工身分集區 ID。DISPLAY_NAME:供應器的選用顯示名稱,容易使用。ISSUER_URI:發行者 URI 的值,格式為https://sts.windows.net/TENANT_ID。將TENANT_ID替換為您先前記下的租用戶 ID。ATTRIBUTE_MAPPING:群組的對應關係,以及 Microsoft Entra 宣告中其他屬性 (選用) 與Google Cloud 屬性的對應關係,例如:google.groups=assertion.groups, google.subject=assertion.sub。本指南稍後會授予該群組 BigQuery 資料的存取權。詳情請參閱「屬性對應」。
APP_ISSUER_URI:您先前記下的 Microsoft Entra 應用程式核發者 URI。APP_CLIENT_ID:您先前記下的核發者用戶端 ID。APP_CLIENT_SECRET:您先前記下的核發者用戶端密鑰。EXTRA_GROUPS_TYPE:群組 ID 的類型,可以是下列其中一種:azure-ad-groups-mail:從 IdP 擷取的群組電子郵件地址,例如admin-group@altostrat.com。azure-ad-groups-id:代表群組的 UUID 會從 IdP 擷取,例如:abcdefgh-0123-0123-abcdef。azure-ad-groups-display-name:群組顯示名稱是從 IdP 擷取,例如:admin-group-display-name。
EXTRA_FILTER:篩選器,用於要求從 IdP 傳遞特定斷言。指定--extra-attributes-type=azure-ad-groups-mail後,--extra-attributes-filter會篩選從 IdP 傳遞的使用者群組憑證。根據預設,系統會擷取與使用者相關聯的所有群組。使用的群組必須啟用郵件和安全性功能。詳情請參閱「使用 $search 查詢參數」。以下範例會篩選與使用者電子郵件地址相關聯的群組,且這些地址開頭為
gcp: 以下範例會篩選出與使用者相關聯的群組,這些使用者的電子郵件地址開頭為--extra-attributes-filter='"mail:gcp"'gcp,且 displayName 包含example:--extra-attributes-filter='"mail:gcp" AND "displayName:example"'員工身分聯盟詳細稽核記錄會將從 IdP 收到的資訊記錄到 Logging。詳細的稽核記錄可協助您排解員工身分集區提供者設定問題。如要瞭解如何透過詳細的稽核記錄排解屬性對應錯誤,請參閱「一般屬性對應錯誤」。如要瞭解 Logging 定價,請參閱「Google Cloud Observability 定價」。
如要停用工作團隊身分集區提供者的詳細稽核記錄,請在執行
gcloud iam workforce-pools providers create時省略--detailed-audit-logging旗標。如要停用詳細稽核記錄,您也可以更新供應商。
建立允許政策
在本節中,您將建立允許政策,將 BigQuery 資料檢視者角色 (roles/bigquery.dataViewer) 授予專案中對應的群組,該專案儲存了您的 BigQuery 資料。這項政策可讓群組中的所有身分,查看專案中儲存的 BigQuery 資料表和檢視表資料。
執行下列指令來建立政策:
gcloud projects add-iam-policy-binding BIGQUERY_PROJECT_ID \
--role="roles/bigquery.dataViewer" \
--member="principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/group/GROUP_ID"
更改下列內容:
BIGQUERY_PROJECT_ID:儲存 BigQuery 資料和中繼資料的專案 ID。WORKFORCE_POOL_ID:員工身分集區 IDGROUP_ID:群組 ID,取決於用來建立員工身分集區提供者的--extra-attributes-type值,如下所示:azure-ad-groups-mail:群組 ID 是電子郵件地址,例如admin-group@altostrat.com。azure-ad-groups-id:群組 ID 是群組的 UUID,例如:abcdefgh-0123-0123-abcdef。azure-ad-groups-display-name:群組 ID 是顯示名稱,例如admin-group-display-name。
透過 Power BI Desktop 存取 BigQuery 資料
如要透過 Power BI Desktop 存取 BigQuery 資料,請按照下列步驟操作:
- 開啟 Power BI。
- 按一下「Get Data」。
- 按一下「資料庫」。
- 在資料庫清單中,選取「Google BigQuery (Microsoft Entra ID) (Beta)」。
- 點選「連線」。
填寫下列必填欄位:
- 帳單專案 ID:帳單專案 ID。
目標對象 URI: Google Cloud URI,格式如下:
//iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID更改下列內容:
WORKFORCE_POOL_ID:員工身分集區 ID。WORKFORCE_PROVIDER_ID:員工身分集區提供者 ID。
按一下 [確定]。
點選「下一步」。
按一下「選取資料」。
如果系統要求您登入,請使用屬於該群組成員的 Microsoft Entra 身分。
現在,您可以在 Power BI Desktop 中使用 BigQuery 資料。
透過 Power BI Web 存取 BigQuery 資料
如要透過 Power BI Web 存取 BigQuery 資料,請按照下列步驟操作:
前往 Power BI Web。
按一下「Power Query」,新增資料來源。
按一下「取得資料」。
在清單中,找到並選取「Google BigQuery (Microsoft Entra ID) (Beta)」。
填寫下列必填欄位:
帳單專案 ID: Google Cloud 帳單專案
目標對象 URI:目標對象 URI,格式如下:
//iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID更改下列內容:
WORKFORCE_POOL_ID:工作團隊身分集區 IDWORKFORCE_PROVIDER_ID:員工身分集區提供者 ID
依序點選「Connection Credentials」>「Authentication kind」。
選取「組織帳戶」。
點按「Sign in」,
點選「下一步」。
按一下「選取資料」。
現在,您可以在 Power BI Web 中使用 BigQuery 資料。
後續步驟
- 如要刪除員工身分聯盟使用者及其資料,請參閱「刪除員工身分聯盟使用者及其資料」
- 如要撤銷員工身分聯盟使用者工作階段,請參閱「撤銷員工身分聯盟使用者工作階段」
- 如要瞭解 Google Cloud 產品對員工身分聯盟的支援情形,請參閱「身分聯盟:支援的產品和限制」。