> For the complete documentation index, see [llms.txt](https://docs.coreway.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coreway.com/coreway-hr/zh-hk/sso/faq.md).
# 常見問題
成員無法登入，提示配對失敗
企業身份源回傳的值沒有對上任何成員。依序檢查：
1. 該成員是否已加入團隊通訊錄。
2. SAML 的「配對值來源」設定是否正確——Okta 的 Name ID 不是電郵時，要改用「斷言中的屬性」並填對屬性名稱。
3. 回傳值與成員的電郵／手機號碼是否完全一致（注意大小寫以外的差異，例如別名信箱、手機國碼）。
4. 有差異時，到 **通訊錄 → 成員 → 企業帳號** 單獨設定配對值，見 [第四步](/coreway-hr/zh-hk/sso/member-account.md)。
組織代碼改了以後，成員登不進去
修改組織代碼後，成員之前記住的舊代碼會失效，必須輸入新代碼。建議在推廣前就定好，不要頻繁更動。
切換協定（OIDC ⇄ SAML）後登入失敗
切換協定後，企業身份源側也必須按新協定重新登記。請回到 [第二步](/coreway-hr/zh-hk/sso/register.md) 重新複製登記地址，在 Okta 建立對應協定的應用，再重新匯入設定。
登出後停在企業身份源的登入頁
開啟了「登出時同時退出企業身份源」，但沒有把本系統的**登出回跳地址**登記到對方的應用設定。
* SAML：Okta 應用的 **Single Logout URL**
* OIDC：Okta 應用的 **Sign-out redirect URIs**
統一登出開關下方出現橘色提示
提示內容為「設定裡沒有企業身份源的登出地址，請重新匯入一次設定地址」。表示目前儲存的設定中沒有對方的登出地址：
1. 確認 Okta 應用已啟用 Single Logout（SAML）。
2. 回到「企業身份源」區塊重新匯入一次中繼資料／Discovery 地址。
3. 點儲存。
Client Secret 顯示成 `**********`
這是已儲存金鑰的遮罩顯示，保持原樣送出代表不修改。需要更換時才清空重填。
匯入沒有反應或失敗
* 確認地址是 **https** 開頭，系統不支援 http。
* 確認該地址在瀏覽器中可直接開啟，且回傳的是 IdP 的中繼資料／Discovery 文件。
* 匯入後記得點 **儲存**，只匯入不儲存不會生效。
匯入後 Client ID／Client Secret 不見了？
匯入只會覆蓋端點類欄位，Client ID 與 Client Secret 不受影響，需要自行填寫。
成員在企業身份源換了帳號
到 **通訊錄 → 成員 → 企業帳號 → 設定**，點 **解除綁定**。解除後該成員下次登入會重新配對，請先確認新的電郵／手機號碼已填好。
停用企業登入會不會清掉資料
不會。停用後成員暫時不能用企業帳號登入，但 SSO 帳號與綁定關係都保留，重新開啟後可繼續使用。
可以同時啟用 OIDC 和 SAML 嗎
不行。一個團隊同一時間只能啟用一種協定。
使用 Microsoft Entra ID 或 Google Workspace 有額外注意事項嗎
有。Entra ID 要注意使用者指派、email 選用宣告、用戶端祕密到期，見 \[Entra ID 附錄]\(附錄：Microsoft Entra ID 設定範例.md)；Google Workspace 不支援匯入與統一登出，且設定有生效延遲，見 \[Google Workspace 附錄]\(附錄：Google Workspace 設定範例.md)。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.coreway.com/coreway-hr/zh-hk/sso/faq.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.