Overview
This article walks through restricting HubSpot access to one or more approved IP
addresses using Conditional Access in Microsoft Entra ID. This is commonly used to ensure
that HubSpot — including CRM data, marketing workflows, and sales pipelines — can only
be accessed from a corporate network, reducing the risk of unauthorized access to
sensitive customer and business data from untrusted networks.
The approach uses two components working together:
- Named Locations: A saved list of trusted IP addresses or CIDR ranges defined in
Entra ID. - Conditional Access policy: A policy that blocks HubSpot sign-ins originating from
any IP not on the trusted list.
Please Note: HubSpot SAML SSO is only available on Enterprise tier plans across
Marketing Hub, Sales Hub, Service Hub, and Content Hub. If your
organization is on a lower tier, SSO is not supported and Conditional Access
cannot be applied. Confirm your HubSpot subscription tier before
proceeding.
Important: HubSpot has multiple login methods including email and password,
Login with Google, and Login with Microsoft in addition to SSO. If the Require SSO setting is not enabled in HubSpot, users can bypass Entra ID entirely using any of these alternative login methods, making the Conditional Access policy ineffective. Require SSO must be enabled in HubSpot before this policy can be considered the sole enforcement control.
Prerequisites
Before proceeding, confirm the following are in place:
- Microsoft Entra ID P1 or P2 license - required for Conditional Access.
- Conditional Access Administrator role or higher in Microsoft Entra ID.
- HubSpot Enterprise plan — SSO is only available on Enterprise tier.
- HubSpot enterprise app (SAML SSO) registered in your Entra ID tenant with SSO
configured and verified in HubSpot. - Require SSO enabled in HubSpot — found under Settings > Account Defaults >
Single Sign-on. Must be active before this policy provides full enforcement. - Security Defaults Disabled in Entra ID - Security Defaults and Conditional Access cannot run simultaneously.
- Known static IP address - the public IP address or CIDR range of each approved location.
- Break-glass admin account - must be excluded from this policy to prevent administrative lockout.
Important: If your approved IP address is dynamic, this approach will not work
reliably. You must use a static IP before implementing IP-based
Conditional Access.
Step 1: Create a Named Location for Your Trusted IP(s)
A Named Location defines the trusted IP addresses that Entra ID will reference as a condition in the policy.
- Sign in to the Microsoft Entra admin center at entra.microsoft.com
- Navigate to Protection > Conditional Access > Named locations.
- Select + IP ranges locations.
- Name the location. For example: Trusted - Corporate Office
- Check the Mark as trusted location checkbox.
- Click + and enter your approved IP address or CIDR range.
| Field/Setting | Value/Notes |
| Single IP address | 203.0.113.10/32 |
| IP range (CIDR) | 203.0.113.0/24 |
| Multiple sites | Create a separate Named Location for each site, then reference all of them in the policy. |
7. Click Create.
Step 2: Create the Conditional Access Policy
Create a policy that blocks HubSpot access from any location not on your trusted list.
- In the Entra admin center, navigate to Protection > Conditional Access > Policies.
- Select + New policy.
- Name the policy. For example, Block HubSpot- Outside Trusted IPs
Assignments: Users
- Under Assignments > Users, select All users.
- Under Exclude, add your break-glass admin account and any automation or service accounts that authenticate from dynamic IPs.
Assignments: Target Resources
- Under Target Resources, select Cloud apps > Select apps.
- Search for and select HubSpot.
Conditions: Locations
- Under Conditions > Locations, set Configure to Yes.
- Under Include, select Any location.
- Under Exclude, select Selected locations, then choose the Named Location you created in Step 1.
Tip: This configuration reads: apply this policy to sign-ins from any location,
except the trusted named location. Any HubSport sign-in originating outside the trusted IP will be blocked before Entra ID issues a SAML assertion to HubSpot.
Access Controls: Grant
- Under Access Controls > Grant, select Block access.
- Click Select to confirm.
Enable Policy
- Set Enable policy to Report-only.
- Click Create.
Important: Do not set this policy to On immediately. A block policy applied to All users that is misconfigured will lock all users out of HubSpot instantly.
Always validate in Report-only mode first.
Step 3: Validate the Policy
Before enabling enforcement, confirm the policy is evaluating sign-ins correctly.
1. In the Entra admin center, navigate to Identity > Monitoring & health > Sign-in logs.
2. Filter by the HubSpot application.
3. Open a sign-in from a user on your trusted IP and confirm the Conditional Access
tab shows Would succeed.
4. If available, review a sign-in from an untrusted IP and confirm it shows Would fail
with the location condition listed as the reason.
5. Investigate any unexpected Would fail entries for users on trusted IPs — this
typically indicates the office or VPN is presenting a different egress IP than what is
entered in the Named Location.
Tip: Use the What If tool under Protection > Conditional Access to simulate how a specific user signing in from a specific IP would be evaluated without waiting for a real sign-in event.
Step 4: Enable the Policy
- In the Entra admin center, navigate to Protection > Conditional Access > Policies.
- Select the policy created in Step 2.
- Change Enable policy from Report-only to On.
- Click Save.
From this point forward, any HubSpot sign-in attempt from an IP address not
included in your Named Location will be blocked. Entra ID will not issue a SAML assertion
to HubSpot, and the user will be denied access at the identity provider level.
Please Note:Users who are already signed in to HubSpot when the policy is enabled will not be immediately signed out. The block takes effect on the next sign-in or token refresh, typically within 1 hour. Confirm that Require SSO is active in HubSpot Settings > Account Defaults to prevent users from bypassing Entra
ID using alternative login methods.
Summary
The following table summarizes the full configuration process.
| Step | Action |
| Prerequisites | Confirm HubSpot Enterprise plan, SAML SSO configured, Require SSO enabled in HubSpot, Security Defaults disabled, static IP(s) identified |
| Step 1 | Create a Named Location with your trusted IP address(es) in Entra ID |
| Step 2 | Create a CA policy targeting HubSpot, excluding the Named Location, with Block access |
| Step 3 | Validate in Report-only mode using sign-in logs and the What If tool |
| Step 4 | Switch Enable policy to On |
Help Center