# Error Handling Reference

| Error | Cause | Solution |
|-------|-------|----------|
| SAML assertion failed | Certificate mismatch | Update certificates, verify metadata |
| User not provisioned | Missing attribute | Check attribute mapping configuration |
| MFA not triggering | Policy misconfiguration | Review MFA policy settings |
| Session timeout issues | Policy conflict | Align IdP and Windsurf session settings |
| Group sync failed | Permission issue | Verify IdP permissions for group access |

---
*[Tons of Skills](https://tonsofskills.com) by [Intent Solutions](https://intentsolutions.io) | [jeremylongshore.com](https://jeremylongshore.com)*
