Forum Discussion

OsneyRojas_14's avatar
OsneyRojas_14
Copper Contributor
Sep 10, 2024

Migrate MS Sentinel from one tenant to another tenant

I need to migrate Microsoft Sentinel with all its resources (playbooks, workbook, connectors, analytics rules), I would need a step by step, since I see that among the documentation that Microsoft has, it does not have it. I would like to know if there is any tool or functionality that allows me to do this, without having to rebuild everything
 

 

1 Reply

  • There is no “one-click” migration option to move Microsoft Sentinel (including workspace, data, rules, playbooks, connectors, and workbooks) from one tenant to another.

    Microsoft Sentinel is tightly coupled to the Log Analytics Workspace, and moving a workspace between tenants is not supported. In a tenant-to-tenant scenario, the supported approach is to deploy a new Sentinel instance in the target tenant and migrate the content using Infrastructure as Code (ARM/Bicep) and export/import methods.

    Here is what you can and cannot migrate.

    What you can migrate

    Analytics Rules
    You can export and import Analytics rules using ARM templates (JSON). This is supported and is the most efficient way to move detection content.

    Automation Rules
    Automation rules can also be exported and redeployed via ARM templates.

    Workbooks
    Workbooks are Azure Monitor resources and can be exported as JSON and redeployed in the new tenant. You will typically need to adjust workspace IDs and resource references.

    Playbooks
    Playbooks are Azure Logic Apps. You can export them as ARM templates and redeploy in the new tenant. However, API connections, permissions, and managed identities must be recreated or adjusted in the destination tenant.

    Data Connectors
    Data connectors generally need to be reconfigured in the target tenant. Credentials, permissions, and service integrations are tenant-specific and cannot simply be exported and imported.

    Solutions from Content Hub
    Solutions can be reinstalled in the new tenant, but configuration and permissions must still be set up again.

    What cannot be directly migrated

    Historical Log Analytics data
    There is no supported method to directly move Log Analytics data between tenants. If historical data must be preserved, common approaches are:

    • Keep the source tenant active for retention and audit purposes
    • Export historical data to storage or Azure Data Explorer before decommissioning

    Recommended step-by-step approach

    Phase 1 – Prepare the destination tenant

    1. Create a new Log Analytics Workspace in the target tenant.
    2. Enable Microsoft Sentinel on that workspace.
    3. Configure RBAC and identities.

    Phase 2 – Migrate content as code
    4. Export Analytics rules as ARM templates.
    5. Export Automation rules.
    6. Export Workbooks (JSON/ARM).
    7. Export Playbooks (ARM templates).
    8. Update all resource IDs, workspace references, and parameters.
    9. Deploy to the new tenant using ARM, Bicep, or CI/CD pipeline.

    Phase 3 – Reconfigure connectors
    10. Reinstall necessary Content Hub solutions.
    11. Reconfigure data connectors and permissions.
    12. Validate ingestion, alert generation, and automation workflows.

    Phase 4 – Parallel validation
    13. Run both tenants in parallel during transition.
    14. Validate incident generation and response processes.
    15. Decommission the source tenant once validated.

    Key takeaway

    There is no native migration tool that moves everything automatically between tenants. The supported and scalable approach is to treat Sentinel content as code and redeploy it in the new tenant using ARM/Bicep and CI/CD practices.

     

Resources