Microsoft Entra Global Secure Access

Tutorial: Enable source IP restoration

In brief

Learn how to enable source IP restoration for Microsoft traffic in Global Secure Access and validate Microsoft Entra sign-in logs.

What Entra admins need to know

Review the documentation change to determine whether it affects tenant configuration, security posture, or rollout plans.

This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.

Documentation change

Open on Microsoft Learn ↗

The comparison below is an extract of the Microsoft Learn article showing only the changed content. Open the full article for complete context.

new file mode 100644

title: 'Tutorial: Enable source IP restoration' description: Learn how to enable source IP restoration for Microsoft traffic in Global Secure Access and validate Microsoft Entra sign-in logs. ms.topic: tutorial ms.date: 06/22/2026 ms.subservice: entra-internet-access ms.reviewer: jebley ai-usage: ai-assisted ms.custom: sfi-image-nochange

Tutorial: Enable source IP restoration

When users connect through a cloud-based proxy or security service edge (SSE) solution, downstream services can see the egress IP address of the cloud proxy instead of the user's original source IP. Without the original source IP, IP-based Conditional Access policies, risk detections, audit logs, and sign-in logs can be less accurate.

Source IP restoration detects and securely communicates the original egress IP address of the end user to Microsoft Entra ID and Microsoft Graph.

In this tutorial, you learn how to:

[!div class="checklist"]

  • Recognize what source IP restoration does and why it matters.
  • Enable Global Secure Access signaling for Microsoft Entra ID and Microsoft Graph.
  • Verify that Microsoft Entra sign-in logs show the user's actual source IP.

Key concepts

Source IP restoration helps your organization:

  • Continue to enforce IP-based location policies in Microsoft Entra Conditional Access.
  • Improve the accuracy of Microsoft Entra ID Protection risk detections.
  • Record accurate source IP information in Microsoft Entra sign-in logs and audit logs.

Source IP restoration is enabled by default for new tenants. If you enabled Global Secure Access features in your tenant before June 2025, you might need to explicitly enable source IP restoration.

Step 1: Enable Global Secure Access signaling for Microsoft Entra ID and Microsoft Graph

  1. Sign in to the Microsoft Entra admin center as a Global Secure Access Administrator.

  2. Browse to Global Secure Access > Settings > Session management > Adaptive Access.

  3. Select the toggle to Enable Conditional Access Signaling for Microsoft Entra ID.

    :::image type="content" source="media/tutorial-microsoft-traffic/conditional-access-signaling.png" alt-text="Screenshot that shows the Enable Conditional Access Signaling for Microsoft Entra ID toggle enabled." lightbox="media/tutorial-microsoft-traffic/conditional-access-signaling.png":::

By enabling this setting, Microsoft Entra ID and Microsoft Graph receive the public egress source IP address of the user.

Step 2: Generate a sign-in log

  1. On the device with the Global Secure Access client installed and running, open a browser.
  2. Go to any application that's integrated with your Microsoft Entra ID tenant.
  3. Complete the sign-in.

Step 3: Verify sign-in log behavior

  1. Sign in to the Microsoft Entra admin center as at least a Security Reader.

  2. Browse to Entra ID > Users.

  3. Select your test user.

  4. Select Sign-in logs.

  5. Select the sign-in event that you generated in the previous step.

  6. Verify that the sign-in log includes the user's actual public egress IP address.

    :::image type="content" source="media/tutorial-microsoft-traffic/source-ip-restoration.png" alt-text="Screenshot of sign-in activity details that show the user IP address and Through Global Secure Access set to Yes." lightbox="media/tutorial-microsoft-traffic/source-ip-restoration.png":::

Sign-in log data might take some time to appear. This delay is normal because the data undergoes processing before it appears.

What you learned

In this exercise, you accomplished the following tasks:

  • Enabled Conditional Access signaling for Microsoft Entra ID: Microsoft Entra ID and Microsoft Graph can receive the user's actual public egress IP.
  • Verified source IP restoration in sign-in logs: You confirmed that Microsoft Entra sign-in logs reflect source IP information for sessions that use the Microsoft traffic profile.

Next step

[!div class="nextstepaction"] Enable the compliant network check