OIDC SSO配置
當(dāng)前文檔以OIDC標(biāo)準(zhǔn)協(xié)議為例進行單點登錄配置說明。
如您希望了解IDaaS中支持的SSO協(xié)議,請前往:2. 標(biāo)準(zhǔn)協(xié)議。
IDaaS對OIDC不同模式的支持
您可在如下模式中多選:
模式 | 支持說明 |
客戶端模式 client_credentials | IDaaS使用OIDC客戶端模式,允許應(yīng)用的 客戶端模式無需勾選,若應(yīng)用API開放啟用,則模式開啟。 |
授權(quán)碼模式 authorization_code | IDaaS中OIDC應(yīng)用最普適的登錄模式。應(yīng)用將登錄委托給IDaaS,并解析 IDaaS返回的 |
令牌刷新模式 refresh_token | 支持使用 |
設(shè)備模式 device | 設(shè)備模式常用于非B/S架構(gòu)的應(yīng)用接入。當(dāng)設(shè)備不便于直接展示IDaaS登錄頁時,允許用戶使用瀏覽器輔助完成登錄流程。 |
常規(guī)的B/S網(wǎng)頁端企業(yè)應(yīng)用,我們建議您勾選授權(quán)碼及令牌刷新模式。
非B/S應(yīng)用,建議勾選設(shè)備及令牌刷新模式。
OIDC其他模式IDaaS暫不支持,如有需求,您可以提交需求給我們,我們會根據(jù)緊急性和重要性排期進行接入。
IDaaS側(cè)配置
? | 字段 | 說明 | 舉例 |
基本配置(必填) | 授權(quán)模式 | 為應(yīng)用選擇要使用的模式。 | 多選:授權(quán)碼模式 多選:令牌刷新模式 |
登錄 Redirect URIs | Redirect URI白名單。應(yīng)用在請求登錄時會攜帶 | http://www.xxxx/oidc/sso http://www.xxxx/oidc/sso2 | |
授權(quán)范圍 | 請參考:單點登錄通用說明。 | 選擇:全員可訪問 | |
高級配置(選填) | 用戶信息范圍 scopes | 用戶登錄后,使用用戶信息端點可以獲取到的已登錄用戶信息。
| 多選:openid 多選:email 多選:profile |
PKCE | 授權(quán)模式中勾選授權(quán)碼模式時可選。啟用后,授權(quán)碼模式會使用更安全的PKCE擴展流程。 | 默認不勾選 | |
Code Challenge 生成方式 | 開啟PKCE后可選。PKCE擴展中Code Challenge的生成方式。若未勾選開啟 PKCE,則不會顯示。 | - | |
access_token 有效期 |
| 2小時 | |
id_token 有效期 |
| 10小時 | |
refresh_token 有效期 | 用于獲取新的 | 30天 | |
擴展id_token 字段 | 可以通過擴展 說明 payload中添加的字段公開可見,請按需使用。 | - | |
id_token 簽名算法 |
| RSA-SHA256 | |
SSO發(fā)起方 | 用戶訪問由應(yīng)用發(fā)起,還是支持門戶發(fā)起 | 只允許應(yīng)用發(fā)起 | |
登錄發(fā)起地址 | 若SSO發(fā)起方設(shè)置為支持門戶和應(yīng)用發(fā)起,可填寫登錄發(fā)起地址,即IDaaS發(fā)起 SSO請求訪問的應(yīng)用地址。該地址接收到請求,應(yīng)即刻轉(zhuǎn)向IDaaS/authorize授權(quán)端口。 | - |
應(yīng)用側(cè)配置
OIDC協(xié)議允許應(yīng)用側(cè)通過一系列IDaaS開放的標(biāo)準(zhǔn)接口,完成登錄認證整套流程。?
開放的接口說明如下:
字段名 | 說明 | 示例 |
Issuer |
| https://xxxxx.aliyunidaas.com.cn/oidc1 |
發(fā)現(xiàn)端點 Discovery | 用于獲取當(dāng)前IDaaS支持的各端點信息和支持的模式、參數(shù)信息,可公開訪問。 | https://xxxxx.aliyunidaas.com.cn/oidc1/.well-known/openid-configuration |
授權(quán)端點 Authorization | 應(yīng)用發(fā)起單點登錄的地址。 | https://xxxxx.aliyunidaas.com.cn/oidc/authorize |
令牌端點 token | 應(yīng)用在單點登錄過程中,拿到授權(quán)碼 | https://xxxxx.aliyunidaas.com.cn/oidc/token |
驗簽公鑰端點 JWKS | 用于驗證 | https://xxxxx.aliyunidaas.com.cn/oidc1/jwks |
用戶信息端點 Userinfo | 登錄后,使用 | https://xxxxx.aliyunidaas.com.cn/oidc1/userinfo |
退出端點 SLO | 用戶注銷IDaaS主登錄態(tài)。 | https://xxxxx.aliyunidaas.com.cn/oidc1/logout |