如何解决iOS SSO Auth返回1000错误码的认证失败问题？

我正在为企业应用实现SSO Auth功能，参考相关技术讲座后尝试了以下代码：

let url = URL(string: "realm://{{identity_server_url}")! //我试过把realm:改成https:
let ssoProvider = ASAuthorizationSingleSignOnProvider(identityProvider: url)
let request = ssoProvider.createRequest()
request.requestedOperation = .operationLogin
let authController = ASAuthorizationController(authorizationRequests: [request])
authController.delegate = self
authController.presentationContextProvider = self
authController.performRequests()

self.ssoProvider = ssoProvider
self.authController = authController

但始终报错：

Error Domain=com.apple.AuthenticationServices.AuthorizationError Code=1000 "(null)"

以下是针对性的排查和解决步骤：

• 校验身份提供商URL
  确认{{identity_server_url}}已替换为真实服务器地址，且格式完全正确：

  • 若服务器支持Apple企业SSO Realm协议，可使用realm://；如果是标准OIDC/SAML服务，必须使用https://协议。
  • 检查URL是否存在拼写错误，比如多余符号、缺失域名后缀等。

• 配置应用关联域
  企业SSO要求正确配置关联域：

  1. 在Apple开发者后台为应用启用「关联域」功能，添加对应SSO域（格式通常为webcredentials:<your-domain>或applinks:<your-domain>，以身份提供商要求为准）。
  2. 在Xcode项目的「Signing & Capabilities」中添加「Associated Domains」能力，填入后台配置的域。
  3. 确保身份服务器部署了apple-app-site-association文件，文件包含应用的Team ID和Bundle ID，且可通过https://<your-domain>/.well-known/apple-app-site-association正常访问。

• 确认身份服务器SSO配置
  联系身份服务器管理员，确认：

  • 服务器已正确配置Apple企业SSO支持，包括重定向URI、客户端ID等参数。
  • 若使用OIDC，授权端点、令牌端点等配置正确，且应用客户端ID已在服务器完成注册。

• 完善代理协议实现
  确保正确实现ASAuthorizationControllerDelegate和ASAuthorizationControllerPresentationContextProviding协议：

  extension YourViewController: ASAuthorizationControllerDelegate {
      func authorizationController(controller: ASAuthorizationController, didCompleteWithAuthorization authorization: ASAuthorization) {
          // 处理授权成功逻辑
      }
      
      func authorizationController(controller: ASAuthorizationController, didCompleteWithError error: Error) {
          // 打印完整错误信息，获取更具体提示
          print("Auth error detail: \(error.userInfo)")
      }
  }
  
  extension YourViewController: ASAuthorizationControllerPresentationContextProviding {
      func presentationAnchor(for controller: ASAuthorizationController) -> ASPresentationAnchor {
          // 返回当前窗口，iOS 15+需适配场景获取窗口
          return view.window ?? UIApplication.shared.connectedScenes
              .compactMap { $0 as? UIWindowScene }
              .first?.windows.first ?? ASPresentationAnchor()
      }
  }
  

  在错误代理方法中打印完整的error.userInfo，能得到比Code=1000更具体的错误原因。

• 排查环境与签名问题

  • 确保使用企业分发证书或有效开发证书，应用签名配置无问题。
  • 测试环境下，确认身份服务器的SSL证书为系统可信证书，避免因证书不信任导致连接失败。

内容的提问来源于stack exchange，提问作者Shohin