.NET MAUI Android应用Keycloak登录后重定向的静态URI获取方法

兄弟，太懂你卡了3周的绝望感！我之前集成Keycloak到MAUI Android的时候也踩过一模一样的坑，给你几个不用依赖IP和端口的静态URI方案，直接解决重定向回app的问题：

方法一：使用自定义Scheme（最常用、快速见效） #

这是移动端应用做OAuth2重定向的标准操作，完全静态，不用任何网络地址：

1. 配置AndroidManifest.xml
   打开你的MAUI项目下的Platforms/Android/AndroidManifest.xml，给主Activity添加一个intent-filter，定义专属的Scheme：

   <activity android:name=".MainActivity" ...>
       <!-- 原有内容保留 -->
       <intent-filter>
           <action android:name="android.intent.action.VIEW" />
           <category android:name="android.intent.category.DEFAULT" />
           <category android:name="android.intent.category.BROWSABLE" />
           <!-- 这里的scheme和host可以自定义，比如用你的app唯一标识 -->
           <data android:scheme="my-maui-app" android:host="keycloak-callback" />
       </intent-filter>
   </activity>
   

2. 设置Keycloak的redirectUri
   在调用keycloak.init()的时候，把redirectUri设为你刚才定义的Scheme地址：

   var keycloak = new KeycloakClient();
   await keycloak.init(new KeycloakConfig
   {
       // 其他配置...
       RedirectUri = "my-maui-app://keycloak-callback"
   });
   

3. 处理重定向回调
   在MainActivity.cs里重写OnNewIntent方法，捕获这个Scheme跳转，拿到Keycloak返回的授权码等参数：

   protected override void OnNewIntent(Intent intent)
   {
       base.OnNewIntent(intent);
       if (intent.Data != null && intent.Data.Scheme == "my-maui-app")
       {
           // 这里处理Keycloak返回的回调参数，比如提取code
           var code = intent.Data.GetQueryParameter("code");
           // 继续完成Token获取等后续逻辑
           _ = HandleKeycloakCallback(code);
       }
   }
   

方法二：使用Android App Links（适合生产环境） #

如果你的app要上应用商店，想让重定向更正规（用HTTPS地址，避免Scheme冲突），可以用App Links：

1. 配置域名与验证文件

   • 准备一个你拥有的域名（比如yourcompany.com），在域名根目录下放置/.well-known/assetlinks.json文件，内容包含你的app包名和签名指纹（可以从Android Studio的Generate Signed Bundle/APK里获取）。
   • 示例assetlinks.json：

     [{
         "relation": ["delegate_permission/common.handle_all_urls"],
         "target": {
             "namespace": "android_app",
             "package_name": "com.yourcompany.mymauiapp",
             "sha256_cert_fingerprints": ["你的APK签名SHA256指纹"]
         }
     }]
     

2. 配置AndroidManifest.xml
   给主Activity添加HTTPS的intent-filter：

   <activity android:name=".MainActivity" ...>
       <intent-filter android:autoVerify="true">
           <action android:name="android.intent.action.VIEW" />
           <category android:name="android.intent.category.DEFAULT" />
           <category android:name="android.intent.category.BROWSABLE" />
           <data android:scheme="https" android:host="yourcompany.com" android:pathPrefix="/maui-app/auth/callback" />
       </intent-filter>
   </activity>
   

3. 设置Keycloak的redirectUri
   直接用HTTPS地址：

   RedirectUri = "https://yourcompany.com/maui-app/auth/callback"
   

关键注意事项 #

• 不管用哪种方法，一定要在Keycloak后台的客户端配置里，把这个redirectUri添加到「Valid Redirect URIs」列表中，否则Keycloak会拒绝重定向。
• 自定义Scheme尽量用独特的名字（比如加上公司前缀），避免和其他app的Scheme冲突。
• 测试Scheme跳转可以用adb命令快速验证：

  adb shell am start -a android.intent.action.VIEW -d "my-maui-app://keycloak-callback"
  

备注：内容来源于stack exchange，提问作者Marek Balaz