Skip to content

feat: add SAML-to-certificate migration guide#1018

Merged
vgrem merged 1 commit into
masterfrom
feat/saml-migration-guide
Jun 11, 2026
Merged

feat: add SAML-to-certificate migration guide#1018
vgrem merged 1 commit into
masterfrom
feat/saml-migration-guide

Conversation

@vgrem

@vgrem vgrem commented Jun 11, 2026

Copy link
Copy Markdown
Owner

Summary

Microsoft retired SAML/WS-Federation authentication for SharePoint Online in May 2026 (MC1184649). The old with_user_credentials() method no longer works.

This PR adds a migration guide and updates the README to direct users to the certificate-based replacement.

Changes

New file: examples/sharepoint/auth/modern/migrate_from_saml_to_cert.py

Step-by-step guide covering:

  • Certificate generation (including PFX-to-PEM conversion)
  • Azure AD app registration and configuration
  • SharePoint API permission setup
  • Connecting via with_client_certificate()
  • MSAL ROPC alternative for delegated access
  • Comparison of old vs new approach

README.md: Two changes

  • Added migration guide link in the Authentication blockquote
  • Replaced SAML doc URL with migration guide link in the retired SAML table row

Related issues

Closes #981, #909

- New example: examples/sharepoint/auth/modern/migrate_from_saml_to_cert.py
  Step-by-step guide covering certificate generation, Azure AD app
  registration, SharePoint permissions, and the replacement code.
- README: add migration link in Authentication section blockquote
- README: replace SAML doc link with migration guide in table

Closes #981, #909
@vgrem
vgrem merged commit d9af073 into master Jun 11, 2026
2 of 3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

SharePoint Online SAML Auth Broken - Migrate to Azure AD

1 participant