APP接入說明

中央授權中心 - 移動端URL Scheme接入指南

📱 重要配置提醒

1. 開發者需要在自己的APP中註冊自定義 URI Scheme ；
2. 需向中央授權中心申請啟用自定義 Scheme 重定向權限（點擊申請），并在OIDC Client配置中將帶 Scheme URI 添加到允許的重定向 URI。

基本使用

（APP交互）授權地址：

civetauth://sso/oidc

授權地址格式：

civetauth://sso/oidc?client_id=CLIENT_ID&redirect_uri=REDIRECT_URI&scope=openid profile foxccon&response_type=code

其中 redirect_uri 為以您的APP Scheme 開頭的 URI ， 如： yourbu://civetlogin/ 。
其它參數與標準的授權端點參數一致。

接入流程
1 申請權限

向中央授權中心申請啟用自定義 Scheme，并配置允許的重定向 URI 。

2 配置APP

在您的APP中註冊URL Scheme 。
iOS 一般在 Info.plist 文件中注冊；Android 為 AndroidManifest.xml 文件。最終保證手機瀏覽器能直接通過 Scheme 調起 APP 。

3 構建請求

使用標準OIDC參數構建授權請求。

4 處理回調

在APP中接收授權碼並交換令牌。

測試示例
掃碼手機端開啟此頁
叫起相信驗證后返回微信 叫起相信驗證后返回Line 叫起相信驗證后返回京東 叫起相信驗證后返回12306
📝 注意事項

OIDC Client 默認只允許 http/https 重定向，需特別申請才能使用自定義 Scheme
redirect_uri 必須與申請時提交的 Scheme 完全一致
請確保設備已安裝相信 APP