For the complete documentation index, see llms.txt. This page is also available as Markdown.

Named Locations

Named locations are the reusable IP ranges and country groupings that Conditional Access policies reference in their location conditions. This page lists the named locations configured in the selected tenant and lets you maintain them without leaving CIPP.

There are two kinds, and they behave differently: IP locations hold CIDR ranges and can be marked trusted, while country locations hold a list of countries or regions. Which actions are offered on a row depends on which kind it is.

Action Buttons

Add Named Location

Table Details

Column
Description

Display Name

The name of the named location, as referenced by policies.

Include Unknown Countries And Regions

For country locations, whether addresses that cannot be mapped to a country are included.

Is Trusted

For IP locations, whether the location is marked as trusted.

Range Or Location

A summary of the location's contents: the CIDR ranges for an IP location, or the country codes for a country location.

Modified Date Time

When the named location was last changed.

Range Or Location is composed by CIPP rather than returned by Graph, so it shows whichever of the two lists applies to that row. For the remaining properties, see the Graph documentation for the namedLocation resource type and its ipNamedLocation and countryNamedLocation subtypes.

Table Actions

Action
Description
Bulk Action Available

Rename named location

Changes the display name. Policies referencing the location by name follow the rename.

Mark as Trusted

Marks the location as trusted. Only shown on IP locations that are not already trusted.

Mark as Untrusted

Removes the trusted flag. Only shown on IP locations that are currently trusted.

Add location to named location

Adds a country to the location. Countries already present are not offered. Only shown on country locations.

Remove location from named location

Removes one or more countries. At least one country must remain, so this is only shown on country locations holding more than one.

Add IP to named location

Adds a CIDR range. Only shown on IP locations.

Remove IP from named location

Removes one or more CIDR ranges. At least one range must remain, so this is only shown on IP locations holding more than one.

Delete named location

Deletes the named location. This cannot be undone.

IP Address Format

Add IP to named location requires CIDR notation and validates it before submitting.

Type
Format
Prefix range

IPv4

1.1.1.1/32

/9 to /32

IPv6

2001:db8::/32

/9 to /128


Feature Requests/Ideas

We value your feedback and ideas. Please raise any feature requests on GitHub.

Last updated

Was this helpful?