Create Policies

STARTERTEAMENTERPRISE

Policies are what grant users access to Resources.

To define a Policy, go to Policies New Policy.

Policies define a single Group's access to a single Resource.

On Team and higher plans, you may restrict access further based on the below conditions.

Each condition is added the same way: pick a Resource (the Conditions section stays disabled until then), click Add condition, and choose a condition from the menu. The condition appears as a card under Conditions.

Client Location

Restricts access to Clients connecting from specific countries. The Client's IP address is used to look up the country of origin. Supports is in (allow the listed countries) and is not in (block them); accepts one or more countries.

IP Range

Restricts access to a specific IP address or range of Client IP addresses. Supports is in CIDR and is not in CIDR; accepts one or more IPv4/IPv6 addresses or CIDR ranges.

Authentication Provider

Restricts access based on the authentication provider that was used to authenticate the Client. Useful when you want to apply a stricter set of authentication requirements for certain Groups or Resources using a separate SSO app in your identity provider. Supports is in and is not in over the list of configured providers.

Require Verified Client

Restricts access to verified Clients only. When this condition is present, any Client used by Actors in the group cannot access the Resource unless it has been explicitly marked as verified in the admin portal.

Adding the condition is itself the enablement — there is no extra toggle inside the card. Remove the condition to lift the requirement.

The Client is identified for verification by their unique device IDs, which are retrieved from the following sources depending on the platform:

PlatformSourceNotes
macOSHardware IDMatches the hardware ID found in the system report
macOSHardware serialMatches the hardware serial found in the system report
iOSApp installation IDA unique UUIDv4 generated by the system upon app installation. Note: This ID will be reset if the app is uninstalled and reinstalled.
AndroidApp installation IDA unique UUIDv4 generated by the system upon app installation. Note: This ID will be reset if the app is uninstalled and reinstalled.
Windows, LinuxDevice IDThe BIOS UUID retried from SMBIOS
Windows, LinuxMotherboard serialThe mainboard serial retried from SMBIOS

This feature acts as a lightweight device management solution, ideal for organizations looking to enforce device policies (e.g., preventing mobile device access to production databases) without requiring a full-fledged MDM system to be in place.

Client verification is a lightweight mechanism designed to prevent outside attackers from impersonating an Actor's device using only a stolen credential. It is not a substitute for strong device identity authentication: the device IDs above are read from sources that an attacker with local access to an already-verified device can copy to another machine. Stronger device identity guarantees are planned in firezone/firezone#8369.

Time of Day

Restricts access to certain time windows throughout the week based on the 24hr time and specified time zone. Each day of the week takes one or more HH:MM-HH:MM windows during which access is allowed.

The time zone determines the offset used when determining whether to allow access for a particular Client. For example, if you specify a time window of 08:00-17:00 and time zone of Eastern, Clients in the Pacific timezone 3 hours behind will be allowed access from 05:00-14:00 Eastern time.

How conflicting policies are resolved

The policy engine resolves access on a boolean OR basis. That means when two or more policies with conflicting conditions apply to a given Actor-Resource pair, access will be allowed to the Resource if any of the policies evaluate true.

As an example, consider the following policies:

PolicyGroupResourceCondition
AEngineeringProduction DBTime of Day: 08:00-17:00
BDevOpsProduction DBNone

If an Actor is a member of both the Engineering and DevOps groups, they will be able to access the Production DB at any time of day since Policy B will always evaluate to true.


Need help? See all support options.

Found a problem with this page? Open an issue
Last updated: June 11, 2026