Migration Scenarios
This page provides a quick reference to help you navigate the migration workflow based on your specific scenario. Each migration follows a structured 4-phase approach when applicable: Export → Convert → CSV Review → Provision.
Understanding the Table
- ✅ Available: Documentation is ready - click the link to view the guide
- ⚠️ Coming Soon: Feature is under development
- N/A: Not applicable for this scenario
- 📝 Manual Review: Review and edit CSV files before provisioning (no automated tool needed)
New to Global Secure Access? Start with the Understanding GSA section to learn the core concepts before beginning your migration.
Migration Workflow by Scenario
| Scenario | Export | Convert | CSV Review | Provision |
|---|---|---|---|---|
🌐 Entra Internet Access (EIA) Migrations | ||||
| ZScaler Internet Access → EIA | ✅ Export ZIA | ✅ Convert ZIA2EIA | 📝 Review & Validate | ✅ Provision EIA |
| Netskope Web Gateway → EIA | ✅ Export Netskope | ✅ Convert NSWG2EIA | 📝 Review & Validate | ✅ Provision EIA |
| Forcepoint Web Security → EIA | ⚠️ Coming Soon | ✅ Convert Forcepoint2EIA | 📝 Review & Validate | ✅ Provision EIA |
| Cisco Umbrella → EIA | ✅ Export Umbrella | ✅ Convert Umbrella2EIA | 📝 Review & Validate | ✅ Provision EIA |
| Microsoft Defender for Endpoint → EIA | ✅ Export MDE | ⚠️ Coming Soon | 📝 Review & Validate | ✅ Provision EIA |
🔐 Entra Private Access (EPA) Migrations | ||||
| ZScaler Private Access → EPA | ✅ Export ZPA | ✅ Convert ZPA2EPA | 📝 Review & Validate | ✅ Provision EPA |
| Netskope Private Access → EPA | ✅ Export Netskope | ✅ Convert NPA2EPA | 📝 Review & Validate | ✅ Provision EPA |
| Citrix NetScaler → EPA | ⚠️ Coming Soon | ✅ Convert Citrix2EPA | 📝 Review & Validate | ✅ Provision EPA |
🆕 Greenfield Deployments | ||||
| Greenfield EIA Deployment | N/A | N/A | 📝 Use Templates | ✅ Provision EIA |
| Greenfield EPA Deployment | N/A | N/A | 📝 Use Templates | ✅ Provision EPA |
🔄 Global Secure Access Backup & Migration | ||||
| Export Existing EIA Configuration (Backup / Tenant-to-Tenant Migration) | ✅ Export EIA | N/A | 📝 Review & Validate | ✅ Provision EIA |
| Export Existing EPA Configuration (Backup / Tenant-to-Tenant Migration) | ✅ Export EPA | N/A | 📝 Review & Validate | ✅ Provision EPA |
Migration Workflow Overview
Not sure where to start? Follow this decision tree:
Additional Resources
- Migration Workflow: Detailed explanation of the 4-phase migration process
- Understanding GSA: Learn EIA and EPA configuration models
- Installation Guide: Set up the Migrate2GSA PowerShell module
- Support Matrix: Platform compatibility and feature support
Need Help?
If you're planning a migration project or need assistance:
- Check the platform-specific migration guides linked in the table above
- Review the troubleshooting sections in each guide
- Contact the team at migrate2gsateam@microsoft.com
This is a community project maintained by Microsoft employees but not officially supported through Microsoft support channels. Please do not contact Microsoft support for issues with this toolkit.