跳轉至

建立 2026-11-22 更新 2026-11-22

身分驗證與 Access Policy

Cloudflare Access 的權限控管由兩部分組成:身分提供者(Identity Provider, IdP)決定使用者用什麼方式證明自己是誰,例如 Email 驗證碼、Google 或 GitHub 帳號;Access Policy(存取規則)則決定通過驗證的人中,誰可以進入哪個應用程式。本頁說明常用的登入方式與 Policy 寫法。

有哪些登入方式?

設定位置:Zero Trust → Settings → Authentication → Login methods。

登入方式 說明 適合
One-time PIN 輸入 Email,收信取得一次性驗證碼 預設啟用,不用額外設定,最快上手
Google/Google Workspace 用 Google 帳號登入 公司使用 Google Workspace
GitHub 用 GitHub 帳號登入,可依組織或團隊授權 開發團隊
Microsoft Entra ID 用 Microsoft 帳號登入 公司使用 Microsoft 365
SAML/OIDC 串接 Okta 等其他身分系統 企業既有 SSO

One-time PIN 也很安全

One-time PIN 不需要密碼,驗證碼只寄到使用者信箱且有效時間很短。搭配「Emails ending in @公司網域」的 Policy,就能以零設定的方式只讓公司信箱登入。

Policy 由哪些部分組成?

每一條 Policy 包含一個動作(Action)與一組條件(Rules)。

動作

Action 效果
Allow 符合條件的人通過驗證後可以進入
Block 符合條件的人一律拒絕
Bypass 符合條件的請求完全略過 Access(不驗證、不記錄身分),例如公開的健康檢查路徑
Service Auth 給程式使用:用 Service Token 而不是人工登入

條件

條件 意義
Include 符合任一項即納入(OR)
Require 全部都要符合(AND)
Exclude 符合任一項即排除(NOT)

常用的條件選擇器:Emails、Emails ending in、Country、IP ranges、Login Methods、GitHub Organization、Google Workspace Groups、Access Groups(可重複使用的人員群組)。

常見 Policy 範例

只允許特定幾位使用者

Action: Allow
Include: Emails = alice@gmail.com, bob@gmail.com

公司信箱,且必須在台灣登入

Action: Allow
Include: Emails ending in = @example.com
Require: Country = Taiwan

公司全員,但排除外包帳號

Action: Allow
Include: Emails ending in = @example.com
Exclude: Emails = vendor@example.com

讓 CI 或其他程式存取 API

  1. 到 Access → Service Auth → Service Tokens 建立 Token,取得 Client ID 與 Client Secret。
  2. 建立 Action 為 Service Auth 的 Policy,Include 選該 Service Token。
  3. 程式呼叫時帶上兩個標頭:
curl https://api.example.com/data \
  -H "CF-Access-Client-Id: <CLIENT_ID>" \
  -H "CF-Access-Client-Secret: <CLIENT_SECRET>"

用 Access Groups 重複使用人員名單

多個應用程式都要「公司工程部」時,不要在每個 Policy 重複輸入 Email。到 Access → Access Groups 建立一個群組(例如 工程部),之後的 Policy 直接選 Include → Access Groups → 工程部。人員異動時只改群組一次。

相關資料