身分驗證與 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 範例
只允許特定幾位使用者
公司信箱,且必須在台灣登入
公司全員,但排除外包帳號
讓 CI 或其他程式存取 API
- 到 Access → Service Auth → Service Tokens 建立 Token,取得 Client ID 與 Client Secret。
- 建立 Action 為 Service Auth 的 Policy,Include 選該 Service Token。
- 程式呼叫時帶上兩個標頭:
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 → 工程部。人員異動時只改群組一次。